Thanks for previewing Google's new tag platform documentation! This site is in public beta. (Feedback)

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

قبل البدء:

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

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

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

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.2'
    }
    
  2. سجّل الدخول إلى حسابك على إدارة العلامات.

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

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

  5. انقر على الإجراءات &gt؛ تنزيل على إصدار الحاوية المحدد.

    تنزيل حاوية

  6. أنشِئ المجلد 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);

وبعد ذلك، يمكنك ضبط متغيّرات معلّمات الأحداث الجديدة في "إدارة العلامات" على النحو التالي لالتقاط قيم 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 للمعاينة هذا للاطّلاع على الخطوات اللاحقة.

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

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

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

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

نشر الحاوية

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

الخطوات اللاحقة

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