إعداد منتجات Google وإرسال بيانات الأحداث

هذه الصفحة مخصّصة للمطوّرين الذين يحتاجون إلى ضبط "علامة التتبُّع من Google" باستخدام gtag.js. تتيح لك "علامة التتبُّع من Google" أيضًا تعديل بعض الإعدادات في واجهة المستخدِم، اطّلِع على مقالة ضبط إعدادات "علامة التتبُّع من Google".

بعد تثبيت "علامة التتبُّع من Google"، يمكنك استدعاء أوامر gtag() في أي مكان في الرمز بعد مقتطف "علامة التتبُّع من Google".

توضّح لك هذه الصفحة كيفية إجراء ما يلي:

  1. إنشاء تدفق بيانات بين موقعك الإلكتروني ومنتجات Google باستخدام الأمر config
  2. إرسال الأحداث إلى منتجات Google باستخدام الأمر event
  3. ضبط القيم التي يتم إرسالها مع كل حدث باستخدام الأمر set

قبل البدء

يفترض هذا الدليل أنّك أجريت ما يلي:

لإعداد تدفق البيانات، تحتاج إلى ما يلي:

  • الوصول إلى رمز الموقع الإلكتروني الذي ثبّتّ فيه "علامة التتبُّع من Google"
  • رقم تعريف علامة منتج Google الذي تريد ربطه بـ "علامة التتبُّع من Google"

ما هو رقم تعريف العلامة وأين يمكن العثور عليه؟ يحدّد رقم تعريف العلامة "علامة التتبُّع من Google". يمكن أن تشتمل علامة تتبُّع من Google واحدة على أرقام تعريف علامات متعددة. على سبيل المثال، إذا كنت تستخدم "إعلانات Google"، أصبح لعلامتك الآن رقمَا تعريف: رقم تعريف قديم (AW) ورقم تعريف "علامة التتبُّع من Google" (GT). شاشة تعرض علامة Google ضمن "إعلانات Google" مع رقمَي تعريف علامة يمكن استخدام رقمَي تعريف العلامة بالتبادل. يحتوي الجدول التالي على نظرة عامة على العلامات المتوافقة مع "علامة التتبُّع من Google".
بادئة نوع المعرّف الوصف
GT -XXXXXX علامة التتبُّع من Google تحصل كل "علامة تتبُّع من Google" تم إنشاؤها حديثًا على بادئة GT ومعرّف فريد.
G-XXXXXX علامة التتبُّع من Google (بادئة قديمة) علامات "إحصاءات Google" هي "علامات تتبُّع من Google" تتضمّن بادئة G ومعرّفًا فريدًا.
AW-XXXXXX علامة التتبُّع من Google (بادئة قديمة) علامات "إعلانات Google" هي "علامات تتبُّع من Google" تتضمّن بادئة AW ومعرّفًا فريدًا.
DC-XXXXXX علامة التتبُّع من Google (بادئة قديمة) علامات Google Floodlight هي "علامات تتبُّع من Google" تتضمّن بادئة DC ومعرّفًا فريدًا.
لا تتوافق علامات Universal Analytics (UA) مع "علامة التتبُّع من Google" (GT).

العثور على رقم تعريف علامتك:

الخطوة 1: ربط منتجات Google بعلامتك

استخدِم الأمر config لإنشاء تدفق بيانات إلى منتجات Google.

لمحة عن الأمر config

يحدّد الأمر config منتجات Google التي تريد إرسال بيانات الأحداث إليها. يتّخذ الأمر التنسيق التالي:

gtag('config', 'TAG_ID', {<additional_config_params>});

مَعلمات الضبط الإضافية

يمكنك تعديل أمر config وتوسيعه عن طريق تحديد مَعلمات في الـ اختياري {<additional_config_params>} عنصر. على سبيل المثال، سيؤدي إضافة المَعلمة التالية إلى منع إرسال مشاهدة صفحة في "إحصاءات Google" تلقائيًا:

gtag('config', 'TAG_ID', {'send_page_view': false});

إعداد جمع البيانات

لإعداد جمع البيانات لمنتج من Google، أضِف الأمر config مع رقم تعريف العلامة.

مثال

ترسل "علامة التتبُّع من Google" (GT-XXXXXX) البيانات إلى الوجهات التي حدّدتها لها، مثل "إعلانات Google" و"إحصاءات Google".

يوضّح المثال التالي كيفية تعديل الرمز لتحميل "علامة تتبُّع من Google" ثانية مرتبطة بوجهة Floodlight.

لإرسال البيانات إلى Floodlight (رقم تعريف العلامة DC-ZZZZZZ)، أضِف أمر config آخر بعد تهيئة "علامة التتبُّع من Google" الأولى (رقم تعريف العلامة GT-XXXXXX):

<head>
 ...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'GT-XXXXXX');
  gtag('config', 'DC-ZZZZZZ');
</script>
</head>

سلوك الأمر config الخاص بالمنتج

اعتمادًا على المنتج المحدّد في TAG_ID، قد يبدأ الأمر config أيضًا سلوكًا معيّنًا لهذا المنتج. على سبيل المثال، في بعض الحالات، يطلب الأمر config من gtag.js بدء حدث مشاهدة صفحة.

لمزيد من المعلومات عن سلوك الأمر config بالنسبة إلى المنتجات الفردية، اطّلِع على المستندات الخاصة بالمنتج:

الخطوة 2: إرسال البيانات باستخدام event

بعد ضبط عمليات الربط بمنتجات Google، عليك استخدام الأمر event لإرسال البيانات.

لمحة عن الأمر event

يتيح لك الأمر event إرسال بيانات الأحداث إلى المنتجات التي حدّدتها باستخدام config. يتّخذ الأمر التنسيق التالي:

gtag('event', 'event_name', {
  'key': 'value',
});

لمحة عن أسماء الأحداث وأزواج القيم الرئيسية

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

الأحداث المخصَّصة: لتحديد الأحداث وهياكل البيانات الخاصة بك، يمكنك إدخال قيم مخصّصة لإرسال حدث مخصّص.

إعداد الأحداث

يمكنك استدعاء طريقة event في أي مكان في الرمز بعد تهيئة "علامة التتبُّع من Google".

  1. حدِّد حدثًا. إذا كنت تستخدم حدثًا مُقترَحًا، تأكَّد من استخدام أسماء الأحداث الموحّدة و أزواج القيم الرئيسية المحدّدة مسبقًا.

  2. حدِّد متى سيتم تفعيل الحدث، على سبيل المثال، إذا تم إرساله عند تحميل الصفحة أو عندما ينقر مستخدم على زر.

مثال

يوضّح المثال التالي إحدى الطرق الممكنة لقياس عمليات الاشتراك في النشرة الإخبارية عندما ينقر مستخدم على زر. يستخدم المثال حدثًا مخصّصًا ويرسله إلى موقع على "إحصاءات Google".

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <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());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

اختياري: إرسال البيانات مع كل حدث باستخدام set

يتيح لك الأمر set تحديد المَعلمات التي سيتم ربطها بكل حدث لاحق على الصفحة.

على سبيل المثال، يمكنك مشاركة مَعلمات الحملة حتى تتمكّن علامات متعدّدة على الصفحة نفسها من الوصول إليها.

يتّخذ الأمر التنسيق التالي:

gtag('set', 'parameterName');

الخطوة 3: التحقّق من إعداداتك

للتأكّد من إرسال بيانات الأحداث بشكلٍ سليم:

  1. افتح منتج Google الذي تتوقّع ظهور البيانات فيه.
  2. تحقَّق مما إذا كانت البيانات تصل. يحتوي كل منتج على مكان مختلف يمكنك فيه التحقّق مما إذا كان يتم تلقّي البيانات:

الخطوات التالية

بعد إعداد منتجات Google والأحداث، تكون قد انتهيت من الإعداد الأساسي لـ "علامة التتبُّع من Google".

إذا كنت تدير منتجات متعدّدة وتريد إدارة تدفق بياناتها بمزيد من التفصيل ، اطّلِع على مقالة تجميع البيانات وتوجيهها.