برنامج تعليمي: قياس الإحالات الناجحة في "إعلانات 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 (أي البادئة +، و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);

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

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