إعداد تقارير عن متغيّرات Floodlight المخصّصة

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها API.

يستخدم المعلنون متغيّرات Floodlight المخصّصة للإبلاغ عن بيانات الإحالات الناجحة فريدة حسب احتياجات أعماله، مثل نوع الفيلم الذي يشتريه المستخدم، واسم للمتجر الذي تم شراء السلعة منه وتكاليف الشحن وما إلى ذلك. يمكن تحميل البيانات بواسطة علامة Floodlight على الموقع الإلكتروني للمعلِن بواسطة Search Ads 360 API ويمكنك استخدام واجهة برمجة التطبيقات لتنزيل التقارير التي تحتوي على البيانات.

مزيد من المعلومات عن Floodlight المخصّص المتغيّرات في "إعلانات شبكة البحث 360".

المقياس أو السمة

كجزء من إعداد متغيّرات Floodlight المخصّصة، يستخدم المعلِن "إعلانات شبكة البحث 360" واجهة مستخدم للإشارة إلى كيفية استخدام كل متغيّر في التقارير:

  • المقياس: في معظم التقارير، تجمع "إعلانات شبكة البحث 360" قيم والمتغيرات التي يتم تعريفها كمقاييس.
    على سبيل المثال، يستخدِم أحد المعلِنين متغيّر Floodlight مخصَّصًا لتتبُّع تكاليف الشحن. إذا حدّد أحد مستخدمي "إعلانات شبكة البحث 360" هذا المتغيّر على أنّه مقياس وتم تضمين المتغيّر في تقرير adGroup، سترى إجمالي تكاليف الشحن المرتبطة بكل مجموعة إعلانية في نطاق التقرير

    في conversion توفر "إعلانات شبكة البحث 360" بيانات أولية عن الإحالات الناجحة الفردية بدلاً من البيانات المجمّعة.

    ملاحظة: يمكن أن تظهر المقاييس المخصّصة أيضًا في أعمدة تقارير Floodlight: في جلسة المعمل، واجهة مستخدم "إعلانات شبكة البحث 360"، يُضيف المستخدِمون مقاييس مخصّصة إلى أعمدة تقارير Floodlight، ثمّ يُدرِجون مقاييس مخصّصة أعمدة تقارير Floodlight في التقارير يمكنك أيضًا تضمين أعمدة Floodlight هذه في طلب تقرير، مثلما يمكنك تضمين أي نوع آخر من العمود المحفوظ.

  • السمة: يمكن استخدام المتغيّرات التي يتم تعريفها كأبعاد لتقسيم. في معظم التقارير.
    على سبيل المثال، يستخدِم أحد المعلِنين متغيّر Floodlight مخصَّصًا لتتبُّع أسماء المتاجر. بعد يعرّف مستخدِم "إعلانات شبكة البحث 360" هذا المتغيّر على أنّه سمة، يمكنك استخدامه لتقسيم تقرير adGroup الاطّلاع على عدد عمليات الشراء من كل متجر والتي يعود مصدرها إلى الإعلانات في المجموعة الإعلانية

    في conversion توفر "إعلانات شبكة البحث 360" بيانات أولية عن الإحالات الناجحة الفردية بدلاً من وتجميع البيانات. وبالتالي، عند إضافة سمة مخصّصة إلى تقرير conversion، ستظهر لك قيمة البُعد. متابعة المثال من الفقرة السابقة، إذا تقسيم تقرير conversion حسب سمة storeName المخصّصة، ستظهر لك اسم المتجر الذي حدثت فيه كل عملية شراء محددة.

    ملاحظة: عندما يحدّد مستخدمو "إعلانات شبكة البحث 360" عمود إعداد تقارير Floodlight يمكنك استخدام الأبعاد المخصّصة كفلتر حتى لا يسجِّل العمود سوى الإحالات الناجحة التي سجّل قيمة بُعد معينة.

تضمين المقاييس المخصّصة في طلب تقرير

لتضمين المقاييس المخصّصة في طلب تقرير:

بعد ذلك، في طلب التقرير، قم بتضمين ما يلي:

  • customMetricName: تحدّد الاسم المتوافق مع المقياس المخصّص.
    اسم المقياس المخصّص حسّاس لحالة الأحرف.

  • platformSource: يجب ضبط هذه الميزة دائمًا على Floodlight.

على سبيل المثال، إذا أنشأ أحد المعلنين مقياسًا مخصّصًا باسم shippingCost، أدرِج تكلفة الشحن customMetricName في تقرير:

{
   "reportScope": {
     "agencyId": "12300000000000456", // Replace with your ID
     "advertiserId": "21700000000011523", // Replace with your ID
   },
   ...
   "columns": [
     {
        "customMetricName": "shippingCost",
        "platformSource": "floodlight"
     }
   ],
   ...
}
   

تقسيم تقرير حسب سمة مخصّصة

لتقسيم تقرير حسب سمة مخصصة:

  • يجب معرفة الاسم المتوافق الذي عندما يتم تحديد السمة المخصصة تم إنشاء متغيّر Floodlight في "مدير الحملة". يظهر اسم المحتوى المألوف أيضًا في واجهة مستخدم "إعلانات شبكة البحث 360" عند إعداد والسمات والمقاييس المخصصة.

  • يجب أن يكون نطاق التقرير معلنًا محدّدًا. أو أقل.

  • يمكن أن يحدد كل طلب تقرير سمة مخصصة واحدة فقط. لكن يمكن أن يتضمن الطلب شرائح إضافية غير مخصّصة.
    على سبيل المثال، يمكنك تقسيم تقرير حسب السمة المخصّصة storeName و حسب ربع السنة والشرائح غير المخصّصة للأجهزة فقط اعلم أن عدد الصفوف يمكن تتزايد بشكل كبير مع كل مقطع إضافي.

بعد ذلك، في طلب التقرير، قم بتضمين ما يلي:

  • customDimensionName: تُحدِّد الاسم المتوافق مع السمة المخصّصة.
    اسم السمة المخصّصة حسّاس لحالة الأحرف.

  • platformSource: يجب ضبط هذه الميزة دائمًا على Floodlight.

على سبيل المثال، إذا أنشأ المعلِن سمة مخصّصة باسم storeName، تضمين storeName customDimensionName في تقرير لتقسيم المقاييس حسب اسم المتجر:

{
   "reportScope": {
     "agencyId": "20700000000000123", // Replace with your IDs
     "advertiserId": "2170000012345" // Replace with your IDs
   },
   "reportType": "campaign",

   "columns": [
     { "columnName": "campaignId" },
     { "columnName": "clicks" },
     { "columnName": "cost" },
     { "columnName": "dfaRevenue"},

     {
        "customDimensionName": "storeName",
        "platformSource": "floodlight"
     }
   ],
   ...
}