بيانات المجموعة والمسار

يمكن ضبط عمليات تثبيت علامة Google (gtag.js) لتوجيه البيانات إلى مجموعات محدّدة من الحسابات أو المنتجات. يمكن ضبط حلول القياس الكاملة لمنتجات القياس من Google من داخل مجموعة الرموز نفسها. يوضِّح هذا الدليل كيفية ضبط علامة Google لإرسال البيانات إلى منتجات وحسابات وإعدادات معيّنة باستخدام المَعلمتَين send_to وgroups.

التوجيه التلقائي

تحتوي علامة Google على أمر config لمعالجة التوجيه. على سبيل المثال، عند تثبيت علامة Google باستخدام رقم تعريف علامة، يُرسِل المقتطف التالي البيانات إلى حسابك على "إحصاءات Google 4" أو حساباتك على "إعلانات Google" أو كليهما:

gtag('config', 'TAG_ID');

يمكنك إلغاء التوجيه المحدّد في علامة Google (أو أي تعليمات سابقة للتوجيه على الصفحة) عن طريق إضافة معلَمة send_to إلى أوامر event.

على سبيل المثال، يتم إرسال حدث sign_in التالي إلى موقع على "إحصاءات Google" باستخدام رقم تعريف الوجهة 'G-XXXXXX-2' فقط، بغض النظر عن الاستهدافات التي تم ضبطها مسبقًا على الصفحة.

gtag('event', 'sign_in', { 'send_to': 'G-XXXXXX-2' });

Groups

قد تحتاج أحيانًا إلى إرسال معلومات معيّنة إلى مجموعة من الحسابات أو المنتجات، وإرسال أجزاء أخرى من المعلومات إلى مجموعة حسابات أو منتجات أخرى. على سبيل المثال، يمكنك إرسال معلومات عن حملات تسويقية محدّدة إلى وكالتك الإعلانية، مع الاحتفاظ ببيانات أكثر اكتمالاً لمؤسستك. يمكن تنظيم هذه الوظيفة باستخدام groups.

يمكنك إنشاء مجموعة من الاستهدافات (مثل المنتجات والحسابات والمواقع) ثمّ توجيه الأحداث إلى تلك المجموعة.

ملاحظة: لا يمكن أن تحتوي أسماء المجموعات على شرطة.

في المثال التالي، تمت إضافة موقعَين في "إحصاءات Google" إلى مجموعة باسم group1. بعد ذلك، يتمّ توجيه حدث sign_in إلى السمتَين في تلك المجموعة.

gtag('config', 'G-XXXXXX-1', { 'groups': 'group1' });
gtag('config', 'G-XXXXXX-2', { 'groups': 'group1' });

// Routes to 'G-XXXXXX-1' and 'G-XXXXXX-2'
gtag('event', 'sign_in', { 'send_to': 'group1' });

المجموعة التلقائية

في حال عدم ضبط معلَمة send_to، يتم توجيه الأحداث إلى مجموعة الاستهداف default. تتضمن مجموعة default جميع المنتجات والحسابات من طلبات config على الصفحة التي تم تنفيذها قبل الحدث. حتى إذا لم يتم تحديد المَعلمة groups في أمر config، يتم تخصيص الهدف إلى مجموعة default.

// The following two lines are equivalent:
gtag('config', 'G-XXXXXX-1');
gtag('config', 'G-XXXXXX-1', { 'groups': 'default' });

يوضّح المثال التالي أنّه يتم إرسال الأحداث إلى مجموعة default، بغض النظر عمّا إذا تم تحديد السمة {'send_to : 'default'} أم لا.

// Configure a target
gtag('config', 'G-XXXXXX-1');

// Since send_to is not specified, this routes to the 'default' group which
// includes 'G-XXXXXX-1', as defined in config, above.
gtag('event', 'sign_in');

// By default, routes to the 'default' groups which includes
// 'G-XXXXXX-1', as defined in config, above.
gtag('event', 'generate_lead', { 'send_to': 'default' });

التوجيه إلى groups مخصّص

باستخدام groups، يمكنك تحديد أجزاء معينة من البيانات التي يجب توجيهها إلى مجموعة محددة من المعرّفات. يوضّح نموذج الرمز التالي كيفية توجيه بيانات أحداث sign_in إلى مجموعة مخصّصة اسمها agency.

// Configure a target
gtag('config', 'G-XXXXXX-1');
gtag('config', 'G-XXXXXX-3', { 'groups': 'agency' });
gtag('config', 'G-XXXXXX-9', { 'groups': 'agency' });

// Routes only to 'G-XXXXXX-3' and 'G-XXXXXX-9' since they
// are both in the 'agency' group
gtag('event', 'sign_in', { 'send_to': 'agency' });

مثال: ضبط "إعلانات Google" و"إحصاءات Google" وFloodlight معًا

يمكنك إنشاء إعدادات كاملة لكلّ من "إعلانات Google" و"إحصاءات Google" وFloodlight، وكل ذلك من داخل علامة Google نفسها. يوضح هذا المثال الشكل الذي قد تبدو عليه العلامة المجمّعة. هذا المثال:

• يُرسِل بيانات مشاهدة الصفحة على الويب إلى "إحصاءات Google".
• قياس الإحالات الناجحة في "إعلانات Google" وFloodlight
• يرسل معلومات عن عنصر تمت إضافته إلى سلة التسوق إلى "إحصاءات Google" و"إعلانات Google"

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID">
</script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  // Global configs
  gtag('config', 'TAG_ID');
  gtag('config', 'DC-ZZZZZZ');

  // Measure Google Ads conversions
  gtag('event', 'conversion', {
      'send_to': 'AW-YYYYYY/AbC-D_efG-h12_34-567',
      'value': 1.0,
      'currency': 'USD'
  });

  // Measure Floodlight conversions
  gtag('event', 'conversion', {
    'allow_custom_scripts': true,
    'send_to': 'DC-ZZZZZZ/actions/locat304+standard'
  });

  // Route ecommerce add_to_cart event to Google Ads and Analytics
  gtag('event', 'add_to_cart', {
    'send_to': [
      'G-XXXXXX-1',
      'AW-YYYYYY'
    ],
    'items': [
      'id': 'U1234',
      'ecomm_prodid': 'U1234',
      'name': 'Argyle Funky Winklepickers',
      'list': 'Search Results',
      'category': 'Footwear',
      'quantity': 1,
      'ecomm_totalvalue': 123.45,
      'price': 123.45
    ]
  });
</script>