إدارة العلامات من 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)، أضِف الاعتماد التالي على مكتبة "إدارة العلامات":

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

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

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

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

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

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

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

.

لمعاينة الحاوية (إذا كنت تستخدم 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 ساعة.

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

اقرأ الإعدادات المتقدمة.