وضع الطرف الأول: تحميل نصوص Google البرمجية من خلال وضع العلامات من جهة الخادم

هذه المقالة مخصّصة للمطوّرين الذين يستخدِمون وضع العلامات من جهة الخادم ويريدون عرض النصوص البرمجية من Google من خوادمهم الخاصة.

تسمح لك ميزة وضع العلامات من جهة الخادم بتحميل نصوص Google البرمجية، مثل gtm.js أو gtag.js، مباشرةً من خادم وضع العلامات بدلاً من خوادم Google. يتيح لك ذلك عرض البيانات في سياق الطرف الأول.

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

للبدء، اختَر خيار التنفيذ.

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

لتحميل نصوص Google البرمجية من خلال حاوية الخادم:

  1. فتح أداة "إدارة العلامات من Google"
  2. في حاوية الخادم، انقر على العملاء.
  3. انقر على جديد.
  4. اختَر نوع العميل "إدارة العلامات من Google": حاوية الويب. مربّع حوار اختيار نوع العميل في أداة "إدارة العلامات من Google": تم تمييز عميل حاوية الويب

  5. في إعدادات العميل:

    • إضافة رقم تعريف الحاوية: أدخِل رقم تعريف حاوية الويب في أداة "إدارة العلامات من Google" التي ستستخدمها على موقعك الإلكتروني.
    • العرض التلقائي لجميع نصوص Google البرمجية التي لها اعتمادية: عند تفعيل هذه الميزة (الإعداد التلقائي)، سيعرض خادم وضع العلامات تلقائيًا النصوص البرمجية التي يحتاج إليها نص Google البرمجي الجذر. ويؤدي ذلك إلى عدم الحاجة إلى إدراج كل حاوية يتطلّب النص البرمجي من Google إدراجها في القائمة المسموح بها. إذا كنت تريد عرض الحاوية الأولية فقط من خادم وضع العلامات، أزِل العلامة من هذا الخيار.
    • تفعيل الإعدادات المتعلّقة بالمنطقة: استخدِم هذا الخيار لتشغيل علامات معيّنة استنادًا إلى الموقع الجغرافي للمستخدم. مزيد من المعلومات

    لقطة شاشة لعميل حاوية الويب في أداة "إدارة العلامات من Google"

  6. أدخِل اسمًا للعميل ثم انقر على حفظ.

  7. انشر مساحة العمل.

الخطوة 2: تعديل نطاق مصدر النص البرمجي

بشكلٍ تلقائي، تحمِّل أداة "إدارة العلامات من Google" أو مقتطف gtag.js المكوّنات التابعة لها من خوادم تملكها Google، مثل https://example.com/metrics. عليك تعديل عنوان URL للنص البرمجي على موقعك الإلكتروني لتحميل الملحقات من خلال خادمك الخاص.

لتحميل رمز أداة "إدارة العلامات من Google" من خلال حاوية الخادم:

  1. حدِّد مكان رمز "إدارة العلامات من Google" الحالي في الصفحة.
  2. استبدِل السلسلة https://example.com/metrics باسم نطاق خادم وضع العلامات في <head> و<body> من رمز تثبيت أداة "إدارة العلامات من Google".

    • العنوان:
    <!-- Google Tag Manager -->
    <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
    new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://example.com/metrics/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
    })(window,document,'script','dataLayer','GTM-XXXXXX');</script>
    <!-- End Google Tag Manager -->
    
    • النص:
    <!-- Google Tag Manager (noscript) -->
    <noscript><iframe src="https://example.com/metrics/ns.html?id=TAG_ID"
    height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
    <!-- End Google Tag Manager (noscript) -->
    

الخطوة 3: التحقّق من مصدر النصوص البرمجية

توضّح التعليمات التالية كيفية الاختبار باستخدام Google Chrome. يمكنك استخدام أي متصفّح تختاره، ولكن قد تختلف الخطوات.

لاختبار ما إذا كانت حاوية الخادم تحمّل التبعيات:

  1. افتح موقعك الإلكتروني في علامة تبويب متصفّح جديدة.
  2. افتح أدوات المطوّرين في المتصفّح. في متصفّح Google Chrome، يمكنك النقر بزر الماوس الأيمن في أيّ مكان على الصفحة واختيار فحص.
  3. في أدوات المطوّرين، افتح علامة التبويب المصادر. تعرض هذه النافذة جميع التبعيات التي تم تحميلها عند فتح الموقع الإلكتروني.

    • ✅ يكون التنفيذ صحيحًا إذا تم تحميل gtm.js من المصدر الذي حدّدته.

    لقطة شاشة لأدوات المطوّرين مع خادمك الخاص كمصدر لنصوص Google البرمجية

    • ❌ إذا كانت علامة التبويب المصادر تعرض www.googletagmanager.com كمصدر gtm.js، سيستمر تحميل التبعيات من خوادم Google.

    لقطة شاشة لأدوات المطوّرين مع www.googletagmanager.com كمصدر لنصوص Google البرمجية

    • تحقّق مما إذا كنت قد عدّلت عنوان URL المصدر في الرمز، راجِع الخطوة 2.
    • تحقَّق مما إذا كان الرمز نشطًا.

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

إذا كنت تستخدم "وضع الموافقة"، يمكنك إعداد سلوك العلامة الخاص بمنطقة معيّنة للتحكّم بشكل أكبر.