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

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

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

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

قبل البدء:

• أضف تطبيقك إلى مشروع 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.1.1'
   }
   

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

3. اختَر حاوية متنقلة.

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

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

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

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" لحظر إرسال الأحداث إلى "إحصاءات Google".

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

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

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

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

الشكل 1: الحصول على عنوان URL لمعاينة العلامة من واجهة ويب أداة "إدارة العلامات من Google"

لمعاينة الحاوية (إذا كنت تستخدم "استوديو Android"، انتقِل إلى الخطوة 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 ساعة.

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

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