Android v3 (الإصدار القديم) - نظرة عامة

يصف دليل المطوِّر هذا كيفية تنفيذ Google Tag Manager في تطبيق للأجهزة الجوّالة.

مقدمة

تتيح أداة Google Tag Manager للمطوّرين تغيير قيم الإعدادات في تطبيقاتهم للأجهزة الجوّالة باستخدام واجهة Google Tag Manager بدون الحاجة إلى إعادة إنشاء الملفات الثنائية للتطبيقات وإعادة إرسالها إلى أسواق التطبيقات.

هذا مفيد لإدارة أي قيم أو علامات ضبط في تطبيقك قد تحتاج إلى تغييرها في المستقبل، بما في ذلك:

  • إعدادات واجهة المستخدم المختلفة وسلاسل العرض
  • أحجام الإعلانات المعروضة في تطبيقك أو مواقعها أو أنواعها
  • إعدادات الألعاب

يمكن أيضًا تقييم قيم الإعدادات في وقت التشغيل باستخدام القواعد، ما يتيح الإعدادات الديناميكية مثل:

  • استخدام حجم الشاشة لتحديد حجم إعلان البانر
  • استخدام اللغة والموقع الجغرافي لضبط عناصر في واجهة المستخدم

تتيح أداة Google Tag Manager أيضًا التنفيذ الديناميكي لعلامات التتبُّع ووحدات البكسل في التطبيقات. ويمكن للمطوّرين إرسال الأحداث المهمة إلى طبقة بيانات وتحديد علامات التتبّع أو وحدات البكسل التي يجب تفعيلها لاحقًا. تتيح أداة TagManager استخدام العلامات التالية:

  • إحصاءات تطبيقات الأجهزة الجوّالة من Google
  • علامة استدعاء دالة مخصّصة

قبل البدء

قبل استخدام دليل البدء هذا، ستحتاج إلى ما يلي:

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

البدء

سيرشد هذا القسم المطوّرين خلال سير عمل Tag Manager المعتاد:

  1. إضافة حزمة تطوير البرامج (SDK) لأداة Google Tag Manager إلى مشروعك
  2. ضبط القيم التلقائية للحاوية
  3. فتح الحاوية
  4. الحصول على قيم الإعدادات من الحاوية
  5. إرسال الأحداث إلى DataLayer
  6. معاينة الحاوية ونشرها

1. إضافة حزمة تطوير البرامج (SDK) لأداة Google Tag Manager إلى مشروعك

قبل استخدام حزمة تطوير البرامج (SDK) لأداة "إدارة العلامات من Google"، عليك استخراج حزمة SDK وإضافة المكتبة إلى مسار الإصدار لمشروعك وإضافة الأذونات إلى ملف AndroidManifest.xml.

أولاً، أضِف مكتبة Google Tag Manager إلى المجلد /libs في مشروعك.

بعد ذلك، عدِّل ملف AndroidManifest.xml لاستخدام الأذونات التالية:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

2. إضافة ملف حاوية تلقائي إلى مشروعك

تستخدم أداة Google Tag Manager حاوية تلقائية عند تشغيل تطبيقك لأول مرة. سيتم استخدام الحاوية التلقائية إلى أن يتمكّن التطبيق من استرداد حاوية جديدة عبر الشبكة.

لتنزيل ملف ثنائي تلقائي للحاوية وإضافته إلى تطبيقك، اتّبِع الخطوات التالية:

  1. سجِّل الدخول إلى واجهة الويب في Google Tag Manager.
  2. اختَر إصدار الحاوية التي تريد تنزيلها.
  3. انقر على الزر تنزيل لاسترداد الملف الثنائي للحاوية.
  4. أضِف الملف الثنائي إلى المسار التالي: <project-root>/assets/tagmanager/

يجب أن يكون اسم الملف التلقائي هو رقم تعريف الحاوية (على سبيل المثال GTM-1234). بعد تنزيل الملف الثنائي، تأكَّد من إزالة لاحقة الإصدار من اسم الملف لضمان اتّباع اصطلاح التسمية الصحيح.

على الرغم من أنّه يُنصح باستخدام الملف الثنائي، إذا كانت الحاوية لا تحتوي على قواعد أو علامات، يمكنك اختيار استخدام ملف JSON بدلاً من ذلك. يجب أن يكون الملف في مجلد /assets/tagmanager جديد في مشروع Android الخاص بك، ويجب أن يتّبع اصطلاح التسمية التالي: <Container_ID>.json. على سبيل المثال، إذا كان رقم تعريف الحاوية هو GTM-1234، عليك إضافة قيم الحاوية التلقائية إلى /assets/tagmanager/GTM-1234.json.

3- فتح حاوية

قبل استرداد القيم من حاوية، يحتاج تطبيقك إلى فتح الحاوية. سيؤدي فتح حاوية إلى تحميلها من القرص (إذا كانت متاحة)، أو سيتم طلبها من الشبكة (إذا لزم الأمر).

أسهل طريقة لفتح حاوية على Android هي باستخدام ContainerOpener.openContainer(..., Notifier notifier)، كما في المثال التالي:

import com.google.tagmanager.Container;
import com.google.tagmanager.ContainerOpener;
import com.google.tagmanager.ContainerOpener.OpenType;
import com.google.tagmanager.TagManager;

import android.app.Activity;
import android.os.Bundle;

public class RacingGame {

  // Add your public container ID.
  private static final String CONTAINER_ID = "GTM-YYYY";

  volatile private Container mContainer;

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    TagManager mTagManager = TagManager.getInstance(this);

    // The container is returned to containerFuture when available.
    ContainerOpener.openContainer(
        mTagManager,                            // TagManager instance.
        CONTAINER_ID,                           // Tag Manager Container ID.
        OpenType.PREFER_NON_DEFAULT,            // Prefer not to get the default container, but stale is OK.
        null,                                   // Time to wait for saved container to load (ms). Default is 2000ms.
        new ContainerOpener.Notifier() {        // Called when container loads.
          @Override
          public void containerAvailable(Container container) {
            // Handle assignment in callback to avoid blocking main thread.
            mContainer = container;
          }
        }
    );
    // Rest of your onCreate code.
  }
}

في هذا المثال، يتم استخدام ContainerOpener.openContainer(..., Notifier notifier) لطلب حاوية محفوظة من مساحة التخزين المحلية. من خلال معالجة عملية تخصيص mContainer في دالة الاستدعاء containerAvailable، نضمن عدم حظر سلسلة التعليمات الرئيسية. إذا كانت الحاوية المحفوظة أقدم من 12 ساعة، سيؤدي الطلب أيضًا إلى جدولة طلب لاسترداد حاوية جديدة بشكل غير متزامن عبر الشبكة.

يمثّل نموذج التنفيذ هذا أبسط طريقة لفتح القيم واستردادها من حاوية باستخدام فئة ContainerOpener الملائمة. لمزيد من خيارات التنفيذ المتقدّمة، يُرجى الاطّلاع على الإعدادات المتقدّمة.

4. الحصول على قيم الإعدادات من الحاوية

بعد فتح الحاوية، يمكن استرداد قيم الإعدادات باستخدام طرق get<type>Value():

// Retrieving a configuration value from a Tag Manager Container.

// Get the configuration value by key.
String title = mContainer.getStringValue("title_string");

ستعرض الطلبات التي يتم إجراؤها باستخدام مفتاح غير موجود قيمة تلقائية مناسبة للنوع المطلوب:

// Empty keys will return a default value depending on the type requested.

// Key does not exist. An empty string is returned.
string subtitle = container.getStringValue("Non-existent-key");
subtitle.equals(""); // Evaluates to true.

5- إرسال القيم إلى DataLayer

‫DataLayer هي خريطة تتيح توفير معلومات وقت التشغيل عن تطبيقك، مثل أحداث اللمس أو مشاهدات الشاشة، لوحدات ماكرو "إدارة العلامات" والعلامات في حاوية.

على سبيل المثال، من خلال إرسال معلومات عن مشاهدات الصفحة في التطبيق إلى خريطة DataLayer، يمكنك إعداد علامات في واجهة الويب في Tag Manager لتنشيط وحدات بكسل تتبُّع الإحالات الناجحة وطلبات التتبُّع استجابةً لمشاهدات الصفحة في التطبيق بدون الحاجة إلى ترميزها في تطبيقك.

يتم إرسال الأحداث إلى DataLayer باستخدام push() والطريقة المساعدة DataLayer.mapOf():

//
// MainActivity.java
// Pushing an openScreen event with a screen name into the data layer.
//

import com.google.tagmanager.TagManager;
import com.google.tagmanager.DataLayer;

import android.app.Activity;
import android.os.Bundle;

public MainActivity extends Activity {

  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

  }

  // This screen becomes visible when Activity.onStart() is called.
  public void onStart() {
    super.onStart();

    // The container should have already been opened, otherwise events pushed to
    // the DataLayer will not fire tags in that container.
    DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();
    dataLayer.push(DataLayer.mapOf("event",
                                   "openScreen",      // The event type. This value should be used consistently for similar event types.
                                   "screenName",      // Writes a key "screenName" to the dataLayer map.
                                   "Home Screen")     // Writes a value "Home Screen" for the "screenName" key.
    );
  }
  // Rest of the Activity implementation
}

في واجهة الويب، يمكنك الآن إنشاء علامات (مثل علامات "إحصاءات Google") ليتم تشغيلها لكل مشاهدة شاشة من خلال إنشاء هذه القاعدة: يساوي "openScreen". لتمرير اسم الشاشة إلى إحدى هذه العلامات، أنشئ ماكرو طبقة بيانات يشير إلى مفتاح "screenName" في طبقة البيانات. يمكنك أيضًا إنشاء علامة (مثل بكسل تتبُّع الإحالات الناجحة في "إعلانات Google") ليتم تنشيطها فقط عند مشاهدة شاشات معيّنة، وذلك من خلال إنشاء قاعدة يكون فيها يساوي "openScreen" و يساوي "ConfirmationScreen".

6. معاينة حاوية ونشرها

ستتوافق قيم وحدات الماكرو دائمًا مع الإصدار المنشور الحالي. قبل نشر أحدث إصدار من حاوية، يمكنك معاينة حاويتك المسودّة.

لمعاينة حاوية، أنشئ عنوان URL للمعاينة في واجهة الويب في Google Tag Manager من خلال اختيار إصدار الحاوية الذي تريد معاينته، ثم اختيار Preview. احفظ عنوان URL الخاص بالمعاينة لأنّك ستحتاج إليه في الخطوات اللاحقة.

تتوفّر عناوين URL للمعاينة في نافذة المعاينة ضمن واجهة الويب في &quot;إدارة العلامات من Google&quot;
الشكل 1: الحصول على عنوان URL للمعاينة من واجهة الويب في &quot;إدارة العلامات من Google&quot;

بعد ذلك، أضِف النشاط التالي إلى ملف AndroidManifest.xml في تطبيقك:

<!-- Google Tag Manager Preview Activity -->
<activity
  android:name="com.google.tagmanager.PreviewActivity"
  android:label="@string/app_name"
  android:noHistory="true" >  <!-- Optional, removes the PreviewActivity from activity stack. -->
  <intent-filter>
    <data android:scheme="tagmanager.c.application_package_name" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE"/>
  </intent-filter>
</activity>
  

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

عندما تكون مستعدًا لإتاحة قيم الإعدادات في المسودة لتطبيقك، يمكنك نشر الحاوية.

إعدادات متقدّمة

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

خيارات متقدّمة لفتح الحاويات

توفّر حزمة تطوير البرامج (SDK) في Google Tag Manager عدة طرق لفتح الحاويات التي يمكن أن تمنحك مزيدًا من التحكّم في عملية التحميل:

TagManager.openContainer()

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

mContainer = tagManager.openContainer(CONTAINER_ID, new Container.Callback() {

  // Called when a refresh is about to begin for the given refresh type.
  @Override
  public void containerRefreshBegin(Container container, RefreshType refreshType) {
    // Notify UI that the Container refresh is beginning.
   }

  // Called when a successful refresh occurred for the given refresh type.
  @Override
  public void containerRefreshSuccess(Container container, RefreshType refreshType]) {
    // Notify UI that Container is ready.
  }

  // Called when a refresh failed for the given refresh type.
  @Override
  public void containerRefreshFailure(Container container,
                                      RefreshType refreshType,
                                      RefreshFailure refreshFailure) {
    // Notify UI that the Container refresh has failed.
  }

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

ما لم يكن من المقبول أن يستخدم تطبيقك القيم التلقائية، ستحتاج إلى استخدام عمليات الاستدعاء هذه لمعرفة وقت تحميل حاوية محفوظة أو حاوية شبكة. يُرجى العِلم أنّه لن تتمكّن من تحميل حاوية محفوظة أو حاوية شبكة إذا كانت هذه هي المرة الأولى التي يتم فيها تشغيل التطبيق ولم يكن هناك اتصال بالشبكة.

يمرّر TagManager.openContainer() قيم enum التالية كوسيطات إلى عمليات الاستدعاء هذه:

RefreshType

القيمةالوصف
Container.Callback.SAVED يؤدي طلب إعادة التحميل إلى تحميل حاوية محفوظة على الجهاز.
Container.Callback.NETWORK يؤدي طلب إعادة التحميل إلى تحميل حاوية عبر الشبكة.

RefreshFailure

القيمةالوصف
Container.Callback.NO_SAVED_CONTAINER لا تتوفّر حاوية محفوظة.
Container.Callback.IO_ERROR حدث خطأ في وحدات الإدخال والإخراج منع إعادة تحميل الحاوية.
Container.Callback.NO_NETWORK لا يتوفّر اتصال بالشبكة.
Container.Callback.NETWORK_ERROR حدث خطأ في الشبكة.
Container.Callback.SERVER_ERROR حدث خطأ في الخادم.
Container.Callback.UNKNOWN_ERROR حدث خطأ لا يمكن تصنيفه.

طُرق فتح الحاويات غير التلقائية والجديدة

يغلّف ContainerOpener TagManager.openContainer() ويوفّر طريقتَين مناسبتَين لفتح الحاويات: ContainerOpener.openContainer(..., Notifier notifier) وContainerOpener.openContainer(..., Long timeoutInMillis).

تتطلّب كل طريقة من هذه الطرق تعدادًا يطلب إما حاوية غير تلقائية أو حاوية جديدة.

يُنصح باستخدام OpenType.PREFER_NON_DEFAULT لمعظم التطبيقات، وهو يحاول عرض أول حاوية غير تلقائية متاحة خلال فترة مهلة معيّنة، سواء من القرص أو الشبكة، حتى إذا كان عمر هذه الحاوية أكبر من 12 ساعة. إذا عرضت حاوية محفوظة قديمة، ستُرسل أيضًا طلب شبكة غير متزامن للحصول على حاوية جديدة. عند استخدام OpenType.PREFER_NON_DEFAULT، سيتم عرض حاوية تلقائية في حال عدم توفّر أي حاوية أخرى أو في حال تجاوز مهلة الانتظار.

يحاول OpenType.PREFER_FRESH عرض حاوية جديدة من القرص أو الشبكة خلال فترة المهلة المحددة. وتعرض حاوية محفوظة في حال عدم توفّر اتصال بالشبكة و/أو تجاوز مهلة الانتظار.

لا ننصح باستخدام OpenType.PREFER_FRESH في المواضع التي قد يؤثر فيها طول وقت الطلب بشكل ملحوظ في تجربة المستخدم، مثل علامات واجهة المستخدم أو سلاسل العرض. يمكنك أيضًا استخدام Container.refresh() في أي وقت لفرض طلب حاوية الشبكة.

كلتا الطريقتين المريحتين غير محظورتين. يعرض ContainerOpener.openContainer(..., Long timeoutInMillis) عنصر ContainerOpener.ContainerFuture، ويعرض الإجراء get الخاص به Container فور تحميله (ولكن سيتم حظره حتى ذلك الحين). تتلقّى الطريقة ContainerOpener.openContainer(..., Notifier notifier) استدعاءً واحدًا، يتم استدعاؤه عندما تكون الحاوية متاحة، ويمكن استخدامه لمنع حظر سلسلة التعليمات الرئيسية. تتضمّن كلتا الطريقتَين مهلة تلقائية تبلغ 2000 مللي ثانية.

تقييم وحدات الماكرو في وقت التشغيل باستخدام القواعد

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

يتم استخدام قاعدة لاختيار سلاسل العرض استنادًا إلى لغة الجهاز في
            وقت التشغيل: اللغة تساوي الإسبانية. تستخدم هذه القاعدة ماكرو اللغة المحدّد مسبقًا ورمز لغة ISO 639-1 المكوّن من حرفَين.
الشكل 1:إضافة قاعدة لتفعيل ماكرو جمع القيم للأجهزة التي تم ضبطها لاستخدام اللغة الإسبانية فقط

يمكنك بعد ذلك إنشاء وحدات ماكرو لجمع القيم لكل لغة، وإضافة هذه القاعدة إلى كل وحدة ماكرو، مع إدراج رمز اللغة المناسب. عند نشر هذه الحاوية، سيتمكّن تطبيقك من عرض سلاسل العرض المترجَمة، وذلك حسب لغة جهاز المستخدم في وقت التشغيل.

يُرجى العِلم أنّه إذا كانت الحاوية التلقائية تحتاج إلى قواعد، يجب استخدام ملف حاوية ثنائي كحاوية تلقائية.

مزيد من المعلومات حول ضبط القواعد (مركز المساعدة)

ملفات الحاويات الثنائية التلقائية

يجب أن تستخدم الحاويات التلقائية التي تحتاج إلى قواعد ملف حاوية ثنائية بدلاً من ملف JSON كحاوية تلقائية. تتيح الحاويات الثنائية تحديد قيم وحدات الماكرو في وقت التشغيل باستخدام قواعد Google Tag Manager، بينما لا تتيح ملفات JSON ذلك.

يمكن تنزيل ملفات الحاويات الثنائية من واجهة الويب في Google Tag Manager ويجب إضافتها إلى مجلد /assets/tagmanager/ في مشروعك واتّباع هذا النمط: /assets/tagmanager/GTM-XXXX، حيث يمثّل اسم الملف رقم تعريف الحاوية.

في الحالات التي يتوفّر فيها ملف JSON وملف حاوية ثنائي، ستستخدم حزمة SDK ملف الحاوية الثنائي كحاوية تلقائية.

استخدام وحدات ماكرو لاستدعاء الدوال

وحدات ماكرو استدعاء الدوال هي وحدات ماكرو يتم ضبطها على القيمة المعروضة لدالة محدّدة في تطبيقك. يمكن استخدام وحدات ماكرو استدعاء الدوال لدمج قيم وقت التشغيل مع قواعد Google Tag Manager، مثل تحديد السعر الذي سيتم عرضه للمستخدم في وقت التشغيل استنادًا إلى اللغة والعملة اللتين تم ضبطهما على الجهاز.

لضبط ماكرو استدعاء دالة:

  1. حدِّد ماكرو استدعاء الدالة في واجهة ويب Google Tag Manager. يمكن ضبط الوسيطات اختياريًا كأزواج مفتاح/قيمة.
  2. سجِّل FunctionCallMacroHandler في تطبيقك باستخدام Container.registerFunctionCallMacroHandler() واسم الدالة الذي ضبطته في واجهة الويب في أداة "إدارة العلامات من Google"، مع إلغاء طريقة getValue():
    /**
     * Registers a function call macro handler.
     *
     * @param functionName The function name field, as defined in the Google Tag
     *     Manager web interface.
     */
    mContainer.registerFunctionCallMacroHandler(functionName, new FunctionCallMacroHandler() {
    
      /**
       * This code will execute when any custom macro's rule(s) evaluate to true.
       * The code should check the functionName and process accordingly.
       *
       * @param functionName Corresponds to the function name field defined
       *     in the Google Tag Manager web interface.
       * @param parameters An optional map of parameters
       *     as defined in the Google Tag Manager web interface.
       */
      @Override
      public Object getValue(String functionName, Map<String, Object> parameters)) {
    
        if (functionName.equals("myConfiguredFunctionName")) {
          // Process and return the calculated value of this macro accordingly.
          return macro_value
        }
        return null;
      }
    });

استخدام علامات استدعاء الدوال

تتيح علامات استدعاء الدوال تنفيذ الدوال المسجّلة مسبقًا عندما يتم إرسال حدث إلى طبقة البيانات وتقييم قواعد العلامة على أنّها true.

لضبط علامة استدعاء دالة:

  1. حدِّد علامة استدعاء الدالة في واجهة الويب في Google Tag Manager. يمكن ضبط الوسيطات اختياريًا كأزواج مفتاح/قيمة.
  2. سجِّل معالج علامات استدعاء الدوال في تطبيقك باستخدام Container.registerFunctionCallTagHandler():
    /**
     * Register a function call tag handler.
     *
     * @param functionName The function name, which corresponds to the function name field
     *     Google Tag Manager web interface.
     */
    mContainer.registerFunctionCallTagHandler(functionName, new FunctionCallTagHandler() {
    
      /**
       * This method will be called when any custom tag's rule(s) evaluates to true.
       * The code should check the functionName and process accordingly.
       *
       * @param functionName The functionName passed to the functionCallTagHandler.
       * @param parameters An optional map of parameters as defined in the Google
       *     Tag Manager web interface.
       */
      @Override
      public void execute(String functionName, Map<String, Object> parameters) {
        if (functionName.equals("myConfiguredFunctionName")) {
          // Process accordingly.
        }
      }
    });

ضبط فترة إعادة تحميل مخصّصة

ستحاول حزمة تطوير البرامج (SDK) في Google Tag Manager استرداد حاوية جديدة إذا تجاوز عمر الحاوية الحالية 12 ساعة. لضبط فترة مخصّصة لإعادة تحميل الحاوية، استخدِم Timer، كما في المثال التالي:

timer.scheduleTask(new TimerTask() {
  @Override
  public void run() {
    mContainer.refresh();
  }
}, delay, <new_period_in milliseconds>);

تصحيح الأخطاء باستخدام Logger

تطبع حزمة تطوير البرامج (SDK) لأداة Google Tag Manager الأخطاء والتحذيرات في السجلّات تلقائيًا. يمكن أن يكون تفعيل التسجيل المطوَّل مفيدًا لتصحيح الأخطاء، ويمكن إجراء ذلك من خلال تنفيذ Logger الخاص بك باستخدام TagManager.setLogger، كما في هذا المثال:

TagManager tagManager = TagManager.getInstance(this);
tagManager.setLogger(new Logger() {

  final String TAG = "myGtmLogger";

  // Log output with verbosity level of DEBUG.
  @Override
  public void d(String arg0) {
    Log.d(TAG, arg0);
  }

  // Log exceptions when provided.
  @Override
  public void d(String arg0, Throwable arg1) {
    Log.d(TAG, arg0);
    arg1.printStackTrace();
  }

  // Rest of the unimplemented Logger methods.

});

أو يمكنك ضبط LogLevel في Logger الحالي باستخدام TagManager.getLogger().setLogLevel(LogLevel) ، كما في هذا المثال:

// Change the LogLevel to INFO to enable logging at INFO and higher levels.
TagManager tagManager = TagManager.getInstance(this);
tagManager.getLogger().setLogLevel(LogLevel.INFO);