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

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

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

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

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

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

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

هناك طريقتان لبدء القياس:

استخدام بيانات الاعتماد
استخدام بيانات الاعتماد المشفَّرة

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

Swift

يمكنك استيراد وحدة 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")

Objective-C

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

Unity

استورِد مساحة الاسم Firebase.Analytics وأدخِل عنوان البريد الإلكتروني إلى InitiateOnDeviceConversionMeasurementWithEmailAddress() API أو رقم الهاتف إلى InitiateOnDeviceConversionMeasurementWithPhoneNumber() API:

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.
  - استبدِل الحرف o بالرقم 0.
  - استبدِل الحرف 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

import FirebaseAnalytics

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

Objective-C

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

@import FirebaseAnalytics;

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

Unity

استورِد مساحة الاسم Firebase.Analytics وأدخِل عنوان البريد الإلكتروني إلى واجهة برمجة التطبيقات InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() أو رقم الهاتف إلى واجهة برمجة التطبيقات 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: تحديد المشاكل الشائعة وحلّها