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

حصة علنية 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 هي "en"؛ ومجموعة قيم أخرى ماكرو مع مفتاح speed بقيمة 45، وقاعدة التفعيل هي Language ليس "en"، لذا يجري الاتصال التالي: 

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

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

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

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

يتم حفظ الحاوية التي تم تنزيلها على الجهاز. عند الاتصال بـ 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)
فراغ
setLogger(أداة تسجيل المسجّلة)
فراغ
setRefreshMode(TagManager.RefreshMode وضع)

الطرق العامة

علنية حاوية getContainer (سلسلة containerId)

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

علنية السياق getContext ()

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

علنية DataLayer getDataLayer ()

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

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

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

علنية المسجّل getLogger ()

تعرض أداة التسجيل المسجّلة في أداة "إدارة العلامات من Google".

علنية TagManager.RefreshMode getRefreshMode ()

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

علنية حاوية openContainer (سلسلة containerId, Container.Callback containerId)

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

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

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

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

علنية فراغ setLogger (المسجّل أداة التسجيل)

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

علنية فراغ setRefreshMode (TagManager.RefreshMode )

يضبط هذا الإعداد وضع إعادة التحميل المُستخدَم لجميع الحاويات.