التحكّم في مَعلمات الأحداث المتاحة للعلامات باستخدام عمليات التحويل

هذا المستند مخصّص لمستخدمي ميزة "وضع العلامات من جهة الخادم" الذين يحتاجون إلى التحكّم في معلَمات الأحداث التي يتم عرضها للعلامات.

يحتوي حاوية من جهة الخادم على عميل يقبل طلبات HTTP الواردة. تتم ترجمة المعلومات الواردة في طلب HTTP إلى كائن بيانات الأحداث. تقرأ علاماتك من جهة الخادم عنصر بيانات الحدث.

يتم تنفيذ عمليات التحويل بعد أن ينشئ العميل عنصر بيانات الحدث.

ما هي عمليات التحويل؟

تتيح لك عمليات التحويل تضمين أو استبعاد أو تعديل ناتج مَعلمات الأحداث من جهة العميل قبل عرضها على علامات التتبُّع. ومن خلال عمليات التحويل، يمكنك حماية المعلومات الحسّاسة والتحكّم بشكلٍ دقيق في مَعلمات الأحداث المتاحة لعمليات معالجة إضافية.

تتيح لك "عمليات التحويل" إنشاء قواعد لإجراء ما يلي:

  • السماح بمشاركة مَعلمات الأحداث المحدّدة بشكلٍ صريح فقط مع العلامات
  • زيادة مَعلمات الأحداث عن طريق إنشاء قواعد لتعديل مَعلمات الأحداث أو إضافتها
  • إخفاء محتوى المعلومات الواردة عن طريق استبعاد مَعلمات الأحداث من العلامات

يمكنك تطبيق عملية تحويل على جميع علاماتك أو أنواع علامات كاملة أو مجموعة محدّدة بشكل فردي. بالإضافة إلى ذلك، يمكنك تطبيق مجموعة من الشروط التي يجب استيفاؤها قبل تنفيذ عملية التحويل.

يتم تقييم المتغيّرات في كل مرة يتم فيها تنفيذ عملية تحويل. استنادًا إلى ما تفعله عمليات التحويل، قد يتم تحويل المتغيّرات إلى قيم مختلفة.

السماح للعلامات باستخدام مَعلمات الأحداث

تتيح لك عملية التحويل السماح بالمعلّمات تحديد مَعلمات أحداث معيّنة تريد عرضها لعلاماتك. يتم تجاهل مَعلمات الأحداث التي لم يتم تحديدها بشكل صريح.

للسماح للعلامات باستخدام مَعلمات أحداث معيّنة، اتّبِع الخطوات التالية:

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

مثال: تسجيل معلومات الاختيار في جدول BigQuery

تتيح لك السيطرة على المَعلمات التي تسجّلها ما يلي:

  • تأكَّد من عدم تسجيل المعلومات الحسّاسة في مستودع البيانات الداخلي.
  • منع التسجيل المفرط الذي يوفّر لك مساحة التخزين وتكاليف السحابة الإلكترونية
  • تخزين المقاييس ذات الصلة لأغراض الرصد وإعداد التقارير

أرِني كيفية إجراء ذلك.

للسماح بتسجيل معلَمات معيّنة فقط:

  1. أنشِئ قاعدة تحويل جديدة.
  2. انقر على إعدادات التحويل واختَر السماح بالمعلَمات.
  3. في المَعلمات المسموح بها، أضِف المَعلمات التي تحتاج إليها، مثل event_name وpage_hostname وpage_path وclient_id وما إلى ذلك.
  4. في العلامات المتأثّرة، اختَر العلامة التي ترسل البيانات إلى مستودع البيانات. بالنسبة إلى BigQuery، يمكنك استخدام addEventCallback وBigQuery APIs في علامة مخصّصة، أو استكشاف "معرض نماذج المنتدى" للاطّلاع على خيارات مُعدّة مسبقًا لمراقبة حاوية الخادم.
  5. أدخِل اسمًا لعملية التحويل واحفظها. من المفترض أن يظهر بالشكل التالي: لقطة شاشة لتحويل مَعلمات مسموح بها

تعزيز مَعلمات الأحداث

تتيح لك عملية التحويل إضافة بيانات إلى الحدث تعديل قيم مَعلمات الأحداث أو إضافة مَعلمات جديدة لتكون متاحة للعلامات.

لتعديل مَعلمات أحداث معيّنة أو إضافتها، اتّبِع الخطوات التالية:

  1. في مساحة العمل، افتح قائمة عمليات التحويل.
  2. أنشِئ قاعدة تحويل جديدة.
  3. انقر على "إعدادات التحويل" واختَر تحسين الحدث.
  4. في المَعلمات المطلوب تعزيزها:

    • لتعديل مَعلمات الأحداث الحالية، أدخِل المَعلمة التي تريد تعديلها في الاسم وأضِف قيمة جديدة. اطّلِع على جميع مَعلمات الأحداث الشائعة.

    • لإضافة قيمة جديدة إلى عنصر بيانات الحدث، أدخِل اسمًا ومتغيّرًا من اختيارك.

  5. اختياري: تتيح لك شروط المطابقة تحديد قواعد لتحديد وقت تفعيل عملية التحويل. يتم تطبيق قواعد التحويل تلقائيًا دائمًا.

  6. في العلامات المتأثّرة، اختَر أنواع العلامات أو العلامات الفردية التي تستجيب لقاعدة التحويل هذه. يتم تلقائيًا تطبيق عملية التحويل على جميع العلامات.

  7. أدخِل اسمًا لقاعدة التحويل واحفظها.

مثال: إعداد عروض الأسعار المستندة إلى القيمة لأحداث الشراء

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

أرِني كيفية إجراء ذلك.

لا تنطبق التعليمات التالية إلا إذا لم تحدّد علامة تتبُّع الإحالات الناجحة في "إعلانات Google" قيمة إحالة ناجحة.

لإعداد عروض الأسعار المستندة إلى القيمة، اتّبِع الخطوات التالية:

  1. أنشِئ قاعدة تحويل جديدة.
  2. انقر على إعدادات التحويل واختَر تحسين الحدث.
  3. في المَعلمات المطلوب تعزيزها، أضِف صفًا جديدًا. إعداد متغيّر لتحميل القيمة النقدية للسلعة في عملية التحويل:
    1. في المَعلمة الاسم، أدخِل اسم القيمة التي تريد تعديلها، مثل value. استبدِل جميع الحقول value لأنّها تمثّل القيمة النقدية لحدث معيّن.
    2. في المَعلمة القيمة، اضبط متغيّرًا يستردّ الأسعار من قاعدة البيانات. على سبيل المثال، إذا كنت تخزّن بيانات المنتجات في Firestore، أضِف متغيّر بحث Firestore.
  4. في شروط المطابقة، اضبط الإعدادات بحيث لا يتم تطبيق هذا التحويل إلا على أحداث معيّنة. لتطبيق عروض الأسعار المستندة إلى القيمة على أحداث الشراء فقط، اضبط ما يلي: {{Event Name}} يساوي purchase.
  5. في العلامات المتأثّرة، أضِف جميع علامات تتبُّع الإحالات الناجحة من "إعلانات Google" التي يجب تطبيق هذا التحويل عليها.
  6. حدِّد اسمًا لعلامتك واحفظها. يجب أن يبدو مشابهًا لما يلي: لقطة شاشة تعرض عملية تحويل مَعلمات الإضافة

استبعاد مَعلمات الأحداث من العلامات

تكون عملية التحويل استبعاد المَعلمات مفيدة لإزالة مَعلمات أحداث معيّنة من علاماتك.

تنبيه: قد لا تعمل العلامات على النحو المتوقّع عند استبعاد المَعلمات التي تتطلّبها. تحقَّق من المَعلمات التي تعتمد عليها علاماتك قبل تحويل المَعلمات.

لاستبعاد علامات مَعلمات أحداث معيّنة، اتّبِع الخطوات التالية:

  1. في مساحة العمل، افتح قائمة عمليات التحويل.
  2. أنشِئ قاعدة تحويل جديدة.
  3. انقر على "إعدادات التحويل" (Transformation Configuration) واختَر استبعاد المَعلمات.
  4. أضِف مَعلمات الأحداث التي لا يمكن أن تستخدمها العلامات. اطّلِع على جميع مَعلمات الأحداث الشائعة.
  5. اختياري: تتيح لك شروط المطابقة تحديد قواعد لتحديد وقت تفعيل عملية التحويل. يتم تطبيق قواعد التحويل تلقائيًا دائمًا.
  6. في العلامات المتأثّرة، اختَر أنواع العلامات أو العلامات الفردية التي تستجيب لقاعدة التحويل هذه. يتم تلقائيًا تطبيق عملية التحويل على جميع العلامات.
  7. أدخِل اسمًا لقاعدة التحويل واحفظها.

مثال: استبعاد سمات مخصّصة محدّدة في "إحصاءات Google" استنادًا إلى موافقة المستخدم

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

أرِني كيفية إجراء ذلك.

لإزالة سمة مخصّصة، اتّبِع الخطوات التالية:

  1. أنشِئ قاعدة تحويل جديدة.
  2. انقر على إعدادات التحويل واختَر استبعاد المَعلمات.
  3. في المَعلمات المطلوب استبعادها، أضِف صفًا جديدًا واضبط السمات المخصّصة التي تريد استبعادها، مثل payment_type وpayment_status.
  4. في شروط المطابقة، اضبط الإعدادات بحيث لا يتم تطبيق عملية التحويل إلا عندما يرفض المستخدم ملفات تعريف الارتباط analytics_storage.
    أنشئ الشروط التالية:
    • {{gcs}} يساوي G100
    • {{gcs}} يساوي G110
  5. اختياري: في العلامات المتأثّرة، أضِف جميع العلامات التي يجب تطبيق عملية التحويل هذه عليها.
  6. حدِّد اسمًا لعلامتك واحفظها. من المفترض أن يظهر بالشكل التالي:مثال على عملية تحويل لاستبعاد المَعلمات

التأكّد من تطبيق قواعد التحويل

يمكنك التحقّق من صحة قواعد التحويل من خلال معاينة مساحة العمل:

  1. افتح موقعك الإلكتروني.
  2. في حاوية الخادم على Google Tag Manager، انقر على معاينة.

    تبدأ إضافة Tag Assistant في تحميل حاوية الخادم.

  3. للاطّلاع على جميع العلامات والإجراءات التي تمّ تنفيذها لحدث معيّن، اختَر اسم حدث من القائمة على يمين الصفحة.

التحقّق من تنفيذ عملية تحويل:

  1. في حال أردت التحقّق من ذلك، افتح علامة التبويب العلامات.
  2. اختَر علامة تم تشغيلها لعرض خصائص العلامة وطلبات HTTP الصادرة والعوامل المشغِّلة التي تم تشغيلها وعمليات التحويل.

    ملاحظة: لا تؤثّر عمليات التحويل إلا في العلامات التي تمّ تفعيلها. يمكن أن يؤدي التحويل إلى عدم تشغيل علامتك إذا عدّل حقول معلَمات الأحداث المطلوبة أو أزالها.

  3. تعرض لك النظرة العامة على تفاصيل العلامة عمليات التحويل التي تم تنفيذها لعلامة معيّنة والترتيب الذي تمّت به. الترتيب التلقائي هو:

    1. السماح بالمَعلمات
    2. تعزيز المَعلمات
    3. استبعاد مَعلمات

    شاشة Tag Assistant تعرض نظرة عامة على علامة "إحصاءات Google"

  4. لعرض تفاصيل عملية التحويل، انقر على عملية تحويل. تظهر مَعلمات الحدث المقدَّمة إلى العلامة ضمن قسم بيانات الحدث.

    تعرض أداة Tag Assistant تفاصيل عملية تحويل.

  5. عند النقر على مربّع بيانات الحدث، يمكنك الاطّلاع على حالة مَعلمات الحدث بعد تنفيذ جميع عمليات التحويل. لعرض مَعلمات الحدث الأصلية والمحوّلة، ضَع علامة في مربّع الاختيار عرض الأصل.

    نظرة عامة على مَعلمات الحدث المعدَّلة