إدارة العلامات من Google لنظام التشغيل Android

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

يمكن للمطوّرين تسجيل الأحداث المهمة وتحديد العلامات أو وحدات البكسل التي يجب تنشيطها لاحقًا.

المتطلبات الأساسية

قبل البدء:

• أضِف تطبيقك إلى مشروع Firebase من خلال وحدة تحكم Firebase.
• أعِدّ "إحصاءات Google" لتطبيقك، بما في ذلك تفعيل "إحصاءات Google" في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" إلى تطبيقك.
• أنشِئ حسابًا على أداة "إدارة العلامات من Google".
• أكمِل عملية إعداد حاوية "إدارة العلامات من Google".

توضّح لك الأقسام التالية خطوات إعداد أداة "إدارة العلامات من Google" واستخدامها في تطبيق Android.

1- إضافة Google Tag Manager إلى مشروعك

1. في ملف Gradle للوحدة (عادةً ما يكون app/build.gradle)، أضِف الاعتمادية التالية على مكتبة Tag Manager:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. سجِّل الدخول إلى حسابك على أداة "إدارة العلامات من Google".

3. اختَر حاوية للأجهزة الجوّالة.

4. انقر على الإصدارات في شريط التنقّل العلوي.

5. انقر على إصدار الحاوية الذي تريد استخدامه.

6. انقر على تنزيل.

7. أنشِئ المجلد app/src/main/assets/containers إذا لم يكن موجودًا. انسخ الحاوية التي تم تنزيلها إلى المجلد.

2- تسجيل الأحداث والمتغيّرات

تستخدم أداة "إدارة العلامات من Google" الأحداث والمَعلمات وخصائص المستخدمين التي تسجّلها حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" لتنشيط العلامات التي أعددتها في أداة "إدارة العلامات من Google" وإنشائها.

اطّلِع على مستندات المطوّرين في Firebase للحصول على تعليمات حول كيفية تسجيل الأحداث وضبط خصائص المستخدمين.

إعداد المتغيّرات في Tag Manager

لتسجيل قيمة مَعلمات الأحداث وخصائص المستخدمين لاستخدامها في Google Tag Manager، يمكنك إعداد المتغيّرات في واجهة أداة "إدارة العلامات".

على سبيل المثال، يمكنك تسجيل الحدث المخصّص التالي في تطبيقك:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

بعد ذلك، يمكنك إعداد متغيّرات جديدة من النوع "مَعلمة الحدث" في أداة "إدارة العلامات من Google" على النحو التالي لتسجيل قيمتَي المَعلمتَين image_name وfull_text parameter:

• اسم المتغيّر: Image Name
• نوع المتغيّر: Event Parameter
• اسم مفتاح مَعلمة الحدث: image_name

و:

• اسم المتغيّر: Full Text
• نوع المتغيّر: Event Parameter
• اسم مفتاح مَعلمة الحدث: full_text

وبالمثل، يمكنك ضبط خاصية المستخدم التالية في تطبيقك:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

بعد ذلك، يمكنك إعداد متغيّر جديد من النوع "خاصية مستخدم Firebase" في أداة "إدارة العلامات من Google" لتسجيل قيمة favorite_food:

• اسم المتغيّر: Favorite Food
• نوع المتغيّر: Firebase User Property
• اسم مفتاح مَعلمة الحدث: favorite_food

تعديل الأحداث وحظرها

تتيح لك أداة Tag Manager تعديل الأحداث وحظرها قبل أن تسجّلها حزمة تطوير البرامج (SDK) لأداة ‫SDK "إحصاءات Google لـ Firebase". يمكن أن يساعدك تعديل الأحداث في إضافة قيم مَعلمات الأحداث أو إزالتها أو تغييرها أو تعديل أسماء الأحداث بدون إجراء تحديثات للتطبيق. ستسجّل حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" الأحداث التي لم يتم حظرها.

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

3- إرسال الأحداث

تُستخدَم متغيّرات اسم حدث Firebase ومتغيّرات المَعلمة الخاصة بحدث Firebase والمتغيّرات الأخرى لإعداد المشغّلات. يتم تقييم شروط المشغّل في كل مرة تسجّل فيها حدثًا على Firebase. تتنشّط أحداث "إحصاءات Google لبرنامج Firebase" تلقائيًا بشكلٍ تلقائي. من الممكن إضافة علامة "إحصاءات Google لـ Firebase" في Tag Manager لمنع إرسال الأحداث إلى "إحصاءات Google".

4- معاينة الحاوية وتصحيح أخطائها ونشرها

قبل نشر إصدار من حاويتك، عليك معاينته للتأكّد من أنّه يعمل على النحو المطلوب. تمنحك أداة Google Tag Manager إمكانية معاينة إصدارات حاويتك من خلال إنشاء روابط ورموز QR في واجهة الويب واستخدامها لفتح تطبيقك. يمكنك أيضًا تفعيل وضع التسجيل المطوَّل لتصحيح أي سلوك غير متوقَّع.

معاينة الحاوية

قبل معاينة حاوية، أنشِئ عنوان URL للمعاينة في واجهة الويب لأداة Google Tag Manager من خلال اختيار إصدار الحاوية الذي تريد معاينته، ثم النقر على معاينة. احفظ عنوان URL للمعاينة هذا لاستخدامه في الخطوات اللاحقة.

لمعاينة حاويتك (إذا كنت تستخدم Android Studio، انتقِل إلى الخطوة 3):

1. أضِف نشاط المعاينة هذا إلى ملف AndroidManifest:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. غيِّر هذا السطر ليشمل اسم حزمة تطبيقك:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. في واجهة الويب لأداة Google Tag Manager، أنشِئ رابط معاينة:

   1. سجِّل الدخول إلى حسابك على Tag Manager.
   2. اختَر حاوية للأجهزة الجوّالة.
   3. انقر على الإصدارات في شريط التنقّل العلوي.
   4. انقر على الإجراءات > معاينة في إصدار الحاوية الذي تريد معاينته.
   5. أدخِل اسم حزمة تطبيقك.
   6. انقر على إنشاء رابط "بدء المعاينة".

4. أوقِف تطبيقك واستخدِم رابط المعاينة أو رمز QR الذي تم إنشاؤه لتشغيل تطبيقك.

5. يمكنك الخروج من وضع المعاينة من خلال النقر على رابط تم إنشاؤه باستخدام الخيار إنشاء رابط "إنهاء المعاينة" في واجهة الويب.

تصحيح أخطاء الحاوية

لتحديد المشاكل وحلّها في عملية تنفيذ الحاوية، فعِّل التسجيل المطوَّل:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

نشر الحاوية

بعد معاينة الحاوية والتأكّد من أنّها تعمل، يمكنك نشرها. بعد نشر الحاوية، ستصبح إعدادات العلامات متاحةً لمستخدمي التطبيقات على الأجهزة الجوّالة.

الخطوات التالية

اطّلِع على مقالة الإعداد المُتقدِّم.