إعداد منتجات 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

يحدِّد الأمر 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"

لمحة عن الأمر 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" onlick="newsletterSignup()">Sign me up!</button>
   ...
</body>

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

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

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

يكون الأمر بالتنسيق التالي:

gtag('set', 'parameterName');

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

بعد إعداد منتجات Google وأحداثها، تكون قد انتهيت من ضبط الإعدادات الأساسية لعلامة Google.

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