إدارة العلامات من 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.0.4'
   }
   

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

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" لحظر إرسال الأحداث إلى "إحصاءات 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. سجِّل الدخول إلى حسابك على إدارة العلامات.
   2. اختَر حاوية للأجهزة الجوّالة.
   3. انقر على الإصدارات في شريط التنقل العلوي.
   4. انقر على الإجراءات > معاينة في إصدار الحاوية الذي تريد معاينته.
   5. أدخِل اسم حزمة التطبيق.
   6. انقر على إنشاء رابط بدء المعاينة.

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

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

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

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

نشر الحاوية

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

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

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

اطّلِع على الضبط المتقدّم.