برنامج تعليمي: قياس الإحالات الناجحة في "إعلانات iOS"

الخطوة 3: بدء قياس الإحالات الناجحة على الجهاز فقط باستخدام Google Analytics

المقدمة: قياس الإحالات الناجحة في "إعلانات iOS"

الخطوة 3: بدء قياس الإحالات الناجحة على الجهاز فقط باستخدام Google Analytics

الخطوة 4: تحديد المشاكل الشائعة وحلّها والتعامل معها

الآن بعد أن أصبح بإمكانك جمع بيانات المستخدمين وعناوين البريد الإلكتروني وأرقام الهواتف وأن يحصل تطبيقك على حزمة تطوير البرامج (SDK) الخاصة بإصدار "Google Analytics لبرنامج Firebase"، يمكنك استخدام الاثنين لبدء لقياس الإحالات الناجحة.

استدعاء واجهة برمجة التطبيقات

يمكنك طلب البيانات من واجهة برمجة التطبيقات لقياس الإحالات الناجحة باستخدام رقم هاتف أو عنوان بريد إلكتروني يتم منح الموافقة عليهما. رقم من الخطوة 1 المستخدَمة لقياس الإحالات الناجحة من خلال الإعلانات، بدون السماح لأي معلومات تحديد الهوية الشخصية بمغادرة جهاز المستخدم.

تتوفّر طريقتان لبدء القياس:

استخدام بيانات الاعتماد
استخدام بيانات الاعتماد المجزّأة

استخدام عنوان بريد إلكتروني أو رقم هاتف

Swift Objective-C Unity

استيراد وحدة FirebaseAnalytics وتمريرها في عنوان البريد الإلكتروني أو الهاتف رقم إلى واجهة برمجة تطبيقات 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")

عليك استيراد وحدة FirebaseAnalytics وتمريرها في عنوان البريد الإلكتروني إلى initiateOnDeviceConversionMeasurementWithEmailAddress: API أو الهاتف إلى واجهة برمجة تطبيقات initiateOnDeviceConversionMeasurementWithPhoneNumber:.

@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 وتمرير عنوان البريد الإلكتروني إلى 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");

استخدام عنوان بريد إلكتروني أو رقم هاتف مجزّأ

ستقبل واجهة برمجة التطبيقات عناوين البريد الإلكتروني وأرقام الهواتف المجزأة باستخدام SHA256. إِنْتَ يمكنك التحكّم في بيانات المستخدم من خلال تنفيذ التجزئة في رمزك البرمجي قبل إجراء اتصالات بحزمة SDK.

لاستخدام بيانات الاعتماد المجزّأة، يجب تسوية العناوين والأرقام وتجزئتها SHA256، ثم استدعِ واجهة برمجة التطبيقات.

تسوية عناوين البريد الإلكتروني وأرقام الهواتف

بالنسبة إلى عناوين البريد الإلكتروني، تفترض واجهة برمجة تطبيقات Google Analytics أنّ يتم إجراء تسوية محددة قبل تطبيق خوارزمية SHA256، لذا اتبع هذه الخطوات لتسوية بياناتك وهي:

تحويل عنوان البريد الإلكتروني بالكامل إلى أحرف صغيرة
إذا كان عنوان البريد الإلكتروني ينتهي بالنطاق @googlemail.com، استبدِل @googlemail.com مع @gmail.com.
بالنسبة إلى العناوين التي تنتهي بـ @gmail.com (بما في ذلك العناوين التي تم تعديلها في الخطوة السابقة):
1. أزِل كل النقاط من جزء اسم المستخدم.
2. أجرِ الاستبدالات التالية في جزء اسم المستخدم:
  - يمكنك استبدال الحرف l بالحرف I أو i أو الرقم 1.
  - بالنسبة إلى الرقم 0، استبدِل الحرف o.
  - يُرجى استبدال الحرف z للرقم 2.
  - بالنسبة إلى الرقم 5، استخدِم الحرف s بدلاً من ذلك.

على سبيل المثال، بعد التسوية:

تغيّر اسم "an.email.user0125@googlemail.com" ليصبح "anemalluserolzs@gmail.com"
تغيّر اسم "CAPSUSER0125@provider.net" ليصبح "capsuser0125@provider.net"

بالنسبة إلى أرقام الهواتف، يجب أن تكون الأرقام بتنسيق E.164 (أي بادئة مع +، من رقم إلى 1 إلى 3 أرقام لرمز البلد، و12 رقمًا كحد أقصى لرقم المشترك) قبل التجزئة باستخدام SHA256.

طلب بيانات الاعتماد المجزّأة لواجهة برمجة التطبيقات

Swift Objective-C Unity

import FirebaseAnalytics

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

قم باستيراد وحدة FirebaseAnalytics وتمريرها في عنوان البريد الإلكتروني إلى initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API أو الهاتف الرقم في initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: واجهة برمجة التطبيقات.

@import FirebaseAnalytics;

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

استيراد مساحة الاسم Firebase.Analytics وتمرير عنوان البريد الإلكتروني إلى InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API أو رقم الهاتف إلى واجهة برمجة تطبيقات InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

using Firebase.Analytics;

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

إثبات الملكية باستخدام سجلات تصحيح أخطاء Xcode (اختياري)

في حال تفعيل وضع تصحيح الأخطاء، تأكَّد بعد طلب واجهة برمجة تطبيقات بدء القياس أن تظهر رسالة مثل رسالة السجل التالية في تصحيح أخطاء Xcode وحدة التحكم:

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

في الإصدار 9.6.0 من Firebase أو الإصدارات الأحدث، في حال تفعيل وضع تصحيح الأخطاء وتضمين -DebugOnDeviceConversionMeasurement وسيطة الإطلاق، ثم استدعاء ستحاكي واجهة برمجة التطبيقات initiateOnDeviceConversionMeasurement() المطابقة.

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

الخطوة 2: دمج "Google Analytics" الخطوة 4: تحديد المشاكل الشائعة وحلّها والتعامل معها