إعداد منتجات 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‏ 4" هي "علامات تتبُّع من 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‏ 4".

يوضّح المثال التالي كيفية تعديل الرمز لتحميل "علامة تتبُّع من 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‏ 4".

<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".

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