إدارة العلامات

صف متاح للجميع TagManager

هذه هي عملية تنفيذ برنامج "إدارة العلامات من Google" (GTM) على الأجهزة الجوّالة. نموذج الاستخدام: 

 Container container = TagManager.getInstance(context).openContainer(myContainerId);
 String value = container.getString("myKey");

 DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
 dataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", "Main Page"));
الحاوية هي مجموعة من وحدات الماكرو والعلامات والقواعد. يتم إنشاؤها ضمن تطبيق "إدارة العلامات من Google"، ويتم تخصيص رقم تعريف حاوية لها. إنّ رقم تعريف الحاوية هذا هو الرقم التعريفي المستخدم ضمن واجهة برمجة التطبيقات هذه.

توفر الفئة Container طرقًا لاسترداد القيم المحددة بمفتاح. تعرض سلاسل الإجراءات getBoolean(String) وgetDouble(String) وgetLong(String) وgetString(String) القيمة الحالية لمفتاح ماكرو جمع القيم، بناءً على القواعد المرتبطة بالحاوية.

على سبيل المثال، إذا كانت حاويتك تحتوي على ماكرو جمع القيم يحتوي على مفتاح speed وتكون قيمته 32، وقاعدة التفعيل هي Language، وماكرو آخر لجمع القيم يحتوي على مفتاح speed وتكون قيمته 45 وقاعدة التفعيل هي Language ليست "en"، عند إجراء الطلب التالي: 

 container.getLong("speed")
سيعرض الإجراء 32 إذا كانت اللغة الحالية للجهاز هي الإنجليزية، أو 45.

طبقة البيانات هي خريطة تحتوي على معلومات عامة حول التطبيق. توفر الفئة DataLayer طرقًا لدفع البيانات واستردادها من طبقة البيانات. سيؤدّي دفع مفتاح event إلى طبقة البيانات إلى تنشيط العلامات التي تتطابق مع هذا الحدث.

يتم إرفاق إصدار أولي من الحاوية مع التطبيق. ويجب وضع هذه السمة كمادة عرض مع إدراج name Manager/containerId حيث يكون containerId معرّف الحاوية نفسه الذي ستستخدمه ضمن واجهة برمجة التطبيقات هذه. عند استدعاء openContainer(String, Container.Callback)، سيتم عرض الحاوية مع هذه القواعد/وحدات الماكرو المجمّعة. ستنشئ الحاوية في واجهة المستخدِم وستستخدِم الزرّ "تنزيل" لتنزيلها.

يمكنك تعديل الحاوية في واجهة المستخدِم ونشر إصدار جديد. في هذه الحالة، عندما يحدّث التطبيق المتوافق مع الأجهزة الجوّالة الحاوية من الشبكة (كل 12 ساعة حاليًا)، سيحصل على الإصدار الجديد. عند الاتصال بإحدى سلاسل إجراءات get...، سيتم احتساب القيمة باستخدام أحدث القواعد.

يتم حفظ الحاوية التي تم تنزيلها على الجهاز. عند استدعاء openContainer(String, Container.Callback)، ستحمِّل أولاً الحاوية التلقائية، ثم ستحمِّل أي حاوية محفوظة بشكل غير متزامن. وإذا لم يتم العثور على أي تشفير، أو إذا كان أقدم من 12 ساعة، سيحاول استرداد إصدار أحدث من الشبكة. يمكنك العثور على حالة عمليات التحميل غير المتزامنة من خلال تمرير Container.Callback إلى openContainer(String, Container.Callback).

في بعض الأحيان، قد تحتاج إلى حظر المحتوى إلى أن تتوفر إما حاوية غير تلقائية أو إلى أن تتوفر حاوية جديدة حديثة. ContainerOpener هي فئة برامج مساعدة يمكنها تقديم المساعدة.

عند الانتهاء من استخدام حاوية، يمكنك استدعاء close().

ملخص الفئة المدمَجة

واحدة TagManager.Logger واجهة بسيطة للأخطاء/التحذير/المعلومات/تصحيح الأخطاء/التسجيل المطوَّل. 
تعداد TagManager.RefreshMode وضع إعادة تحميل الحاوية

ملخّص الطريقة العلنية

الحاوية
getContainer(سلسلة containerId)
السياق
getContext()
DataLayer
getDataLayer()
ثابتة TagManager
getInstance(سياق سياق)
أداة التسجيل
getLogger()
TagManager.RefreshMode
getRefreshMode()
الحاوية
openContainer(سلسلة containerId، Container.Callback callback)
void
setLogger(Logger logger)
void
setRefreshMode(TagManager.RefreshMode mode)

الطرق العامة

public حاوية getContainer (سلسلة containerId)

تعرض الحاوية المفتوحة المرتبطة بالسمة containerId، وتعرض null إذا لم تكن الحاوية مفتوحة حاليًا.

public السياق getContext ()

لعرض السياق المحفوظ المرتبط بهذا الكائن.

public DataLayer getDataLayer ()

تعرض كائن طبقة البيانات الذي يستخدمه مدير العلامات.

عامة ثابتة TagManager getInstance (السياق السياق)

يمكنك الحصول على مثيل فردي لفئة TagManager، وإنشاءه إذا لزم الأمر.

public Logger getLogger ()

تعرض أداة تسجيل النطاقات التي تستخدمها أداة "إدارة العلامات من Google".

متاح للجميع TagManager.RefreshMode getRefreshMode ()

لعرض وضع إعادة التحميل المستخدَم لجميع الحاويات.

عامة الحاوية openContainer (السلسلة containerId، Container.Callback containerId)

لعرض حاوية. وسيتم استدعاء معاودة الاتصال عند حدوث أشياء مختلفة للحاوية. على الأقل، ستحاول openContainer تحميل إصدار محفوظ من الحاوية. في حال عدم توفّر نسخة محفوظة، أو إذا كانت النسخة المحفوظة قديمة، ستتم محاولة التحميل من الشبكة.

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

إذا اتصلت بـ openContainer في المرة الثانية لعنصر containerId محدَّد، سيتم تطبيق استثناء.

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

عامة إلغاء setLogger (أداة تسجيل الدخول logger)

تحلّ محلّ المسجِّل الحالي الذي تستخدمه أداة "إدارة العلامات من Google".

متاح للجميع إلغاء setRefreshMode (TagManager.RefreshMode الوضع)

تحدِّد هذه السياسة وضع إعادة التحميل المستخدَم في جميع الحاويات.