أرسل أحداث التطبيق إلى GA4 باستخدام Measurement Protocol

1 المقدمة

آخر تحديث: 2021-06-08

ماذا ستبني

في مختبر الرموز هذا ، ستتعلم كيفية إرسال الأحداث الخارجية إلى GA4 باستخدام Measurement Protocol .

يفترض مختبر الشفرات هذا أن لديك بالفعل تطبيقًا تم تنفيذه مع Google Analytics for Firebase. إذا كنت تريد معرفة كيفية التكامل مع Google Analytics for Firebase ، فالرجاء الرجوع إلى مختبر الرموز هذا أولاً. إذا كنت تريد معرفة كيفية إنشاء تطبيق باستخدام Firebase ، فيرجى الرجوع إلى Firebase Android Codelab-Build Friendly Chat .

ماذا ستتعلم

• خطوات لإجراء أول مكالمة MP لك
• فهم المعلمات المطلوبة للمكالمة
• إرسال والتحقق من صحة مكالمة الاختبار الخاصة بك
• أنشئ نموذجًا نصيًا في Python لإجراء المكالمة

ماذا ستحتاج

• تطبيق Android أو iOS الخاص بك
• أي IDE لإجراء تغييرات
• حساب GA4
• اختياري - بيئة تطوير Python (أو Colab )

2. اجمع الحقول الإلزامية

أنشئ سر واجهة برمجة التطبيقات في GA4

انتقل إلى GA4 وأنشئ سر واجهة برمجة التطبيقات الجديد الخاص بك بالانتقال إلى المسؤول > تدفقات البيانات > اختر التدفق > بروتوكول القياس > إنشاء

يمكنك تقديم أي اسم مستعار ، وسيتم عرض القيمة السرية ، والتي يمكنك استخدامها في مكالمتك

إذا لم تكن متأكدًا من كيفية الوصول إلى GA4 ، يمكنك زيارة مشروع Firebase ، والتحقق من إعدادات المشروع> عمليات التكامل> Google Analytics ، والنقر على "إدارة". يجب أن يكون اتصال Google Analytics مرئيًا ، ويمكنك التنقل مباشرة من هناك أيضًا

اجمع app_instance_id

يمكنك استخدام أي من الطرق أدناه لجمع app_instance_id الخاص بك.

1. استخدام BigQuery Export
2. الجلب في الأصل في كود مصدر التطبيق

كلاهما موضح بالتفصيل أدناه

1. استخدام BigQuery Export

في حالة تمكين BigQuery Export ، يمكنك اتباع الخطوات التالية

• سجّل الدخول إلى Firebase
• انتقل إلى إعدادات المشروع> عمليات التكامل> BigQuery
• انقر على "عرض في BigQuery" بالقرب من مجموعة البيانات

ملاحظة: لن تكون مجموعة البيانات متاحة إلا بعد تمكين التبديل لحوالي 24-48 ساعة

• في BigQuery ، يمكنك التحقق من user_pseudo_id في الجدول. هذا هو app_instance_id الذي يمكنك استخدامه في مكالمتك

2. الجلب في الأصل في كود مصدر التطبيق

إذا تم إنشاء تطبيقك باستخدام Java ، فيمكنك استخدام شيء مثل هذا لاسترداد app_instance_id

 FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
            if (task.isSuccessful()) {
                String user_pseudo_id = task.getResult();
            }
        }
    });

بالنسبة لـ Kotlin ، يمكنك تجربة ما يلي

Thread {
   Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
       Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
       /*
       Store the value to your server or do something with the retrieved id
        */
   }
}.start()

إذا كان لديك تطبيق iOS ، فيمكنك استخدام ما يلي في Swift

let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/

يوجد أدناه المزيد من الروابط اعتمادًا على بنيتك التحتية

• Android - getAppInstanceId ()
• سويفت - appInstanceID ()
• الهدف- C - appInstanceID
• C ++ - GetAnalyticsInstanceId ()
• الوحدة - GetAnalyticsInstanceIdAsync ()

3. إنشاء المكالمة

يمكنك إنشاء نموذج مكالمة باستخدام Event Builder في GA4. (هذا يتطلب منك تسجيل الدخول وتمكين ملفات تعريف الارتباط). تأكد من ضبط مفتاح التبديل على "firebase"

يجب أن تملأ الحقول التالية

• api_secret - تم إنشاؤه مسبقًا في GA4
• firebase_app_id - للحصول على هذا ، يمكنك الانتقال إلى المسؤول > تدفقات البيانات > اختر الدفق الخاص بك . يجب أن يتم عرضها على النحو التالي

• app_instance_id - لقد استردت هذه القيمة بالفعل
• user_id ليس إلزاميًا. يمكنك تركه فارغًا الآن
• الفئة - قم بتغيير هذا إلى "مخصص" من القائمة المنسدلة ، وقم بوضع اسم لأي حدث من اختيارك (لا تستخدم أي حدث تم تجميعه تلقائيًا ). نحن هنا نستخدم "test_from_codelab"

اختياريًا ، يمكنك أيضًا اختيار تقديم معلمات الحدث و / أو خصائص المستخدم من خلال النقر على الأزرار أدناه

بمجرد ملء كل شيء ، من المفترض أن ترى شيئًا كهذا ، مع زر "التحقق من صحة الحدث"

بمجرد الوصول إلى هذا ، انقر فوق "VALIDATE EVENT" ، الزر مظلل باللون البرتقالي. يجب أن تعرض الرسالة أدناه ، مع تحديد أن الحدث صالح ، وسترى زرًا الآن "SEND TO GA". في هذه المرحلة ، إذا تبين أن الحدث غير صالح ، فستخبرك الأداة بالحقل الدقيق الذي توجد به مشكلة ، ويمكنك إصلاح ذلك وإعادة المحاولة

يمكنك الآن النقر فوق الزر ، ويجب أن يرسل حدث اختبار إلى GA4

4. التحقق من صحة الأحداث في GA4

بمجرد إرسال الحدث ، يمكنك الانتقال إلى حساب GA4 والتحقق من الوقت الفعلي. يجب أن ترى الحدث يأتي

قد يستغرق نشر الأحداث من العرض في الوقت الفعلي إلى علامة تبويب الإبلاغ عن الأحداث الفعلية حوالي 24 ساعة ، لذلك لا داعي للقلق إذا لم تشاهد هذا في تقارير الأحداث العادية على الفور!

5. بناء نص بايثون

الآن بعد أن اختبرت ذلك ، يمكنك فحص استدعاء API ، وحمولة الحدث لبناء بنية مماثلة في Python (أو بأي لغة من اختيارك) يمكنها إجراء هذه المكالمة. يمكنك بعد ذلك جدولة هذا بالتردد الذي تريده وتشغيله. بالنسبة لهذا الجزء ، يمكنك إما استخدام أي IDE من اختيارك يدعم Python أو مجرد استخدام دفتر Google Colab الذي لا يتطلب أي تثبيت على جهازك

بالرجوع إلى GA4 Event Builder ، سترى أن نقطة النهاية على النحو التالي

POST /mp/collect?firebase_app_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

كانت حمولة الحدث على النحو التالي

{
  "app_instance_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

يمكنك ترجمة هذا إلى Python باستخدام شيء مثل هذا

import requests
import json
url = "https://www.google-analytics.com/mp/collect?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
  "app_instance_id": XXXX,
  "non_personalized_ads": False,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

بمجرد تنفيذ هذا بالقيم الصحيحة ، يجب أن ترى بالمثل الحدث ينعكس في الوقت الفعلي في GA4.

6. مبروك

تهانينا ، لقد نجحت في استخدام Measurement Protocol في GA4. يمكنك الآن إنشاء بنى حلول قوية لإرسال المزيد من البيانات ذات المغزى إلى Google Analytics وتحسين التسويق وتحليلات الأعمال. لتحقيق أقصى استفادة من ذلك ، نقترح أيضًا الاتصال ببرنامج إعلانات Google واستيراد هذه الأحداث كتحويلات. يمكنك الرجوع إلى الخطوة 6 في مختبر الرموز هذا للحصول على إرشادات مفصلة حول ذلك. لأغراض تتبع التحويل ، لن يعرض إعلانات Google سوى البيانات المرتبطة بـ IDFA أو معرّفات الجهاز التي تم جمعها من Firebase SDK خلال آخر 60 يومًا. ضع في اعتبارك أن هذا لا يزال واجهة برمجة تطبيقات alpha وتأكد من متابعة القيود المدرجة هنا والتي يجب معالجتها قبل الإطلاق الكامل

لقد تعلمت

• كيفية جمع المتغيرات الصحيحة لإجراء مكالمات MP
• كيفية إرسال أحداث الاختبار والتحقق منها
• كيفية إنشاء برنامج نصي لإرسال مكالمات MP