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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting 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، أدرِج السمة 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"
     }
   ],
   ...
}