آموزش: اندازه گیری تبدیل تبلیغات iOS

مرحله 3: اندازه گیری تبدیل روی دستگاه را با استفاده از Google Analytics شروع کنید


مقدمه: تبدیل تبلیغات iOS را اندازه گیری کنید

مرحله 1: یک تجربه ورود به سیستم را اجرا کنید

مرحله 2: Google Analytics یکپارچه کنید

مرحله 3: اندازه گیری تبدیل روی دستگاه را با استفاده از Google Analytics شروع کنید

مرحله 4: مشکلات رایج را عیب یابی و رسیدگی کنید


اکنون که می توانید آدرس ایمیل و شماره تلفن کاربران را جمع آوری کنید و برنامه شما دارای Google Analytics برای Firebase SDK است، می توانید از این دو برای شروع اندازه گیری تبدیل ها استفاده کنید.

با API تماس بگیرید

API اندازه‌گیری تبدیل را با آدرس ایمیل یا شماره تلفن مورد رضایت از مرحله 1، که برای اندازه‌گیری تبدیل تبلیغات استفاده می‌شود، تماس بگیرید، بدون اینکه اجازه دهید هیچ اطلاعات شناسایی شخصی از دستگاه کاربر خارج شود.

دو راه برای شروع اندازه گیری وجود دارد:

از آدرس ایمیل یا شماره تلفن استفاده کنید

سویفت

ماژول FirebaseAnalytics را وارد کنید و آدرس ایمیل یا شماره تلفن را به API initiateOnDeviceConversionMeasurement() ارسال کنید.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

هدف-C

ماژول FirebaseAnalytics را وارد کنید و آدرس ایمیل را به initiateOnDeviceConversionMeasurementWithEmailAddress: API یا شماره تلفن را به initiateOnDeviceConversionMeasurementWithPhoneNumber: API ارسال کنید.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

وحدت

فضای نام Firebase.Analytics را وارد کنید و آدرس ایمیل را به API InitiateOnDeviceConversionMeasurementWithEmailAddress() یا شماره تلفن را به API InitiateOnDeviceConversionMeasurementWithPhoneNumber() ارسال کنید:

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

از آدرس ایمیل یا شماره تلفن هش شده استفاده کنید

API آدرس های ایمیل و شماره تلفن های هش شده با SHA256 را می پذیرد. قبل از برقراری تماس با SDK، می‌توانید کنترل داده‌های کاربر خود را با انجام هش کردن کد خود حفظ کنید.

برای استفاده از اعتبار هش شده، آدرس ها و اعداد را عادی کنید، آنها را با SHA256 هش کنید، سپس با API تماس بگیرید.

آدرس ایمیل و شماره تلفن را عادی کنید

برای آدرس‌های ایمیل ، Google Analytics API فرض می‌کند که یک نرمال‌سازی خاص قبل از اعمال SHA256 انجام می‌شود، بنابراین این مراحل را برای عادی‌سازی داده‌های خود دنبال کنید:

  1. کل آدرس ایمیل را به حروف کوچک تبدیل کنید.

  2. اگر آدرس ایمیل به دامنه @googlemail.com ختم می‌شود، دامنه @googlemail.com را با @gmail.com جایگزین کنید.

  3. برای آدرس‌هایی که به دامنه @gmail.com ختم می‌شوند (از جمله آن‌هایی که در مرحله قبل اصلاح شده‌اند):

    1. تمام نقطه ها را از قسمت نام کاربری حذف کنید.

    2. جایگزین های زیر را در قسمت نام کاربری انجام دهید:

      • برای حروف I یا i یا رقم 1، حرف l را جایگزین کنید
      • برای رقم 0، حرف o را جایگزین کنید
      • برای رقم 2، حرف z را جایگزین کنید
      • برای رقم 5، حرف s را جایگزین کنید

به عنوان مثال، پس از عادی سازی:

  • an.email.user0125@googlemail.com تبدیل به anemalluserolzs@gmail.com می شود
  • CAPSUSER0125@provider.net تبدیل به capsuser0125@provider.net می شود

برای شماره‌های تلفن ، اعداد باید قبلاً در قالب E.164 باشند (یعنی پیشوند با +، 1-3 رقم برای کد کشور، حداکثر 12 رقم برای شماره مشترک) قبل از هش کردن با SHA256.

با اطلاعات کاربری هش شده با API تماس بگیرید

سویفت

ماژول FirebaseAnalytics را وارد کنید و آدرس ایمیل یا شماره تلفن را به API initiateOnDeviceConversionMeasurement() ارسال کنید.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

هدف-C

ماژول FirebaseAnalytics را وارد کنید و آدرس ایمیل را به initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API یا شماره تلفن را به initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API ارسال کنید.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

وحدت

فضای نام Firebase.Analytics را وارد کنید و آدرس ایمیل را به API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() یا شماره تلفن را به InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API ارسال کنید:

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

تأیید با گزارش‌های اشکال‌زدایی Xcode (اختیاری)

اگر حالت اشکال زدایی را فعال کرده اید، پس از فراخوانی API اندازه گیری شروع، مطمئن شوید که پیامی مانند پیام گزارش زیر در کنسول اشکال زدایی Xcode ظاهر می شود:

9.0.0 - [FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

در Firebase 9.6.0 یا جدیدتر، اگر حالت اشکال زدایی را فعال کرده باشید و آرگومان راه اندازی -DebugOnDeviceConversionMeasurement را وارد کرده باشید، آنگاه فراخوانی API initiateOnDeviceConversionMeasurement() یک تطابق را شبیه سازی می کند.

9.6.0 - [FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match




مرحله 2 : ادغام Google Analytics مرحله 4 : عیب یابی و رسیدگی به مشکلات رایج