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

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

بعد أن أصبح بإمكانك جمع عناوين البريد الإلكتروني وأرقام الهواتف الخاصة بالمستخدمين وتضمين حزمة تطوير البرامج (SDK) لأداة Google Analytics لبرنامج 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 (أي أنّه يجب أن تبدأ بعلامة +، وأن تتضمّن رمز البلد الذي يتألف من 1 إلى 3 أرقام، ورقم المشترك الذي يتألف من 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);

التأكّد من عملية التكامل

فعِّل وضع تصحيح الأخطاء. بعد استدعاء واجهة برمجة تطبيقات لقياس البيانات لبدء القياس، تأكَّد من ظهور رسالة مثل رسالة مسجّلة التالية في وحدة تصحيح الأخطاء في 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