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

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

قبل البدء

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

• حقوق المشرف في "إعلانات Google" و"إدارة العلامات من Google"
• إعداد أداة "إدارة العلامات من Google"
• تم إنشاء حاوية خادم
• إعداد برنامج "إحصاءات Google": "إحصاءات Google 4"

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

للسماح لخدمة "إعلانات 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 Assistant وتحمّل حاوية الخادم.
3. تعرض لك علامة التبويب العلامات جميع العلامات التي تم تنشيطها. احرص على التحقّق من تنشيط العلامة التي ضبطتها.
4. تعرض علامة التبويب وحدة التحكّم أي أخطاء حدثت أثناء نقل البيانات إلى حاوية الخادم. تحقق من الأخطاء وحلها.

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

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

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