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

يمكن ضبط عمليات تثبيت علامة Google لتوجيه البيانات إلى مجموعات معيّنة من الحسابات أو المنتجات. يمكن إعداد حلول قياس كاملة لمنتجات القياس من 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>