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

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

قبل البدء

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

• أذونات المشرف في "إعلانات Google" وأداة "إدارة العلامات من Google"
• إعداد أداة "إدارة العلامات من Google"
• إنشاء حاوية خادم
• إعداد عميل إحصاءات Google: GA4

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

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

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

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

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

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

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

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

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

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

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

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

   لتشغيل العلامة فقط على عناوين URL محدّدة:

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

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

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

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

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

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

	الجمع التلقائي للبيانات	الضبط اليدوي	ضبط الرمز
طريقة جمع البيانات	تجمع هذه الطريقة بشكلٍ تلقائي البيانات المقدَّمة من المستخدِم استنادًا إلى رمز موقعك الإلكتروني. إذا كنت بحاجة إلى مزيد من التحكّم لتحديد أماكن جمع البيانات المُدخلة، اختَر الضبط اليدوي أو ضبط الرمز.	حدِّد سمات 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 Tag Manager.

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

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 Tag Manager.

الخطوة 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" في حاوية ويب لتجنُّب تكرار البيانات.