حدث البيانات المقدَّمة من المستخدم في "إعلانات Google"

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

قبل البدء

يفترض هذا المستند أنّك تستوفي الشروط التالية:

• أذونات المشرف في "إعلانات Google" وGoogle Tag Manager
• إعداد Google Tag Manager
• إنشاء حاوية خادم
• إعداد عميل إحصاءات Google‏ 4

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

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

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

لإعداد علامة ربط الإحالة الناجحة، اتّبِع الخطوات التالية:

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

الخطوة 2: إعداد علامة "حدث البيانات المقدَّمة من المستخدم في إعلانات Google" في حاوية الخادم

لإعداد علامة حدث البيانات المقدَّمة من المستخدِم في "إعلانات Google"، اتّبِع الخطوات التالية:

1. في مساحة عمل حاوية الخادم، افتح قائمة العلامات على يمين الصفحة.
2. انقر على جديد لإضافة علامة جديدة.
3. اختَر نوع العلامة حدث البيانات المقدَّمة من المستخدِم في "إعلانات Google".

4. أدخِل معلومات الإحالة الناجحة المطلوبة (رقم تعريف الإحالة الناجحة). يمكنك العثور على هذه القيم في حسابك على "إعلانات Google".

5. في قائمة التشغيل، اختَر مشغّلاً حاليًا إذا كان مناسبًا لحالة الاستخدام. إذا لم يكن هناك مشغّل سابق التحديد يلبّي احتياجاتك، أنشئ مشغّلاً مخصّصًا جديدًا .

   لتشغيل العلامة عند وقوع حدث مخصّص:

   1. اختَر مشغّل حدث مخصّص.
   2. أدخِل اسم الحدث الذي يتطابق مع الاسم المستخدَم في علامة إحصاءات Google: حدث "إحصاءات Google‏ 4".

   لإطلاق الإجراء فقط على عناوين URL محدّدة:

   1. اختَر خيار التفعيل عند بعض الأحداث المخصّصة.
   2. أضِف المتغيّر عنوان URL للصفحة ليكون مساويًا لعنوان URL الذي يجب أن يتم تشغيل العلامة عليه.

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

الخطوة 3: ضبط بيانات المستخدم

تعتمد العلامة على بيانات المستخدم المتوفّرة في الحدث، على غرار ميزة الإحالات الناجحة المحسّنة

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

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

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

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

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

الضبط اليدوي

1. في حاوية الويب، افتح قائمة المتغيّرات.
2. أنشئ متغيّر حدّده المستخدم من النوع بيانات مقدَّمة من المستخدم.
3. اضبط النوع على الضبط اليدوي.

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

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

5. لتحديد أحد العناصر من DOM، أنشئ متغيّر جديد > ضبط المتغيّر > عنصر DOM.

6. ضِمن طريقة الاختيار، يمكنك استخدام أداة اختيار لغة CSS أو رقم التعريف. ملاحظة: إذا كانت متغيّرات CSS تتبدّل بشكلٍ متكرّر، أضِف رقم تعريف HTML إلى موقعك الإلكتروني واستخدِم متغيّر رقم التعريف.

7. أدخِل اسم أداة اختيار لغة CSS أو رقم التعريف. يمكنك ترك حقل "اسم السمة" فارغًا.

8. أدخِل اسمًا لمتغيّر عنصر DOM واحفظه. ستعود الشاشة عندئذٍ إلى إعدادات البيانات المقدَّمة من المستخدِم.

9. أدخِل اسمًا لمتغيّر البيانات المقدَّمة من المستخدِم، مثل My user-defined data.

10. انقر على حفظ.

ضبط الرمز

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

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

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

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

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

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

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

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

1. في موقعك الإلكتروني، عليك تجزئة البيانات المقدَّمة من المستخدِم باستخدام خوارزمية SHA256 بترميز سداسي عشري. ويجب أن يبدأ مفتاح البيانات التي تم ترميزها بـ sha256_. على سبيل المثال:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. أرسِل بيانات المستخدِمين مع حدث باستخدام 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: إنشاء متغيّر البيانات المقدَّمة من المستخدِم

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

تعيين المتغيّر لعلامة تتبُّع من Google

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

4. حفظ التغييرات التي أجريتها يجب أن تبدو علامتك على النحو التالي:

   

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

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

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

للحصول على مزيد من المساعدة في تصحيح أخطاء حاويات Tag Manager، اطّلِع على مساعدة المعاينة وتصحيح الأخطاء.

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

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