تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

علامات Google Floodlight

هذه المقالة مخصّصة للمطوّرين الذين يريدون نقل علامات Floodlight من حاوية ويب في أداة إدارة العلامات إلى حاوية خادم.

تتيح لك أداة "إدارة العلامات من Google" من جهة الخادم نقل علامات المبيعات وعلامات العداد في Google Floodlight من صفحة الويب إلى الخادم. سيؤدي نقل هذه العلامات إلى الخادم إلى تقليل مقدار الرمز البرمجي الذي عليك تشغيله في الصفحة، ويساعد في تحسين أوقات تحميل الصفحة.

قبل البدء

لكي تتمكّن من نقل العلامات إلى خادمك، تأكَّد من توفُّر ما يلي:

إذن وصول المشرف إلى أداة "إدارة العلامات من Google" وFloodlight
إعداد أداة "إدارة العلامات من Google" وتثبيتها
إعداد حاوية خادم
إعداد عميل "إحصاءات Google": "إحصاءات Google‏ 4"

الخطوة 1: إعداد علامة ربط الإحالة الناجحة

لا يمكن لحسابك على Floodlight إرسال بيانات الإحالات الناجحة إلى أداة "إدارة العلامات من Google" إلا عند إعداد علامة ربط الإحالة الناجحة.

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

لإعداد علامة رابط الإحالة الناجحة:

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

الخطوة 2: إعداد علامات Floodlight

تتيح أداة "إدارة العلامات من Google" استخدام علامات "عدّاد Floodlight" وعلامات "مبيعات Floodlight" في حاوية الخادم.

عدّاد Floodlight

لإعداد علامة Floodlight Counter:

في مساحة عمل حاوية الخادم، اختَر قائمة العلامات على يمين الصفحة.
انقر على جديد لإضافة علامة جديدة.
اختَر نوع علامة عداد Floodlight.
لجمع القيم المطلوبة لضبط العلامة، افتح نافذة متصفّح أخرى وسجِّل الدخول إلى مدير الحملة 360. انقر على المعلِنون، ثمّ انقر على اسم المعلِن. أدخِل هذه القيم في علامة "عداد Floodlight" الجديدة في أداة "إدارة العلامات من Google":
- رقم تعريف المعلِن: سيظهر رقم تعريف المعلِن في صفحة تفاصيل المعلِن أسفل اسم المعلِن مباشرةً. يمكن العثور على هذه القيمة أيضًا كقيمة src= في مقتطف علامة Floodlight تم إنشاؤه.
- سلسلة علامة المجموعة: في جدول "النشاط"، حدِّد النشاط الذي تريد العمل معه وابحث عن سلسلة علامة المجموعة المدرَجة في عمود على يسار الصفحة. ويمكن العثور عليه أيضًا كقيمة type= في مقتطف علامة Floodlight تم إنشاؤه.
- سلسلة علامة النشاط: في جدول "النشاط"، حدِّد النشاط الذي تريد العمل معه وابحث عن سلسلة علامة النشاط المدرَجة في عمود على يسار الصفحة. يمكن العثور على هذا أيضًا في قيمة cat= في مقتطف علامة Floodlight تم إنشاؤه.
اضبط طريقة الاحتساب المطلوبة:
- عادي: يتم احتساب كل إحالة ناجحة.
- فريد: يتم احتساب الإحالة الناجحة الأولى لكل مستخدم فريد في كل يوم على مدار 24 ساعة، من منتصف الليل إلى منتصف الليل، بتوقيت الشرق (الولايات المتحدة).
- لكلّ جلسة: يتم احتساب إحالة ناجحة واحدة لكلّ مستخدِم في كلّ جلسة. يتم ضبط طول الجلسة عن طريق الموقع الإلكتروني الذي تم فيه نشر علامة Floodlight.
افتح نافذة اختيار عامل تشغيل.
في قائمة ضبط المشغِّل، اختَر مشغِّلاً. في معظم الحالات، كل الصفحات هو الخيار الأفضل.
أدخِل اسم علامة وانقر على حفظ.

مبيعات Floodlight

لإعداد علامة تسجيل بيانات المبيعات في Floodlight:

في مساحة عمل حاوية الخادم، اختَر قائمة العلامات على يمين الصفحة.
انقر على جديد لإضافة علامة جديدة.
اختَر نوع علامة تسجيل بيانات المبيعات في Floodlight. ملاحظة: تجمع علامة مبيعات Floodlight القيم التالية تلقائيًا من حقل التجارة الإلكترونية المقابل:
```
*   Order ID (Transaction ID)
*   Revenue (Value)
```
لجمع القيم المطلوبة لضبط العلامة، افتح نافذة متصفّح أخرى وسجِّل الدخول إلى مدير الحملة 360. انقر على المعلِنون، ثمّ انقر على اسم المعلِن. أدخِل هذه القيم في علامة Floodlight Counter الجديدة في أداة "إدارة العلامات من Google":
- رقم تعريف المعلِن: سيظهر رقم تعريف المعلِن في صفحة تفاصيل المعلِن أسفل اسم المعلِن مباشرةً. يمكن العثور على هذه القيمة أيضًا كقيمة src= في مقتطف علامة Floodlight تم إنشاؤه.
- سلسلة علامة المجموعة: في جدول "النشاط"، حدِّد النشاط الذي تريد العمل معه وابحث عن سلسلة علامة المجموعة المدرَجة في عمود على يسار الصفحة. ويمكن العثور عليه أيضًا كقيمة type= في مقتطف علامة Floodlight تم إنشاؤه.
- سلسلة علامة النشاط: في جدول "النشاط"، حدِّد النشاط الذي تريد العمل معه وابحث عن سلسلة علامة النشاط المدرَجة في عمود على يسار الصفحة. يمكن العثور على هذا أيضًا في قيمة cat= في مقتطف علامة Floodlight تم إنشاؤه.
اضبط طريقة الاحتساب المطلوبة:
- عادي: يتم احتساب كل إحالة ناجحة.
- فريد: يتم احتساب الإحالة الناجحة الأولى لكل مستخدم فريد في كل يوم على مدار 24 ساعة، من منتصف الليل إلى منتصف الليل، بتوقيت الشرق (الولايات المتحدة).
- لكلّ جلسة: يتم احتساب إحالة ناجحة واحدة لكلّ مستخدِم في كلّ جلسة. يتم ضبط طول الجلسة عن طريق الموقع الإلكتروني الذي تم فيه نشر علامة Floodlight.
افتح نافذة اختيار عامل تشغيل.
في قائمة ضبط المشغِّل، اختَر مشغِّلاً. في معظم الحالات، كل الصفحات هو الخيار الأفضل.
أدخِل اسم علامة وانقر على حفظ.

اختياري: إعداد ميزة "الإحالات الناجحة المحسّنة"

إذا كنت لا تستخدم ميزة "الإحالات الناجحة المحسّنة"، انتقِل إلى التحقّق من إعدادك.

لضبط الإحالات الناجحة المُحسّنة، اتّبِع الخطوات التالية:

إعداد متغيّر للبيانات المقدَّمة من المستخدِم

تتوفّر 3 طرق يمكنك من خلالها تنفيذ ميزة الإحالات الناجحة المحسّنة في أداة "إدارة العلامات من Google". ما عليك سوى تحديد خيار واحد لجمع البيانات المقدَّمة من المستخدِم.

	الجمع التلقائي للبيانات	الضبط اليدوي	ضبط الرمز
طريقة جمع البيانات	تجمع هذه الطريقة تلقائيًا البيانات المقدَّمة من المستخدِم استنادًا إلى رمز موقعك الإلكتروني. إذا كنت بحاجة إلى التحكّم في أماكن جمع البيانات المُدخلة، اختَر الضبط اليدوي أو ضبط الرمز.	حدِّد سمات CSS أو متغيّرات JavaScript محدّدة لجمع البيانات المقدَّمة من المستخدِم. إذا كنت بحاجة إلى التحكّم في تنسيق البيانات والتجزئة، اختَر ضبط الرمز.	أضِف مقتطف رمز على موقعك الإلكتروني يُرسِل بيانات العملاء المجزّأة للمطابقة. هذه الطريقة هي الخيار الأفضل لزيادة دقة الإحالات الناجحة المحسّنة عن طريق السماح لك بإرسال بيانات منسَّقة بشكلٍ متّسق كلما تمّ تنشيط علامة إحالتك الناجحة.
مستوى التعقيد	بسيط	متوسّط	معقّد
المهارات	ما مِن مهارات خاصة مطلوبة	‏HTML وCSS	تطوير مواقع الإنترنت

الجمع التلقائي للبيانات

في حاوية الويب، افتح قائمة المتغيّرات.
أنشئ متغيّرًا محدّدًا من المستخدِم جديدًا من النوع البيانات المقدَّمة من المستخدِم.
اضبط النوع على الجمع التلقائي للبيانات.
أدخِل اسمًا للمتغيّر، مثلاً My user-defined data.
انقر على حفظ.

الضبط اليدوي

في حاوية الويب، افتح قائمة المتغيّرات.
أنشئ متغيّرًا محدّدًا من المستخدِم جديدًا من النوع البيانات المقدَّمة من المستخدِم.
اضبط النوع على الضبط اليدوي.
بالنسبة إلى حقل بيانات المستخدِمين ذات الصلة التي تريد تقديمها من خلال ميزة الإحالات الناجحة المحسّنة، أضِف متغيّرًا جديدًا أو حاليًا.

ملاحظة: إذا كانت لديك حاليًا متغيّرات في طبقة البيانات (سواء كنت تستخدِم أدوات اختيار لغة CSS أو أنواع متغيّرات أخرى)، يمكنك اختيارها بدلاً من إنشاء متغيّرات جديدة. وإذا لم تكن متأكّدًا، استمِر في اتّباع التعليمات. قد تتم تجزئة المتغيّرات أو عدم تجزئتها.
لتحديد أحد العناصر من DOM، أنشئ متغيّر جديد > ضبط المتغيّر > عنصر DOM.
ضمن طريقة الاختيار، يمكنك استخدام أداة اختيار لغة CSS أو رقم تعريف. ملاحظة: إذا كانت متغيّرات CSS تتبدّل بشكلٍ متكرّر، أضِف رقم تعريف HTML إلى موقعك الإلكتروني واستخدِم متغيّر رقم التعريف.
أدخِل اسم أداة اختيار لغة CSS أو رقم التعريف. يمكنك ترك حقل "اسم السمة" فارغًا.
أدخِل اسمًا لمتغيّر عنصر DOM واحفظه. ستعود الشاشة بعد ذلك إلى إعدادات البيانات المقدَّمة من المستخدِم.
أدخِل اسمًا لمتغيّر البيانات المقدَّمة من المستخدِم، مثل My user-defined data.
انقر على حفظ.

ضبط الرمز

الخطوة 1: تحديد متغيّرات الإحالات الناجحة المحسّنة وتعريفها

يمكنك إرسال بيانات غير مجزّأة، ستعمل Google على تجزئتها قبل أن تصل البيانات إلى الخوادم، أو إرسال بيانات مجزّأة مسبقًا. إذا اختَرت إرسال بيانات مجزّأة مسبقًا، يُرجى ترميز البيانات باستخدام خوارزمية SHA256 بترميز سداسي عشري. وفي كلتا الحالتين، يجب تقديم حقل واحد على الأقل من الحقول التالية: email (البريد الإلكتروني) أو phone_number (رقم الهاتف).
لإرسال بيانات غير مجزّأة إلى طبقة البيانات:

في موقعك الإلكتروني، خزِّن البيانات المقدَّمة من المستخدِم في صورة أزواج المفتاح/القيمة في متغيّر JavaScript. على سبيل المثال:

var leadsUserData = {
  'email': 'name@example.com',
  'phone_number': '+11234567890',
  'address': {
    first_name: 'John',
    last_name: 'Doe',
    street: '123 Lemon',
    city: 'Some city',
    region: 'CA',
    country: 'US',
    postal_code: '12345',
  },
};

أرسِل بيانات المستخدِمين مع حدث باستخدام dataLayer.push()‎. على سبيل المثال:

<script>
  dataLayer.push({
    'event': 'formSubmitted',
    'leadsUserData': {
      'email': 'name@example.com',
      'phone_number': '+11234567890',
      'address': {
         first_name: 'John',
         last_name: 'Doe',
         street: '123 Lemon',
         city: 'Some city',
         region: 'CA',
         country: 'US',
        postal_code: '12345',
       },
     },
  });
<script>

يتوفّر المتغيّر leadsUserData الآن في أداة "إدارة العلامات من Google".

لإرسال بيانات مجزّأة مسبقًا إلى طبقة البيانات:

في موقعك الإلكتروني، عليك تجزئة البيانات المقدَّمة من المستخدِم باستخدام خوارزمية SHA256 بترميز سداسي عشري. يجب أن يبدأ مفتاح البيانات التي تم ترميزها بـ sha256_. على سبيل المثال:
```
{'sha256_email_address':await hashEmail(email.trim()),
}
```

أرسِل بيانات المستخدِم مع حدث باستخدام dataLayer.push(). يوضّح المثال التالي عملية تنفيذ طبقة بيانات يفترض أنّك كتبت دالة تجزئة بنفسك، وتتولّى تشغيلها بشكلٍ غير متزامن.

<script>
  dataLayer.push({
    'event': 'formSubmitted',
    'leadsUserData': {
      'sha256_email_address': await hashEmail(email.trim()),
      'sha256_phone_number': await hashPhoneNumber(phoneNumber),
      'address': {
        sha265_first_name: await hashString(firstname),
        sha256_last_name: await hashString(lastname),
        sha256_street: await hashString(streetAddress),
        postal_code: '12345',
       },
     },
  });
<script>

يتوفّر المتغيّر leadsUserData الآن في أداة "إدارة العلامات من Google".

الخطوة 2: إنشاء متغيّر البيانات المقدَّمة من المستخدِم

في حاوية الويب، افتح قائمة المتغيّرات.
أنشئ متغيّرًا محدّدًا من المستخدِم جديدًا من النوع البيانات المقدَّمة من المستخدِم.
اضبط النوع على رمز.
بالنسبة إلى حقل بيانات المستخدِمين ذات الصلة التي تريد تقديمها، انقر على القائمة المنسدلة واختَر متغيّر جديد.
ضمن اختيار نوع المتغيّر، اختَر متغيّر طبقة البيانات.
في متغيّر طبقة البيانات، أشِر إلى بيانات المستخدِمين المخزَّنة. مثلاً: leadsUserData
أدخِل اسمًا لمتغيّر طبقة البيانات واحفظه. ستعود الشاشة بعد ذلك إلى إعدادات البيانات المقدَّمة من المستخدِم.
أدخِل اسمًا لمتغيّر البيانات المقدَّمة من المستخدِم، مثل My user-defined data.
انقر على حفظ.

تخصيص المتغيّر لعلامة Google

في حاوية الويب، افتح قائمة العلامات.
عدِّل علامة Google التي تستخدمها لإرسال البيانات إلى خادم وضع العلامات.
ضمن إعدادات الضبط، أضِف مَعلمة ضبط جديدة باسم user_data. اضبط القيمة على متغيّر البيانات المقدَّمة من المستخدِم، مثل {{My user-provided data}}.
حفظ التغييرات التي أجريتها من المفترض أن تظهر علامتك على النحو التالي:

ضبط علامة Floodlight من جهة الخادم

في حاوية الخادم، فعِّل ميزة "الإحالات الناجحة المحسّنة" من خلال إعداد علامة مبيعات Floodlight أو علامة Floodlight Counter.

alt_text

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

إذا كنت تريد تضمين البيانات المقدَّمة من المستخدِم في ميزة الإحالات الناجحة المحسّنة للويب، يجب إرسال معلومات تحديد الهوية الشخصية (PII) من الموقع الإلكتروني (الحاوية على جهة العميل)، والتي يتم إرسالها بدورها من خلال الحاوية على جهة الخادم. إذا كنت لا تريد إرسالข้อมูล العميل المتعلّقة بتحديد الهوية من خلال علامة معيّنة، استخدِم "عمليات التحويل" لإخفاء بيانات العميل المتعلّقة بتحديد الهوية للعلامات المحدّدة.

اختياري: قيمة الأرباح

تستخدِم علامة تسجيل بيانات المبيعات في Floodlight مَعلمة value للحدث باعتبارها القيمة التلقائية للمبلغ لاحتساب الأرباح. لتحديد أساس مختلف لاحتساب قيمة الأرباح، عليك إعداد متغيّر لسحب البيانات من قاعدة بياناتك في وتخصيصها لعلامة المبيعات في Floodlight.

لإنشاء متغيّر جديد:

في حاوية الخادم، افتح قائمة المتغيّرات.
أنشئ متغيّرًا جديدًا من تحديد المستخدِم لإدخال البيانات. على سبيل المثال، إذا كنت تريد استخدام قيمة من قاعدة بيانات Firestore، أنشئ متغيّر {{بحث Firestore}}.
حدِّد مصادر البيانات للمتغيّر.
أدخِل اسمًا للمتغيّر، مثل "بحث الأرباح"، ثمّ احفظه.

لاستخدام المتغيّر في علامة تسجيل بيانات المبيعات في Floodlight:

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

اختياري: المَعلمات المخصّصة

يمكنك ضبط سمات مخصّصة من صفحة الويب إلى "منصة Google للتسويق"، مثل match_id.

إدارة العلامات من Google

لضبط الحقول المخصّصة لخدمة Floodlight، أضِف x-dc- قبل اسم المَعلمة:

في حاوية الويب، افتح قائمة العلامات.
عدِّل علامة حدث في "إحصاءات Google‏ 4" أو أنشئ علامة جديدة.
في مَعلمات الأحداث، أضِف اسم المَعلمة. للإشارة إلى أنّه يتم توجيهه إلى Floodlight، أضِف x-dc- في بداية المسار. على سبيل المثال، إذا كنت ترسل عادةً match_id، غيِّره إلى x-dc-match_id.
احفظ العلامة.

gtag.js

لضبط الحقول المخصّصة لخدمة Floodlight، أضِف x-dc- قبل اسم مَعلمة الحدث:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

الخطوة 3: التحقّق من صحة الإعداد

بعد بدء إرسال البيانات باستخدام حاوية الخادم، يمكنك التحقّق مما إذا كانت تعمل بشكلٍ سليم باتّباع الخطوات التالية:

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

لمزيد من المساعدة في تصحيح أخطاء حاويات أداة "إدارة العلامات من Google"، اطّلِع على المساعدة في معاينة العلامات وتصحيح أخطائها.

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

بعد أن تعمل علامة Floodlight على النحو المطلوب، يمكنك إزالة أي علامات Floodlight مماثلة في حاوية ويب لتجنُّب تكرار البيانات.