دمج علامة Google في نظام إدارة المحتوى (CMS) أو أداة إنشاء المواقع الإلكترونية

علامة Google (gtag.js) هي مقتطف من الرمز يمكن إضافته إلى موقع إلكتروني لقياس نشاط المستخدم على مستوى مجموعة متنوعة من منتجات Google، بما في ذلك "إحصاءات Google 4" و"إعلانات Google" و"منصة Google للتسويق". اطّلِع على مزيد من المعلومات عن علامة Google.

يوضِّح هذا الدليل كيفية دمج علامة Google في "نظام إدارة المحتوى" (CMS) أو أداة إنشاء المواقع الإلكترونية لتزويد المستخدمين النهائيين بإمكانية الوصول إلى منتجات القياس من Google.

الجمهور

هذا الدليل مخصّص لمالكي نظام إدارة المحتوى أو أدوات إنشاء المواقع الإلكترونية الذين يريدون تقديم عملية دمج مع منتجات القياس من Google لمستخدميهم. وهذا الدليل غير مخصَّص لمستخدمي نظام إدارة المحتوى (CMS) أو أداة إنشاء المواقع الإلكترونية.

قبل البدء

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

ملاحظة: لا يكون معرّفات المطوّرين مطلوبة إلا عند إنشاء عملية تنفيذ سيتم استخدامها في مواقع إلكترونية متعددة من قِبل شركات أو كيانات غير ذات صلة. إذا كان الموقع الإلكتروني أو كيان واحد يستخدم عملية التنفيذ، يُرجى عدم تقديم طلب للحصول على رقم تعريف مطوِّر.

نظرة عامة

لدمج المنصّة مع منتجات Google، يُرجى اتّباع الخطوات التالية:

1. إنشاء عملية دمج مع علامة Google
2. تعديل بنية إدخال المستخدم
3. تنفيذ Consent API
4. إعداد بيانات الأحداث
5. التحقّق من عملية الدمج المعدَّلة
6. تعديل تعليمات النشر للمستخدمين

إنشاء عملية دمج مع علامة Google

من خلال إجراء عملية دمج مع علامة Google، يمكن لعملائك نشر منتجات القياس من Google (من خلال gtag.js) على كل صفحة من صفحات موقعهم الإلكتروني. احرص على إزالة أيّ عمليات دمج لعلامات قديمة حالية (على سبيل المثال، analytics.js) قبل إنشاء عملية دمج باستخدام gtag.js.

لإجراء عملية دمج مع علامة Google، استبدِل مقتطف الرمز الحالي بالمقتطف التالي. تأكّد من إمكانية استبدال المستخدمين TAG_ID برقم تعريف العلامة الخاص بهم.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID

  gtag('config', 'GOOGLE_TAG_ID');
</script>

لاحظ ما يلي:

• يمكن للمعلنين إيقاف ميزات تخصيص الإعلانات، مثل تجديد النشاط التسويقي باستخدام مَعلمة allow_ad_personalization_signals (راجِع إيقاف جمع بيانات الإعلانات المخصّصة.
• من المفترض أن يظهر مقتطف علامة Google مرة واحدة فقط لكل صفحة. ويمكن للمقتطف استيعاب أرقام تعريف علامات متعددة. في حال توفّر مثيل حالي من gtag.js، عليك إضافة أرقام تعريف علامات جديدة إلى العلامة الحالية. مزيد من المعلومات

تعديل بنية إدخال المستخدم

يجب أن يتمكّن عملاؤك من توفير نماذج متعدّدة من رقم تعريف علامة Google من خلال واجهة واحدة، بغضّ النظر عن منتج القياس من Google الذي ينشرونه.

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

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

يجب أن يقبل إدخال رقم تعريف العلامة صيغ رقم تعريف متعددة تستخدم نمط التعبير العادي [A-Z]{1,3}\w{5,}[\w]*

تنفيذ Consent API (المعروفة أيضًا باسم "وضع الموافقة")

تحتوي علامة Google على Consent API مدمجة لإدارة موافقة المستخدِم. يمكن أن تساعدك هذه الميزة في التفريق بين موافقة المستخدِم على ملفات تعريف الارتباط المخصّصة لأغراض إعلانية وتلك المرتبطة بالإحصاءات.

النتيجة المتوقعة هي أن يتلقّى العملاء مكالمة gtag('consent', 'update' {...}) على الأقل بدون أن يتّخذ العميل أي إجراء. يجب أن يضمن ذلك أن علامات Google ("إعلانات Google" وFloodlight و"إحصاءات Google" و"رابط الإحالة الناجحة") قادرة على قراءة آخر حالة موافقة المستخدم وتضمين الحالة في طلبات الشبكة إلى Google (عبر المَعلمة &gcs).

ستتمثل خطوات التنفيذ الإضافية في نشر حالة gtag('consent', default' {...}) (من خلال واجهة المستخدم مثلاً) وإزالة حظر علامات Google (أي عدم تنشيطها بشروط بناءً على الموافقة) لتفعيل وضع الموافقة لتنشيطها بطريقة حسب الموافقة.

للحصول على تفاصيل التنفيذ، اطّلِع على المقالة إدارة إعدادات الموافقة (على الويب).

إعداد بيانات الأحداث

عليك إرسال بيانات وافية عن الأحداث من الموقع الإلكتروني للعميل إلى حسابه على Google بدون اتّخاذ أي إجراء من جانب العميل. على سبيل المثال، يمكنك إضافة الأحداث على طول مسار الإحالة الناجحة للشراء (أي "add_to_cart" و"begin_checkout" و"add_payment_info" و"add_shipping_info" و"purchase") وإنشاء قوائم العملاء المحتملين والاشتراكات

في ما يلي أفضل الممارسات لإضافة الأحداث:

• تسجيل كل شيء ممكن
• إعداد ما لا يقل عن 8 أحداث أساسية
• تحديد أولويات أحداث التجارة الإلكترونية

تسجيل كل شيء ممكن

وعند الإمكان، عليك إعداد الأحداث تلقائيًا. ويشمل ذلك ما يلي:

• أحداث الإحالات الناجحة مثل purchase أو sign_up
• الأحداث قبل أحداث الإحالات الناجحة مثل add_to_cart
• تُعد التفاعلات السلوكية مثل التفاعلات مع الوسائط التي تساعد العملاء على فهم كيفية تفاعلهم مع المستخدمين النهائيين

عليك إضافة مقتطفات عن أحداث الإحالات الناجحة إلى صفحات الإحالات الناجحة فقط (على سبيل المثال، تأكيد الشراء، وتأكيد إرسال النموذج). تجدر الإشارة إلى أنّه عليك إضافة علامة Google في كلّ صفحة من موقعك الإلكتروني.

يتمّ إرسال الأحداث باستخدام الأمر event. ويتضمّن ذلك رقم تعريف مطوِّر علامة Google نفسه الذي أدرَجته في علامة الموقع الشاملة الموضّحة أعلاه:

gtag('event', 'my_event', {
  'developer_id.<developer ID>': true,
  // Additional event parameters
});

على سبيل المثال، يمكنك استخدام الأمر event لإرسال حدث login مع تضمين القيمة method في "Google":

gtag('event', 'login', {
  'developer_id.<developer ID>': true,
  'method': 'Google'
});

<!-- Event snippet for sales conversion page -->
<script>
  gtag('event', 'conversion', {
      'developer_id.<developer ID>': true,
      'value': <value>,
      'currency': '<currency>',
      'transaction_id': '<transaction_id>'
  });
</script>

لاحظ ما يلي:

• إنّ معرّف المطوّر <developer ID> هو معرّف فريد وخاص بالنظام الأساسي الذي تستخدمه. أرفِق رقم التعريف بكل حدث.
• المَعلمات التالية اختيارية ويمكن حذفها:
  • 'value' هي القيمة الرقمية للإحالة الناجحة (على سبيل المثال، سعر الشراء)
  • 'currency' هو رمز عملة مكوَّن من ثلاثة أحرف، وهو مفيد للمعلنين الذين يقبلون عملات متعدّدة.
  • 'transaction_id' هو معرّف فريد خاص بالمعاملة (مثلاً مُعرّف الطلب) ويُستخدم لأغراض إزالة التكرار.
• على الرغم من أنّ بعض المَعلمات اختيارية، ننصح بتضمين أكبر قدر ممكن من المعلومات لكلّ حدث.
  • توفّر المَعلمات معلومات إضافية حول الطرق التي يتفاعل بها المستخدِمون مع موقعك الإلكتروني أو تطبيقك. على سبيل المثال، عندما يشاهد أحد الأشخاص منتجًا تبيعه، يمكنك تضمين مَعلمات تصف المنتج الذي شاهده، مثل اسمه وفئته وسعره.
  • تُعبئ بعض المَعلمات تلقائيًا السمات والمقاييس المنشأة مسبقًا في "إحصاءات Google" وتمنح المستخدمين فهمًا أفضل لعملائهم.

إذا كنت تريد قياس حدث إحالة ناجحة استنادًا إلى نقرة (مثل نقرة على زر أو استجابة ديناميكية لموقع إلكتروني يستخدم AJAX)، يمكنك أيضًا استخدام المقتطف التالي:

<!-- Event snippet for sales conversion page
    In your HTML page, add the snippet and call gtag_report_conversion
    when someone clicks on the chosen link or button. -->
<script>
  function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
    'developer_id.<developer ID>': true,
    'value': <value>,
    'currency': '<currency>',
    'transaction_id': '<transaction_id>',
    'event_callback': callback
  });
  return false;
}
</script>

إعداد ما لا يقل عن 8 أحداث أساسية

ننصحك بإعداد مجموعة أساسية من الأحداث التي تمثّل القيمة الأكبر لمالكي المواقع الإلكترونية. ننصحك بإعداد الأحداث التالية على الأقل:

• view_item_list: عندما يطّلع أحد المستخدمين على قائمة بالسلع (مثل قائمة المنتجات). مزيد من المعلومات

  gtag('event', 'view_item_list', {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Item",
      currency: "USD",
      discount: 2.22,
      price: 99.9,
      quantity: 1
    }]
  });
  

• add_to_cart: عندما يضيف المستخدم منتجًا واحدًا أو أكثر إلى سلة التسوّق. مزيد من المعلومات

  gtag('event', 'add_to_cart', {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: ‘USD’,
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• begin_checkout: عندما يبدأ المستخدم عملية الدفع لمنتج واحد أو أكثر. مزيد من المعلومات

  gtag('event', 'begin_checkout') {
    value: 99.0,
    currency: "USD",
    items: [{
      item_id: "SKU_123",
      item_name: "Test Product",
      price: 99.0,
      currency: ‘USD’,
      quantity: 1,
      item_category: "All Products"
    }]
  });
  

• purchase: عندما يشتري المستخدم منتجًا أو خدمة واحدة أو أكثر. مزيد من المعلومات

  gtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
  

• sign_up: عندما يشترك المستخدم حتى يتمكّن من الاطّلاع على طرق الاشتراك الأكثر شيوعًا (على سبيل المثال، حساب Google أو عنوان البريد الإلكتروني). مزيد من المعلومات

  gtag('event', 'sign_up', {method: 'web'});
  

• generate_lead: عندما يرسل المستخدم نموذجًا مزيد من المعلومات

  gtag('event', 'generate_lead', {value: XX, currency: 'USD'});
  

• subscribe: عندما يشترك المستخدم في خدمة أو نشرة إخبارية.

  gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});
  

• book_appointment: عندما يحجز مستخدم موعدًا

  gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
  

اقتراحات إضافية

يتيح محرّك بحث Google استخدام العديد من الأحداث والمَعلمات، لا سيما التجارة الإلكترونية. بوجهٍ عام، ننصحك بحفظ ما يلي:

• أي حدث ناجح مرتبط مباشرةً بالقيمة
• أحداث النجاح التي تساهم في الإحالات الناجحة الأساسية (add_to_cart وsign_up وغير ذلك)
• تساعد التفاعلات وتفاعلات المستخدمين التي تساعد المعلِنين على فهم كيفية تفاعلهم مع المستخدمين النهائيين.

في ما يلي مراجع إضافية توضِّح بشكل أكبر عملية جمع الفعاليات:

• الأحداث
• الأحداث المُقترَحة حسب حالة الاستخدام
• قياس التجارة الإلكترونية لمواقع "إحصاءات Google 4"

نحن مهتمون بمناقشة الإضافات المحتملة لهذا المخطط، لذا يُرجى إعلامنا إذا كانت لديك اقتراحات.

التحقّق من عملية الدمج المعدَّلة

قبل إرسال التغييرات إلى مرحلة الإنتاج، تأكَّد من توافقها مع ما يلي:

• علامة Google مع وجهة "إحصاءات Google 4"
• علامة Google لتجديد النشاط التسويقي وقياس الإحالات الناجحة

بالإضافة إلى ذلك، تأكّد من أنّه يتم تنشيط العلامة بشكلٍ سليم على جميع الصفحات، بما في ذلك صفحات الإحالات الناجحة، باستخدام أيّ من الأدوات التالية:

• Google Tag Assistant: تتيح لك Tag Assistant إمكانية معرفة علامات Google التي تم تنشيطها والترتيب الذي تم تنشيطه. Tag Assistant يعرض وضع تصحيح الأخطاء في مساعد Google البيانات التي يتم تمريرها إلى طبقة البيانات، والأحداث التي أدت إلى عمليات تبادل البيانات هذه.
• أدوات مطوّري برامج Chrome: استخدِم علامة التبويب الشبكة لفلترة الطلبات التي تحتوي على "google" للتحقّق من طريقة إرسال البيانات.
• (من جهة الخادم) تقرير "إحصاءات Google" في الوقت الفعلي: يمكنك إنشاء حساب مجاني على "إحصاءات Google" واستخدام تقرير الوقت الفعلي لمعرفة ما إذا كانت خوادم Google قد استلمت نتائج العلامة أم لا.

للإبلاغ عن خطأ أو لتقديم ملاحظات حول المعلومات الناقصة، يُرجى ملء نموذج دعم نظام إدارة المحتوى.

عند الإمكان، يُرجى مشاركة إذن الوصول التجريبي مع Google لمواصلة عملية التحقّق.

تعديل تعليمات النشر للمستخدم

يجب تعديل مستنداتك لتقديم تعليمات واضحة حول كيفية استخدام منتجات القياس من Google من خلال عملية التنفيذ. يُرجى مشاركة مسودة من هذه التعليمات من خلال ملء نموذج مراجعة مستندات إعداد دمج نظام إدارة المحتوى حتى نتمكّن من تقديم ملاحظات.