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

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

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

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

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

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

  1. أضِف حزمة "إدارة العلامات من Google":

    CocoaPods

    لإضافة أداة "إدارة العلامات من Google" من خلال CocoaPods:

    1. شغِّل الأمر التالي في وحدة طرفية:

      $ sudo gem install cocoapods
      
    2. انتقِل إلى دليل مشروعك.

    3. نفِّذ الأمر التالي لإنشاء ملف باسم Podfile:

      $ pod init
      
    4. في Podfile، أضِف ما يلي:

      pod 'GoogleTagManager', '~> 6.0'
      
    5. شغِّل الأمر التالي لتنزيل تبعيات إدارة العلامات وتثبيتها على مشروعك:

      $ pod install
      

    مدير حزم Swift

    لإضافة أداة "إدارة العلامات من Google" عبر أداة إدارة حزم Swift:

    1. في حال نقل البيانات من مشروع مستنِد إلى CocoaPods، عليك تنفيذ الإجراء pod deintegrate لإزالة CocoaPods من مشروع Xcode. ويمكن حذف ملف .xcworkspace الذي تم إنشاؤه من خلال CocoaPods بأمان بعد ذلك. في حال إضافة Firebase إلى مشروع للمرة الأولى، يمكن تجاهل هذه الخطوة.
    2. في Xcode 12، ثبِّت مكتبة "إدارة العلامات من Google" عن طريق الانتقال إلى ملف > حِزم إدارة العلامات > إضافة تبعية الحزمة...
    3. في المطالبة التي تظهر، أدخل مستودع GitHub في إدارة العلامات من Google:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. اختَر إصدار أداة "إدارة العلامات من Google" الذي تريد استخدامه. بالنسبة إلى المشاريع الجديدة، ننصحك باستخدام أحدث إصدار من أداة "إدارة العلامات من Google".

    5. أضِف -ObjC إلى علامات الرابط الأخرى في إعدادات الإصدار لمشروعك.

  2. أنشئ حاوية iOS إذا لم يكن حسابك على أداة "إدارة العلامات من Google" يحتوي على واحدة:

    1. سجِّل الدخول إلى حسابك على إدارة العلامات.
    2. انقر على المشرِف في شريط التنقّل العلوي.
    3. في عمود CONTAINER، انقر على القائمة المنسدلة واختر CONTAINER.
    4. أدخِل اسمًا للحاوية.
    5. اختَر حاوية iOS.
    6. اختَر حزمة تطوير البرامج (SDK) لنظام التشغيل Firebase (iOS).
    7. انقر على إنشاء.
  3. نزِّل الحاوية:

    1. سجِّل الدخول إلى حسابك على إدارة العلامات.
    2. اختَر حاوية iOS.
    3. انقر على الإصدارات في شريط التنقّل العلوي.
    4. انقر على الإجراءات > تنزيل في إصدار الحاوية المحدّد.

  4. أضف الحاوية التي تم تنزيلها إلى مشروعك:

    1. انسخ الملف الذي تم تنزيله إلى مجلد باسم container في جذر مشروع XCode (عادةً PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. افتح Xcode.
    3. من القائمة ملف، اختَر إضافة ملفات إلى....
    4. اختَر المجلد container.
    5. انقر على الخيارات وتأكّد من اختيار إنشاء مراجع للمجلد.
    6. انقر على إنهاء.

2. تسجيل الأحداث والمتغيرات

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

اطّلِع على مستندات مطوّري برامج Firebase للحصول على تعليمات عن كيفية تسجيل الأحداث وضبط خصائص المستخدمين.

ضبط المتغيّرات في أداة "إدارة العلامات من Google"

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

على سبيل المثال، يمكنك تسجيل الحدث المخصّص التالي في تطبيقك:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

بعد ذلك، يمكنك ضبط متغيّرات "مَعلمات الأحداث" الجديدة في أداة "إدارة العلامات من Google" كما يلي: لتسجيل قيمتَي image_name وfull_text parameter:

  • اسم المتغيّر: اسم الصورة
  • نوع المتغيّر: مَعلمة الحدث
  • اسم مفتاح معلمة الحدث: image_name

و:

  • اسم المتغيّر: نص كامل
  • نوع المتغيّر: مَعلمة الحدث
  • اسم مفتاح معلمة الحدث: full_text

وبالمثل، يمكنك إعداد خاصيّة المستخدِم التالية في تطبيقك:

Analytics.setUserProperty(food, forName: "favorite_food")

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

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

لمعاينة حاوية، أنشئ عنوان URL للمعاينة في واجهة الويب لأداة "إدارة العلامات من Google":

  1. سجِّل الدخول إلى حسابك على إدارة العلامات.
  2. اختَر حاوية للأجهزة الجوّالة.
  3. انقر على الإصدارات في شريط التنقّل العلوي.
  4. انقر على الإجراءات > معاينة في إصدار الحاوية الذي تريد معاينته.
  5. أدخِل اسم حزمة التطبيق.
  6. انقر على إنشاء رابط بدء المعاينة.

    تتوفّر معاينة عناوين URL في نافذة المعاينة على واجهة الويب لأداة "إدارة العلامات من Google".

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

    احفظ عنوان URL للمعاينة هذا للاطّلاع على الخطوات اللاحقة.

لتفعيل معاينات الحاويات، يجب تحديد مخطط عنوان URL لمعاينة أداة "إدارة العلامات من Google" في قائمة مواقع مشروعك. ضمن أنواع عناوين URL لملف قائمة المواقع التطبيقية، سجِّل معرِّف عنوان URL التالي ومخطط عنوان URL:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
سجِّل مخطط عنوان URL لمعاينة أداة "إدارة العلامات من Google" في ملف قائمة الخصائص لتطبيقك.
الشكل 2: إضافة مخطط عنوان URL لمعاينة أداة "إدارة العلامات من Google" إلى ملف قائمة المواقع في تطبيقك.

أوقِف تطبيقك وافتح عنوان URL للمعاينة على محاكي أو جهاز مادي لمعاينة حاوية المسودة في تطبيقك.

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

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

نشر الحاوية

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

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