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

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

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

توضّح لك هذه الصفحة كيفية تنفيذ ما يلي:

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

قبل البدء

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

• التعرّف على آلية عمل علامة التتبُّع من Google
• تثبيت علامة التتبُّع من Google

لإعداد تدفّق البيانات، عليك استيفاء الشروط التالية:

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

ما هو رقم تعريف العلامة وأين يمكن العثور عليه؟

يحدّد رقم تعريف العلامة "علامة تتبُّع من Google". يمكن أن تشتمل علامة Google واحدة على أرقام تعريف علامات متعددة. على سبيل المثال، إذا كنت تستخدم "إعلانات Google"، تتضمّن علامتك الآن رقمَي تعريف: رقم تعريف قديم (AW) ومعرِّف علامة التتبُّع من Google (GT). يمكن استخدام معرّفات العلامات بالتبادل. يتضمّن الجدول التالي نظرة عامة على العلامات المتوافقة مع علامة التتبُّع من Google.

بادئة	نوع المعرّف	الوصف
GT-XXXXXX	علامة التتبُّع من Google	تحصل كلّ علامة تتبُّع من Google تمّ إنشاؤها حديثًا على البادئة GT ومعرّف فريد.
‫G-XXXXXX	علامة التتبُّع من Google (البادئة القديمة)	علامات "إحصاءات Google" هي علامات تتبُّع من Google تبدأ بالبادئة G ورقم تعريف فريد.
AW-XXXXXX	علامة تتبُّع من Google (البادئة القديمة)	علامات تتبُّع "إعلانات Google" هي علامات تتبُّع من Google تتضمّن البادئة AW ورقم تعريف فريدًا.
DC-XXXXXX	علامة تتبُّع من Google (البادئة القديمة)	علامات Floodlight من Google هي علامات تتبُّع من Google تتضمّن البادئة DC ومعرّفًا فريدًا.

لا تتوافق علامات Universal Analytics ‏ (UA) مع علامة تتبُّع من Google ‏ (GT).

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

• إعلانات Google
• إحصاءات Google
• Google Floodlight

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

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

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

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

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

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 في ما يتعلق بالمنتجات الفردية، يُرجى قراءة المستندات الخاصة بالمنتج:

• الإحالات الناجحة في "إعلانات Google" وتجديد النشاط التسويقي
• "مدير الحملة" و"مساحة العرض والفيديو 360"
• إعلانات شبكة البحث 360
• إحصاءات Google

الخطوة 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": اطّلِع على جدول إجراءات الإحالات الناجحة وانظر إلى عمود الحالة (قد يستغرق تعديل الحالة مدة تصل إلى 24 ساعة).
   • ‫Floodlight: استخدِم Tag Assistant للتأكّد من تنشيط علامات Floodlight.

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

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

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