إطلاق الحملات على "إعلانات Google" باستخدام الأحداث المخصّصة وFlutter في "إحصاءات Google"

1. مقدمة

تاريخ آخر تعديل: 25/01/2021

ما الذي ستنشئه

في هذا الدرس التطبيقي حول الترميز، ستتعلّم كيفية تنفيذ أحداث مخصّصة باستخدام "إحصاءات Google لبرنامج Firebase"، وإطلاق حملات إجرائية من خلال تطبيق "إعلانات Google" لبرنامج Flutter.

سنستخدم تطبيق Flutter التلقائي مع أداة عدّاد بسيطة. سنعلن عن تطبيقنا للمستخدمين المحتملين الذين يُرجح أن ينقروا على الأداة.

المعلومات التي ستطّلع عليها

• كيفية إعداد "إحصاءات Google لبرنامج Firebase" (GA4F) في Flutter
• كيفية إنشاء أحداث ومَعلمات مخصّصة
• كيفية استيراد الأحداث من Firebase إلى "إعلانات Google"
• كيفية إطلاق حملات إجرائية باستخدام أحداث مخصّصة

المتطلبات

• الإصدار 3.6 من "استوديو Android" أو إصدار أحدث
• Xcode (لدعم iOS)
• حساب Firebase
• حساب "إعلانات Google"

2. بدء مشروع جديد على Flutter

يمكنك إنشاء تطبيق Flutter بتصميم بسيط. عليك تعديل تطبيق البداية هذا للدرس التطبيقي حول الترميز.

شغِّل "استوديو Android".

ملاحظة: إذا لم يظهر لك مشروع New Flutter Project ضمن الخيارات في بيئة التطوير المتكاملة (IDE)، تأكَّد من أنّ المكوّنات الإضافية مثبّتة في Flutter وDart.

1. إذا لم تكن لديك مشاريع مفتوحة، اختَر بدء تطبيق Flutter جديد من صفحة الترحيب. أو حدد ملف > جديد > مشروع Flutter الجديد
2. اختَر تطبيق Flutter كنوع المشروع، ثم انقر على التالي.
3. تأكَّد من أنّ مسار Flutter SDK يحدّد موقع حزمة SDK. (اختَر تثبيت حزمة تطوير البرامج (SDK) إذا كان حقل النص فارغًا.)
4. أدخِل اسم المشروع وانقر على التالي.
5. استخدِم اسم الحزمة التلقائي المُقترَح من "استوديو Android"، وانقر على التالي.
6. انقر على إنهاء.
7. انتظِر حتى يتم تثبيت حزمة تطوير البرامج (SDK) وإنشاء المشروع في "استوديو Android".

3- إنشاء مشروع على Firebase وإعداده

لبدء استخدام Firebase، ستحتاج إلى إنشاء مشروع على Firebase وإعداده.

إنشاء مشروع على Firebase

1. سجِّل الدخول إلى Firebase.

في "وحدة تحكُّم Firebase"، انقر على "إضافة مشروع" (أو إنشاء مشروع)، وأدخِل اسمًا لمشروع Firebase باسم Firebase-Flutter-Ads أو أي اسم تريده.

2. انقر على خيارات إنشاء المشروع. وافِق على بنود Firebase إذا طُلب منك ذلك. يجب تفعيل "إحصاءات Google" لهذا المشروع، لأنّك تحتاج إلى أحداث "إحصاءات Google" لتتبُّع أحداث الإجراءات وتحليل الإحالات الناجحة.

لمزيد من المعلومات عن مشاريع Firebase، يمكنك الاطّلاع على مقالة فهم مشاريع Firebase.

4. ضبط Firebase على مستوى النظام الأساسي (Android)

ضبط Android

1. في وحدة تحكُّم Firebase، اختَر نظرة عامة على المشروع في شريط التنقّل الأيمن، ثم انقر على الزرّ Android ضمن "البدء بإضافة Firebase إلى تطبيقك".

سيظهر لك مربّع الحوار في الشاشة التالية.

2. القيمة المهمة التي يجب تقديمها هي اسم حزمة Android، الذي ستحصل عليه باتّباع الخطوة التالية.

ملاحظة: اطّلِع على مقالة ضبط رقم تعريف التطبيق للحصول على مزيد من المعلومات عن أرقام تعريف الحِزم والتطبيقات.

3. في دليل تطبيق Flutter، افتح الملف android/app/src/main/AndroidManifest.xml.
4. في العنصر manifest، ابحث عن قيمة السلسلة للسمة package. هذه القيمة هي اسم حزمة Android (مثل com.yourcompany.yourproject). انسخ هذه القيمة.
5. في مربع حوار Firebase، الصق اسم الحزمة المنسوخة في الحقل Android package name.
6. لا نحتاج إلى مفتاح SHA-1 هنا، إلا إذا كنت تخطّط لاستخدام ميزة تسجيل الدخول بحساب Google أو الروابط الديناميكية من Firebase (تجدر الإشارة إلى أنّ هذه الروابط ليست جزءًا من هذا الدرس التطبيقي حول الترميز). إذا كنت تخطط لاستيراد بيانات in_app_purchase من Google Play، ستحتاج إلى ضبط المفتاح لاحقًا.
7. انقر على تسجيل التطبيق.
8. المتابعة في Firebase، اتّبِع التعليمات لتنزيل ملف الإعداد google-services.json.

9. انتقِل إلى دليل تطبيق Flutter، ثم انقل ملف google-services.json (الذي نزّلته للتو) إلى دليل android/app.
10. بالعودة إلى "وحدة تحكُّم Firebase"، تخطي الخطوات المتبقية والرجوع إلى الصفحة الرئيسية لوحدة تحكُّم Firebase.
11. وأخيرًا، تحتاج إلى مكوِّن Gradle الإضافي لخدمات Google لقراءة ملف google-services.json الذي تم إنشاؤه من خلال Firebase.
12. في بيئة التطوير المتكاملة (IDE) أو المحرّر، افتح android/app/build.gradle، ثم أضِف السطر التالي ليكون السطر الأخير في الملف:

apply plugin: 'com.google.gms.google-services'

13. افتح android/build.gradle، ثم أضِف تبعية جديدة داخل العلامة buildscript:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. إذا كان تطبيقك لا يزال قيد التشغيل، أغلِقه وأعِد إنشائه للسماح لتطبيق Gradle بتثبيت الاعتماديات.

لقد انتهيت من ضبط تطبيق Flutter لنظام التشغيل Android بالنسبة إلى نظام التشغيل iOS، يمكنك الاطّلاع على هذا الدرس التطبيقي حول الترميز ( التعرّف على منصة Firebase عند استخدام Flutter)

5- ضبط "إحصاءات Firebase" في Flutter

في هذه الخطوة، ستبدأ في استخدام حزمة Firebase Analytics المسماة firebase_analytics، والتي تحتوي على ميزات Firebase Analytics.

يدير ملف pubspec مواد العرض الخاصة بتطبيق Flutter. في pubspec.yaml، ألحق firebase_analytics: ^6.2.0 (الإصدار 6.2.0 من firebase_analytics أو إصدار أحدث) بقائمة الاعتماديات :

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

أثناء الاطّلاع على مواصفات الناشر في عرض المحرّر في "استوديو Android"، انقر على الحصول على الحزم. هذا يسحب الحزمة إلى مشروعك. من المفترض أن يظهر لك ما يلي في وحدة التحكّم:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

يؤدي تنفيذ Pub get أيضًا إلى إنشاء ملف pubspec.lock تلقائيًا مع قائمة بجميع الحِزم التي يتم سحبها إلى المشروع وأرقام إصداراتها.

تنبيه: بالنسبة إلى إصدارات معيّنة من Firebase، تظهر السمة java.lang.IllegalArgumentException: Service not registered عند إعداد فئة FirebaseAnalytics لأول مرة (راجِع مشكلة github 1662).

في lib/main.dart، استورِد الحزمة الجديدة:

import 'package:firebase_analytics/firebase_analytics.dart';

في الفئة MyApp، ابدأ الكائن FirebaseAnalytics من خلال استدعاء الدالة الإنشائية.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

أصبحت الآن جاهزًا لتنشيط بعض سجلات الأحداث المخصّصة.

6- تسجيل الأحداث المخصّصة باستخدام "إحصاءات Firebase"

إذا أردت إنشاء نموذج جديد في تطبيق Flutter، سيظهر لك متغيّر _counter وطريقة _incrementCounter() داخل فئة State التلقائية. والآن، تريد تسجيل أحداث مخصصة عندما يتم النقر على زر الزيادة أكثر من خمس مرات من المستخدمين المتحمسين للغاية. ونطلق لاحقًا حملة تطبيقات لجذب المستخدمين المتحمسين المحتملين

نريد أولاً تمرير العناصر التحليلية التي نفّذناها إلى التطبيق المصغّر Stateful. نبدأ بإضافة مَعلمة "إحصاءات Google" إلى الدالة الإنشائية MyHomePage.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

وعليك أيضًا إضافة مَعلمة "إحصاءات Google" عند استدعاء الدالة الإنشائية.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

يمكنك الآن تسجيل الأحداث بسهولة باستخدام الطريقة logEvent(). أضِف الطريقة واعمل على زيادة المتغيّر _counter.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

أصبح تطبيقك الآن جاهزًا لتنشيط سجل الأحداث المخصّص.

يمكنك أيضًا استخدام طرق مُعَدة مسبقًا لتنشيط الأحداث.

كل شيء جاهز الآن. في "استوديو Android"، شغِّل "main.dart".

(اختياري) إرسال معلومات إضافية إلى "إحصاءات Firebase" باستخدام المَعلمات

يمكنك إرسال معلومات إضافية من خلال المَعلمات. يمكن تسجيل المَعلمات المخصَّصة لإعداد التقارير في تقارير "إحصاءات Google". ويمكن استخدامها أيضًا كفلاتر في تعريفات الجمهور التي يمكن تطبيقها على كل تقرير. إذا كان تطبيقك مرتبطًا بمشروع على BigQuery، يتم أيضًا العثور على مَعلمات مخصّصة في BigQuery (اطّلع على مقالة BigQuery Export for Firebase).

نُضبط القيمة _counter كمَعلمة هنا.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

التحقّق من الأحداث وتصحيح الأخطاء فيها

بعد مرور عدّة ساعات، يمكنك الاطّلاع على الأحداث التي تمّ تسجيلها في وحدة تحكُّم Firebase. ما عليك سوى النقر على علامة التبويب الأحداث من قسم "إحصاءات Google" المتوفّر في "وحدة تحكُّم Firebase". يمكنك أيضًا الاطّلاع على القيم داخل الحدث clicked_counter من خلال النقر على الحدث فقط.

ضَع علامة على clicked_counter كإحالة ناجحة من خلال تمرير مفتاح وضع علامة كإحالة ناجحة إلى اليسار.

إذا كان الحدث في علامة التبويب "الإحالة الناجحة"، يعني ذلك أنّك وضعت علامة "إحالة ناجحة" بنجاح على الحدث. ستتمكّن "إعلانات Google" الآن من استيراد هذا الحدث من Firebase.

لأغراض تصحيح الأخطاء، استخدِم Firebase DebugView. لمزيد من التفاصيل، يُرجى الاطّلاع على حدث تصحيح الأخطاء.

7. استيراد أحداث الإحصاءات في "إعلانات Google"

بعد اكتمال عملية إعداد Firebase-Flutter، ستكون جاهزًا لإطلاق حملات التطبيقات التي تتضمّن أحداثًا إجرائية. ابدأ بربط Firebase بحساب "إعلانات Google". من خلال ربط Firebase بحساب "إعلانات Google"، يمكن لحملات التطبيقات استيراد أحداث Firebase. تساعد هذه العملية أيضًا "إعلانات Google" في تعزيز حملات التطبيقات من خلال السماح لها بالاطّلاع على مزيد من المعلومات عن جماهيرها.

1. انتقِل إلى إعدادات Firebase من خلال النقر على الزر بجانب نظرة عامة على المشروع.
2. في علامة التبويب عمليات الدمج، سيظهر لك إعلانات Google والزر ربط. انقر على ربط، ثمّ انقر على متابعة.

3. اختَر حسابًا على "إعلانات Google".

تنبيه: إذا لم يتم وضع علامة "حدث إحالة ناجحة" على الحدث المستهدَف، لن تتمكّن "إعلانات Google" من استيراده. تأكَّد من أنّ الحدث مصنّف بشكلٍ صحيح كإحالة ناجحة.

اكتمل الآن جزء Firebase.

انتقِل إلى إعلانات Google.

1. سجِّل الدخول وانتقِل إلى الأدوات الإعدادات > القياس > الإحالات الناجحة لاستيراد الأحداث المخصّصة كإحالات ناجحة.
2. انقر على الزرّ + لإضافة إجراءات إحالات ناجحة جديدة.

3. اختَر مواقع "إحصاءات Google 4" (Firebase) وانقر على متابعة.

4. يمكنك الاطّلاع على جميع أحداث الإحصاءات التي تمّ وضع علامة "إحالة ناجحة" عليها. ابحث عن حدث clicked_counter الذي سبق أن نفّذناه.

5. تحقَّق من الإجراء، وانقر على استيراد، ثم انقر على متابعة.

بعد ضبط clicked_counter كإجراء إحالة ناجحة، يمكنك إطلاق حملات إجرائية يمكنها استهداف المستخدِمين الذين يُرجّح أن ينشط clicked_counter حدث أكثر من 5 مرّات.

8. إطلاق حملات التطبيقات الإجرائية مع الأحداث التي تم استيرادها

ملاحظة مُهمّة: لإطلاق حملة تطبيقات بنجاح، يجب الحصول على تطبيق على مستوى الإصدار العلني في Google Play. مع ذلك، إذا لم تكن جاهزًا للنشر بعد، يمكنك تخطّي هذه الخطوة في الوقت الحالي.

6. انتقل إلى علامة التبويب "الحملة" في حسابك الحالي، وابدأ حملة جديدة بالنقر على الزر +. انقر على [حملة جديدة]، ثم انقر على متابعة.
7. ابدأ حملة للترويج للتطبيقات باستخدام الخيار عمليات تثبيت التطبيق.

8. ابحث عن تطبيقك عن طريق كتابة اسم التطبيق أو اسم الحزمة أو الناشر.
9. في قسم عروض الأسعار، اختَر الإجراءات داخل التطبيق في القائمة المنسدلة.
10. ابحث عن الحدث المخصّص في القائمة المتوفّرة. حدِّد تكلفة الإجراء المستهدَفة، وأكمِل أي خيارات إضافية.

11. أكمِل إعدادات حملتك.

9. تهانينا

تهانينا، لقد تم دمج Firebase مع "إعلانات Google" بنجاح. سيساعدك ذلك في تعزيز أداء حملتك باستخدام الأحداث المستورَدة من Firebase.

لقد تعلمت

• كيفية ضبط "إحصاءات Firebase" لبرنامج Flutter
• كيفية تسجيل الأحداث المخصّصة باستخدام "إحصاءات Firebase" في تطبيق Flutter
• كيفية استيراد الأحداث واستخدامها للحملات الإجرائية