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

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

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

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

قبل البدء:

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

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

1- إضافة أداة "إدارة العلامات من Google" إلى مشروعك

1. في ملف Gradle الخاص بالوحدة (عادةً app/build.gradle)، أضِف التبعية التالية إلى مكتبة "إدارة العلامات من Google":

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

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

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

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

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

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

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

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

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

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

ضبط المتغيّرات في أداة "إدارة العلامات من Google"

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

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

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

و:

• اسم المتغيّر: نص كامل
• نوع المتغيّر: مَعلمة الحدث
• اسم مفتاح معلمة الحدث: full_text

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

• اسم المتغيّر: الطعام المفضّل
• نوع المتغيّر: خاصيّة المستخدم في Firebase
• اسم مفتاح معلمة الحدث: favorite_food

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

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

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

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

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

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

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

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

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

الشكل 1: احصل على عنوان 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" على الويب، يمكنك إنشاء رابط معاينة:

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

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

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

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

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

نشر الحاوية

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

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

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

اقرأ الضبط المتقدّم.