الميزات الإعلانية

يوضّح هذا الدليل كيفية استخدام المكوّن الإضافي للميزات الإعلانية في مقتطف analytics.js.

نظرة عامة

يمكن تفعيل الميزات الإعلانية في "إحصاءات Google" (بما في ذلك قوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث) في "إحصاءات Google" من إعدادات الموقع > جمع البيانات. يمكن استخدام المكوّن الإضافي للميزات الإعلانية لـ analytics.js لتفعيل الميزات الإعلانية آليًا، بالإضافة إلى إلغاء وإيقاف جميع ميزات إعداد التقارير الإعلانية وميزات تجديد النشاط التسويقي التي تم إنشاؤها في واجهة مستخدم "إحصاءات Google".

التنفيذ

والطريقة المقترَحة هي تفعيل ميزات إعداد التقارير الإعلانية من إعدادات موقع "إحصاءات Google".

لتفعيل المكوّن الإضافي للميزات الإعلانية، أضِف طلب require وحدِّد المكوّن الإضافي displayfeatures.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'displayfeatures');
ga('send', 'pageview');

يرسل المكوّن الإضافي طلبًا إلى stats.g.doubleclick.net يتم استخدامه لتفعيل الميزات الإعلانية. ينشئ المكوّن الإضافي ملف تعريف ارتباط جديدًا اسمه "_gat" تنتهي فيه مهلة دقيقة واحدة. لا يخزِّن ملف تعريف الارتباط هذا أي معلومات عن المستخدم، بل يُستخدم فقط للحدّ من عدد الطلبات التي يجب تقديمها إلى doubleclick.net.

الاسم التلقائي لملف تعريف الارتباط هو _gat. ويمكنك تغيير هذا الخيار من خلال ضبط الخيار cookieName عند طلب المكوّن الإضافي:

ga('require', 'displayfeatures', {cookieName: 'display_features_cookie'});

تجدر الإشارة إلى أنّ الوسيطة الثالثة تُستخدم عادةً لتحديد موقع النص البرمجي. بما أنّ هذا المكوّن الإضافي مضمَّن في analytics.js، يمكنك ببساطة تمرير undefined.

استخدام أجهزة تتبُّع متعددة

لاستخدام المكوّن الإضافي للميزات الإعلانية مع أجهزة تتبُّع متعددة، عليك إضافة طلب require في البداية مع اسم أداة التتبُّع:

// create a tracker named 'foo' for property UA-XXXXX-Y
ga('create', 'UA-XXXXX-Y', {name: 'foo'});
ga('foo.require', 'displayfeatures');
ga('foo.send', 'pageview');

// create a second tracker named 'bar' for a different property UA-XXXX-Z
ga('create', 'UA-XXXXX-Z', {name: 'bar'});
ga('bar.require', 'displayfeatures');
ga('bar.send', 'pageview');

عند تحميل المكوّن الإضافي للميزات الإعلانية لجهاز تتبُّع معيّن، يتم إلحاق اسم أداة التتبُّع باسم ملف تعريف الارتباط. في المثال أعلاه، يتم إنشاء ملفَّي تعريف الارتباط _gat_foo و_gat_bar.

إيقاف الميزات الإعلانية

بما أنّه يمكن تفعيل الميزات الإعلانية من خلال إعدادات مشرف "إحصاءات Google"، قد تحتاج إلى إيقافها آليًا.

لإيقاف جميع الميزات الإعلانية باستخدام analytics.js، اضبط السمة allowAdFeatures على false بعد الأمر create، وقبل الأمر send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdFeatures', false);
ga('send', 'pageview');

عند الضبط على true (القيمة التلقائية)، يسمح الإعداد allowAdFeatures بتفعيل المكوّن الإضافي displayfeatures وإعدادات الميزات الإعلانية في "إحصاءات Google". هذا الحقل لا يفعّل هذه الميزات بنفسه.

اضبط allowAdFeatures على false لإيقاف إشارات الميزات الإعلانية في "إحصاءات Google"، سواء تم تفعيلها من خلال المكوّن الإضافي displayfeatures أو من داخل "إحصاءات Google".

لإيقاف ميزات تخصيص الإعلانات فقط، اضبط allowAdPersonalizationSignals على false بعد الأمرcreate، وقبل الأمر send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdPersonalizationSignals', false);
ga('send', 'pageview');