إعداد تقارير عن متغيّرات Floodlight المخصّصة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يستخدم المعلنون متغيّرات 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
يمكنك استخدام الأبعاد المخصّصة كفلتر حتى لا يسجِّل العمود سوى الإحالات الناجحة التي
سجّل قيمة بُعد معينة.
تضمين المقاييس المخصّصة في طلب تقرير
لتضمين المقاييس المخصّصة في طلب تقرير:
بعد ذلك، في طلب التقرير، قم بتضمين ما يلي:
على سبيل المثال، إذا أنشأ أحد المعلنين مقياسًا مخصّصًا باسم shippingCost،
أدرِج تكلفة الشحن customMetricName في تقرير:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
تقسيم تقرير حسب سمة مخصّصة
لتقسيم تقرير حسب سمة مخصصة:
يجب معرفة الاسم المتوافق الذي
عندما يتم تحديد السمة المخصصة
تم إنشاء متغيّر Floodlight في "مدير الحملة".
يظهر اسم المحتوى المألوف أيضًا في واجهة مستخدم "إعلانات شبكة البحث 360" عند إعداد
والسمات والمقاييس المخصصة.
يجب أن يكون نطاق التقرير معلنًا محدّدًا.
أو أقل.
-
يمكن أن يحدد كل طلب تقرير سمة مخصصة واحدة فقط. لكن
يمكن أن يتضمن الطلب
شرائح إضافية غير مخصّصة.
على سبيل المثال، يمكنك تقسيم تقرير حسب السمة المخصّصة storeName و
حسب ربع السنة والشرائح غير المخصّصة للأجهزة فقط اعلم أن عدد الصفوف يمكن
تتزايد بشكل كبير مع كل مقطع إضافي.
بعد ذلك، في طلب التقرير، قم بتضمين ما يلي:
على سبيل المثال، إذا أنشأ المعلِن سمة مخصّصة باسم 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"
}
],
...
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables allow advertisers to report unique conversion data like product details or shipping costs.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables can be defined as metrics (aggregated values) or dimensions (report segmentation).\u003c/p\u003e\n"],["\u003cp\u003eTo include custom metrics in reports, use the \u003ccode\u003ecustomMetricName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e in your request.\u003c/p\u003e\n"],["\u003cp\u003eTo segment reports by a custom dimension, use the \u003ccode\u003ecustomDimensionName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e while limiting to one custom dimension per request.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows building custom reports and integrating data into reporting applications. Advertisers can use custom Floodlight variables for unique conversion data. These variables can be defined as metrics (aggregated data) or dimensions (segmentation). To include custom metrics, specify the friendly name and set the platform source to \"floodlight\" in the report request. Similarly, segmenting by a custom dimension requires specifying its friendly name and \"floodlight\" as the platform source. Only one custom dimension is allowed per report request.\n"],null,["# Report on Custom Floodlight Variables\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAdvertisers use **custom Floodlight variables** to report conversion data that is\nunique to their business needs, such as the genre of a movie that a user purchases, the name\nof the store from which an item is purchased, shipping costs, and so on. The data can be uploaded\nby a Floodlight tag on the advertiser's site or\n[by the Search Ads 360 API](/search-ads/v2/how-tos/conversions/custom-data),\nand you can use the API to download reports that contain the data.\n\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about custom Floodlight\nvariables in Search Ads 360.\n\n### Metric or dimension\n\nAs part of setting up custom Floodlight variables, an advertiser uses the Search Ads 360\nUI to indicate how each variable can be used in reports:\n\n-\n **Metric** : In most reports, Search Ads 360 aggregates the values of\n variables that are defined as metrics. \n\n For example, an advertiser uses a custom Floodlight variable to track shipping costs.\n If a Search Ads 360 user defines this variable as a metric and you include the variable\n in an [`adGroup`](/search-ads/v2/report-types/adGroup) report,\n you'll see the total shipping costs associated with each ad group in the report's scope.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of aggregated data.\n\n Note: Custom metrics can also appear in\n [Floodlight reporting columns](https://support.google.com/searchads/answer/6024745). In the\n Search Ads 360 UI, users add custom metrics to Floodlight reporting columns and then include\n the Floodlight reporting columns in reports. You can also include these Floodlight columns\n in a report request, just as you can include any other type of\n [saved column](/search-ads/v2/how-tos/reporting/saved-columns).\n-\n **Dimension** : Variables that are defined as dimensions can be used to segment\n most reports. \n\n For example, an advertiser uses a custom Floodlight variable to track store names. After\n a Search Ads 360 user defines this variable as a dimension, you can use it to segment an\n [`adGroup`](/search-ads/v2/report-types/adGroup) report and\n see the number of purchases from each store that are attributed to ads in the ad group.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of\n aggregated data. So when you add a custom dimension to the `conversion` report,\n you'll see the dimension value. Continuing the example from the previous paragraph, if you\n segment a `conversion` report by the storeName custom dimension, you'll see\n the name of the store in which each specific purchase occurred.\n\n\n Note: When Search Ads 360 users define a\n [Floodlight reporting column](https://support.google.com/searchads/answer/6024721), they\n can use custom dimensions as a filter so the column reports only the conversions that\n recorded a specific dimension value.\n\n### Include custom metrics in a report request\n\nTo include custom metrics in a report request:\n\n-\n You'll need to know the **friendly** name that was\n specified when the\n [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when\n [setting up\n custom dimensions and metrics](https://support.google.com/searchads/answer/6024747#set-up).\n\n-\n The scope of the report needs to be a specific advertiser or lower.\n\nThen in a report request, include:\n\n-\n [`customMetricName`](/search-ads/v2/reference/reports#request.columns.customMetricName): Specifies the friendly name of the custom metric.\n\n The custom metric name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom metric named **shippingCost** ,\ninclude the shippingCost `customMetricName` in a report: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"12300000000000456\", // Replace with your ID\n \"advertiserId\": \"21700000000011523\", // Replace with your ID\n },\n ...\n \"columns\": [\n {\n \"customMetricName\": \"shippingCost\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```\n\n### Segment a report by a custom dimension\n\nTo segment a report by a custom dimension:\n\n-\n You'll need to know the **friendly** name that was\n specified when the [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/partners/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when setting up\n custom dimensions and metrics.\n\n- The scope of the report needs to be a specific advertiser\n or lower.\n\n- Each report request can only specify **one** custom dimension. But the\n request can include [additional non-custom segments](/search-ads/v2/how-tos/reporting/segmented-reports#multiple). \n\n For example, you can segment a report by the storeName custom dimension **and**\n by the quarter and device non-custom segments. Just be aware that the number of rows could\n increase exponentially with each additional segment.\n\nThen in a report request, include:\n\n-\n [`customDimensionName`](/search-ads/v2/reference/reports#request.columns.customDimensionName): Specifies the friendly name of the custom dimension.\n\n The custom dimension name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom dimension named **storeName** ,\ninclude the storeName `customDimensionName` in a report to segment metrics by store name: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"20700000000000123\", // Replace with your IDs\n \"advertiserId\": \"2170000012345\" // Replace with your IDs\n },\n \"reportType\": \"campaign\",\n\n \"columns\": [\n { \"columnName\": \"campaignId\" },\n { \"columnName\": \"clicks\" },\n { \"columnName\": \"cost\" },\n { \"columnName\": \"dfaRevenue\"},\n\n {\n \"customDimensionName\": \"storeName\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```"]]
