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

ملاحظة: تم إيقاف الأمر gtag('config') نهائيًا. ننصحك بإدارة الوجهات وإعدادات العلامات في واجهة مستخدم Google Tag Manager (على سبيل المثال، من خلال إضافة علامة وجهة)، أو استخدام gtag('set') للمَعلمات في الصفحة. إذا كنت تستخدم gtag.js حاليًا وتستخدم أوامر gtag('config')، لن تحتاج إلى إعادة وضع العلامات على موقعك الإلكتروني. ستستمر الإعدادات في العمل كما هي اليوم.

أسباب إجراء هذا التغيير

تم تصميم أجزاء مختلفة من واجهة برمجة التطبيقات gtag API في وقت لم تكن فيه "علامة التتبُّع من Google" تحتوي على واجهة مستخدم، وكان يجب أن تأتي جميع الإعدادات كرمز برمجي مضّمن في الصفحة. وقد فرض ذلك عليك استخدام بيانات غير قابلة للتغيير في البرنامج لإعداداتك المفضّلة وقرارات توجيه البيانات مباشرةً على موقعك الإلكتروني، ما صعّب تغيير إعداداتك لاحقًا. يؤدي الترميز الثابت أيضًا إلى قفل هذه الإعدادات في نقطة معيّنة في دورة حياة الصفحة أو الحدث، ما يزيد من التعقيد ويؤدي إلى خطر حدوث حالات سباق.

بعد توحيد منصّتَي "علامة التتبُّع من Google" وGoogle Tag Manager، أصبحت كل علامة تتبُّع تتضمّن واجهة. لم يعُد عليك اتّخاذ قرارات الإعداد مسبقًا أو ترميزها بشكل غير قابل للتغيير في البرنامج على موقعك الإلكتروني.

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

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

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

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

ملاحظة: للحصول على نظرة عامة على جميع الأوامر المتاحة، يُرجى الرجوع إلى مرجع gtag.js.

قبل البدء

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

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

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

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

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

يحدّد رقم تعريف العلامة أو الحاوية حاوية Google Tag Manager أو إعدادات وجهة Google التي يتم تحميلها من خلال مقتطف علامة التتبُّع من Google. تستخدم عمليات التثبيت الجديدة رقم تعريف حاوية Google Tag Manager (GTM-) تلقائيًا، بينما تحدّد أرقام التعريف الخاصة بالوجهة منتجات Google الفردية. يقدّم الجدول التالي نظرة عامة على بادئات أرقام التعريف المتوافقة:

بادئة	نوع المعرّف	الوصف
GTM-XXXXXX	رقم تعريف حاوية Google Tag Manager (تلقائي)	رقم التعريف التلقائي لحاويات Google Tag Manager تتيح استخدام جميع علامات Google وعلامات الجهات الخارجية والعلامات المخصّصة.
G-XXXXXX	رقم تعريف خاص بالوجهة	يحدّد وجهة في "إحصاءات Google" (رقم تعريف القياس).
AW-XXXXXX	رقم تعريف خاص بالوجهة	يحدّد وجهة في "إعلانات Google" (رقم تعريف الإحالة الناجحة).
DC-XXXXXX	رقم تعريف خاص بالوجهة	يحدّد وجهة Floodlight (الرقم التعريفي للمعلن).
MC-XXXXXX	رقم تعريف خاص بالوجهة	يحدّد وجهة Google Merchant Center.
GT-XXXXXX	معرِّف "علامة التتبّع من Google"	تحدّد هذه السمة علامة تتبُّع من Google تم إنشاؤها في إصدارات سابقة.

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

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

الخطوة 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 مع رقم تعريف علامة.

ملاحظة مهمة: يجب استدعاء الأمر config مرة واحدة فقط لكل علامة تتبُّع من Google. يجب أن يستخدم كل طلب لاحق الأمر set.

مثال

تُرسِل علامة تتبُّع من 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.

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