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

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

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

اتصل بواجهة برمجة التطبيقات

اتصل بواجهة برمجة التطبيقات لقياس التحويل باستخدام عنوان البريد الإلكتروني أو رقم الهاتف المعتمد من الخطوة 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، ثم اتصل بواجهة برمجة التطبيقات (API).

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

بالنسبة إلى عناوين البريد الإلكتروني ، تفترض واجهة برمجة تطبيقات 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 anemlluserolzs@gmail.com
• يصبح CAPSUSER0125@provider.net capsuser0125@provider.net

بالنسبة لأرقام الهواتف ، يجب أن تكون الأرقام بتنسيق E.164 بالفعل (أي بادئة بـ +، 1-3 أرقام لرمز البلد، و12 رقمًا كحد أقصى لرقم المشترك) قبل التجزئة باستخدام SHA256.

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

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:

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

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

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

arrow_back_ios الخطوة 2 : دمج Google Analytics الخطوة 4 : استكشاف المشكلات الشائعة وإصلاحها والتعامل معها arrow_forward_ios