برنامج تعليمي: قياس الإحالات الناجحة في "إعلانات 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. أجرِ الاستبدالات التالية في جزء اسم المستخدم:

      • استبدِل الحرف l بالحرف I أو i أو الرقم 1.
      • استبدِل الحرف o بالرقم 0.
      • استبدِل الحرف z بالرقم 2.
      • استبدِل الحرف s بالرقم 5.

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

• 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 (اختياري)

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

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

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

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

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