گزارش در مورد متغیرهای Floodlight سفارشی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
API جدید Search Ads 360 Reporting اکنون در دسترس است. API جدید انعطاف‌پذیری بیشتری برای ایجاد گزارش‌های سفارشی و ادغام داده‌ها در برنامه‌ها و فرآیندهای گزارش‌دهی شما فراهم می‌کند. درباره انتقال و استفاده از
Search Ads 360 Reporting API جدید بیشتر بیاموزید.
تبلیغ‌کنندگان از متغیرهای Floodlight سفارشی برای گزارش داده‌های تبدیل که منحصر به نیازهای تجاری آن‌ها است، استفاده می‌کنند، مانند ژانر فیلمی که کاربر خریداری می‌کند، نام فروشگاهی که یک کالا از آن خریداری شده، هزینه‌های ارسال و غیره. داده ها را می توان با یک برچسب Floodlight در سایت تبلیغ کننده یا توسط Search Ads 360 API آپلود کرد و می توانید از API برای بارگیری گزارش هایی که حاوی داده ها هستند استفاده کنید.
درباره متغیرهای Floodlight سفارشی در Search Ads 360 بیشتر بیاموزید .
متریک یا بعد
به عنوان بخشی از تنظیم متغیرهای Floodlight سفارشی، یک تبلیغ‌کننده از رابط کاربری Search Ads 360 استفاده می‌کند تا نحوه استفاده از هر متغیر را در گزارش‌ها نشان دهد:
متریک : در اکثر گزارش‌ها، Search Ads 360 مقادیر متغیرهایی را که به عنوان معیارها تعریف می‌شوند، جمع‌آوری می‌کند.
برای مثال، یک تبلیغ‌کننده از متغیر Floodlight سفارشی برای پیگیری هزینه‌های حمل و نقل استفاده می‌کند. اگر یک کاربر Search Ads 360 این متغیر را به عنوان یک معیار تعریف کند و شما متغیر را در گزارش adGroup بگنجانید، کل هزینه‌های ارسال مربوط به هر گروه تبلیغاتی را در محدوده گزارش مشاهده خواهید کرد.
در گزارش conversion ، Search Ads 360 به‌جای داده‌های انبوه، داده‌های خام مربوط به تبدیل‌های فردی را ارائه می‌کند.
توجه: معیارهای سفارشی می‌توانند در ستون‌های گزارش Floodlight نیز ظاهر شوند. در رابط کاربری Search Ads 360، کاربران معیارهای سفارشی را به ستون های گزارش Floodlight اضافه می کنند و سپس ستون های گزارش Floodlight را در گزارش ها قرار می دهند. همچنین می‌توانید این ستون‌های Floodlight را در درخواست گزارش بگنجانید، همانطور که می‌توانید هر نوع ستون ذخیره‌شده دیگری را نیز بگنجانید.
بعد : متغیرهایی که به عنوان ابعاد تعریف می شوند را می توان برای بخش بندی بیشتر گزارش ها استفاده کرد.
به عنوان مثال، یک تبلیغ‌کننده از یک متغیر Floodlight سفارشی برای ردیابی نام فروشگاه‌ها استفاده می‌کند. پس از اینکه کاربر Search Ads 360 این متغیر را به عنوان یک بعد تعریف کرد، می‌توانید از آن برای بخش‌بندی گزارش adGroup استفاده کنید و تعداد خریدهایی که از هر فروشگاه به تبلیغات در گروه تبلیغات نسبت داده می‌شود را ببینید.
در گزارش conversion ، Search Ads 360 به‌جای داده‌های انبوه، داده‌های خام مربوط به تبدیل‌های فردی را ارائه می‌کند. بنابراین وقتی یک بعد سفارشی به گزارش conversion اضافه می‌کنید، مقدار ابعاد را خواهید دید. در ادامه مثال پاراگراف قبل، اگر یک گزارش conversion را بر اساس بعد سفارشی storeName تقسیم کنید، نام فروشگاهی را خواهید دید که هر خرید خاصی در آن انجام شده است.
توجه: وقتی کاربران Search Ads 360 ستون گزارش Floodlight را تعریف می‌کنند، می‌توانند از ابعاد سفارشی به‌عنوان یک فیلتر استفاده کنند، بنابراین ستون فقط تبدیل‌هایی را گزارش می‌کند که مقدار ابعاد خاصی را ثبت کرده‌اند.
معیارهای سفارشی را در درخواست گزارش لحاظ کنید
برای گنجاندن معیارهای سفارشی در درخواست گزارش:
سپس در یک درخواست گزارش، شامل موارد زیر باشد:
برای مثال، اگر تبلیغ‌کننده‌ای یک معیار سفارشی به نام shippingCost ایجاد کرده است، در گزارشی، ShippingCost customMetricName وارد کنید:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
یک گزارش را بر اساس یک بعد سفارشی تقسیم کنید
برای تقسیم یک گزارش بر اساس یک بعد سفارشی:
شما باید نام دوستانه ای را که هنگام ایجاد متغیر Floodlight سفارشی در Campaign Manager مشخص شده است، بدانید. هنگام تنظیم ابعاد و معیارهای سفارشی، نام دوستانه نیز در رابط کاربری Search Ads 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
