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

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

قبل البدء

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

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

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

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

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