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

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

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

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

الجمهور

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

قبل البدء

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

نظرة عامة

لدمج منصّتك مع منتجات Google، اتّبِع الخطوات التالية:

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

إنشاء عملية دمج مع "علامة التتبُّع من 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('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('js', new Date());

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

يُرجى ملاحظة ما يلي:

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

تحديث بنية بيانات أدخلها المستخدم

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

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

مربّع إدخال معرّف "علامة التتبّع من Google"

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

"إحصاءات Google" و"إعلانات Google" تؤديان إلى مسار إدخال واحد

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

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

النتيجة المتوقّعة هي حصول العملاء على طلب 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"

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

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

قبل نشر التغييرات في بيئة الإنتاج، تحقَّق من التوافق مع ما يلي:

"علامة التتبُّع من Google" مع وجهة في "إحصاءات Google"
"علامة التتبُّع من Google" لتجديد النشاط التسويقي وقياس الإحالات الناجحة

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

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

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

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

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

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