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

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

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

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

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

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

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

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

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")

@import FirebaseAnalytics;

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

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، لذا اتّبِع الخطوات التالية لتسوية بياناتك:

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 (أي أن تبدأ بعلامة +، وتتضمّن من رقم واحد إلى ثلاثة أرقام لرمز البلد، و12 رقمًا كحد أقصى لرقم المشترك) قبل التجزئة باستخدام SHA256.

يُرجى العِلم أنّ عناوين البريد الإلكتروني أو أرقام الهواتف المجزّأة باستخدام خوارزمية SHA256 يجب أن يبلغ طولها 32 بايت وألّا تكون سلسلة سداسية عشرية.

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

import FirebaseAnalytics

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

@import FirebaseAnalytics;

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

using Firebase.Analytics;

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

تأكيد عملية الدمج

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

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

إذا فعّلت وضع تصحيح الأخطاء وأدرجت وسيطة التشغيل -DebugOnDeviceConversionMeasurement، سيؤدي استدعاء واجهة برمجة التطبيقات initiateOnDeviceConversionMeasurement() إلى محاكاة عملية مطابقة.

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

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