وبصفتك مطوّرًا، يمكنك استخدام أداة "إدارة العلامات من Google" لتنفيذ الإجراءات وإدارتها وعلامات القياس ووحدات البكسل في تطبيقات الأجهزة الجوّالة، بدون الحاجة إلى إعادة إنشاء البرامج الثنائية للتطبيقات وإعادة إرسالها إلى أسواق التطبيقات. المطورون الذين تعمل باستخدام حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" يمكن أن تضيف بسهولة أداة "إدارة العلامات من Google" إلى في إدارة عملية التنفيذ وإجراء تغييرات عليها، حتى بعد شحنها.
يمكن للمطوّرين تسجيل الأحداث المهمة وتحديد العلامات أو وحدات البكسل لاحقًا. طردهم.
المتطلبات الأساسية
قبل البدء:
- أضف تطبيقك إلى مشروع Firebase من خلال وحدة تحكم Firebase.
- إعداد "إحصاءات Google" لتطبيقك، بما في ذلك تفعيل "إحصاءات Google" في مشروعك على Firebase وإضافة حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" إلى تطبيقك.
- أنشئ حسابًا على أداة "إدارة العلامات من Google".
- عليك ضبط حاوية أداة "إدارة العلامات من Google".
ترشدك الأقسام التالية خلال خطوات ضبط إعدادات خدمات Google واستخدامها إدارة العلامات في تطبيق Android.
1. إضافة أداة "إدارة العلامات من Google" إلى مشروعك
في ملف Gradle للوحدة (عادةً
app/build.gradle
)، أضف ما يلي: والاعتمادية على مكتبة أداة "إدارة العلامات من Google":dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
اختَر حاوية للأجهزة الجوّالة.
انقر على الإصدارات في شريط التنقل العلوي.
انقر على إصدار الحاوية الذي تريد استخدامه.
انقر على Download (تنزيل).
أنشئ المجلد "
app/src/main/assets/containers
" إذا لم يكن متوفّرًا. نسخ الحاوية التي تم تنزيلها إلى المجلد.
2. أحداث السجلّ والمتغيّرات
تستخدِم أداة "إدارة العلامات من Google" الأحداث والمعلَمات وخصائص المستخدِمين المسجّلة من قِبل Google حزمة تطوير البرامج (SDK) في "إحصاءات Google لبرنامج Firebase" من أجل تشغيل وإنشاء العلامات التي تم ضبطها فيها إدارة العلامات من Google.
راجِع مستندات مطوّري Firebase للحصول على تعليمات حول كيفية أحداث السجلّ وإعداد خصائص المستخدمين.
ضبط المتغيّرات في أداة "إدارة العلامات من Google"
لتسجيل قيمة مَعلمات الأحداث وخصائص المستخدِمين لاستخدامها في 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". يمكن أن يساعدك تعديل الأحداث في إضافة أو إزالة أو تغيير قيم مَعلمات الأحداث أو تعديل أسماء الأحداث بدون تحديثات التطبيقات ستسجّل "إحصاءات Google لبرنامج Firebase" الأحداث غير المحظورة. SDK.
تعمل حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" أيضًا على تسجيل بعض الأحداث خصائص المستخدِمين: يمكنك استخدام الأحداث والخصائص المجمَّعة تلقائيًا في أداة "إدارة العلامات من Google" بدون الحاجة إلى إضافة أيّ رمز ومع ذلك، لا يمكنك حظرها.
3- إرسال الأحداث
متغيّرات اسم حدث Firebase ومتغيّرات مَعلمات أحداث Firebase وغيرها تُستخدم المتغيرات لإعداد المشغلات. يتم تقييم شروط التشغيل كلما سجّلت حدث Firebase. بشكلٍ تلقائي، تستخدم أداة "إحصاءات Google لبرنامج Firebase" يتم تنشيط الأحداث تلقائيًا. من الممكن إضافة حساب "إحصاءات Google لبرنامج Firebase" في "إدارة العلامات من Google" لحظر إرسال الأحداث إلى "إحصاءات Google".
4. معاينة الحاوية وتصحيح الأخطاء ونشرها
قبل نشر إصدار من حاويتك، ستحتاج إلى معاينته للتأكد التأكد من أنه يعمل على النحو المنشود. ويمنحك برنامج إدارة العلامات من Google إمكانية معاينة من حاويتك عن طريق إنشاء روابط ورموز استجابة سريعة في واجهة الويب واستخدامها لفتح التطبيق. يمكنك أيضًا تفعيل التسجيل المطوَّل لتصحيح أي سلوك غير متوقع.
معاينة الحاوية
قبل معاينة أيّ حاوية، أنشِئ عنوان URL للمعاينة في أداة "إدارة العلامات من Google". واجهة الويب من خلال تحديد إصدار الحاوية التي تريد معاينتها، ثم انقر على معاينة احفظ عنوان URL للمعاينة هذا للاطّلاع على الخطوات اللاحقة.
![تتوفّر معاينة عناوين URL في نافذة معاينة العلامة.
واجهة الويب للمدير](https://developers.google.cn/static/tag-platform/tag-manager/images/preview_example.png?authuser=8&hl=ar)
لمعاينة الحاوية (إذا كنت تستخدم "استوديو Android"، انتقِل إلى الخطوة 3):
إضافة نشاط المعاينة هذا إلى ملف
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>
غيِّر هذا السطر ليتضمن اسم حزمة التطبيق:
<data android:scheme="tagmanager.c.com.example.app"/>
في واجهة الويب لأداة "إدارة العلامات من Google"، أنشئ رابط معاينة:
- سجِّل الدخول إلى حسابك على إدارة العلامات من Google.
- اختَر حاوية للأجهزة الجوّالة.
- انقر على الإصدارات في شريط التنقل العلوي.
- انقر على الإجراءات > المعاينة في إصدار الحاوية الذي تريد معاينة.
- أدخِل اسم حزمة التطبيق.
- انقر على إنشاء رابط بدء المعاينة.
أوقِف التطبيق واستخدِم رابط المعاينة أو رمز الاستجابة السريعة الذي تم إنشاؤه من أجل إطلاق تطبيقك.
يمكنك الخروج من وضع المعاينة من خلال النقر على الرابط الذي يتم إنشاؤه بواسطة خيار إنشاء رابط إنهاء المعاينة في واجهة الويب
حاوية تصحيح الأخطاء
لتحديد مشاكل تنفيذ الحاوية وحلّها، فعِّل التسجيل المطوَّل:
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
نشر الحاوية
بعد معاينة حاويتك والتحقّق من أنّها تعمل، يمكنك: نشره. بعد نشر حاويتك، ستتغيّر إعدادات علامتك متاحة لمستخدمي تطبيق الأجهزة الجوّالة.
الخطوات التالية
تعرَّف على الإعدادات المتقدّمة.