تمت ترجمة هذه الصفحة بواسطة 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:

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

مبيعات Floodlight

لإعداد علامة مبيعات Floodlight:

في مساحة عمل حاوية الخادم، اختَر قائمة العلامات على يمين الصفحة.
انقر على جديد لإضافة علامة جديدة.
اختَر نوع العلامة مبيعات Floodlight. ملاحظة: تجمع علامة مبيعات Floodlight القيم التالية تلقائيًا من حقل التجارة الإلكترونية المقابل:
```
*   Order ID (Transaction ID)
*   Revenue (Value)
```
لجمع القيم المطلوبة لضبط العلامة، افتح نافذة متصفِّح أخرى وسجِّل الدخول إلى مدير الحملة 360. انقر على المعلنون، ثم انقر على اسم المعلن. أدخِل القيم التالية في علامة عدّاد Floodlight الجديدة في أداة "إدارة العلامات من 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 بترميز سداسي. في كلتا الحالتين، قدِّم حقلاً واحدًا من الحقول التالية على الأقل: البريد الإلكتروني أو رقم الهاتف.
لدفع البيانات غير المُجزّأة إلى طبقة البيانات، يُرجى اتّباع الخطوات التالية:

على موقعك الإلكتروني، خزِّن البيانات المقدَّمة من المستخدِم كأزواج المفتاح/القيمة في متغيّر 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.

ضَع علامة في مربّع الاختيار تضمين البيانات المقدَّمة من المستخدِم.
اضغط على حفظ لحفظ التغييرات.

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

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

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

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

لاستخدام المتغيّر في علامة مبيعات 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 مكافئة في حاوية الويب لتجنُّب تكرار البيانات.