맞춤 플러드라이트 변수 보고
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
광고주는 맞춤 플러드라이트 변수를 사용하여
비즈니스 요구사항에 따라 고유한 이름(예: 사용자가 구매한 영화의 장르,
배송비, 배송비 등이 포함됩니다. 데이터는
광고주 사이트의 플러드라이트 태그에 의해
Search Ads 360 API에 의해 결정됩니다.
API를 사용하여 데이터가 포함된 보고서를 다운로드할 수 있습니다.
맞춤 플러드라이트 자세히 알아보기
Search Ads 360에서 변경할 수 있습니다.
측정항목 또는 측정기준
맞춤 플러드라이트 변수를 설정하는 과정에서 광고주는 Search Ads 360
보고서에서 각 변수가 사용되는 방식을 나타내는 UI:
측정항목: 대부분의 보고서에서 Search Ads 360은 측정항목 값을 집계합니다.
측정항목으로 정의된 변수입니다.
예를 들어 광고주가 맞춤 플러드라이트 변수를 사용하여 배송비를 추적합니다.
Search Ads 360 사용자가 이 변수를 측정항목으로 정의하고 광고주가 이 변수를 포함하는 경우
adGroup 보고서에서 볼 수 있음
보고서 범위에서 각 광고그룹과 연결된 총 배송비를 확인할 수 있습니다.
conversion
보고서에서 Search Ads 360은 집계된 데이터가 아닌 개별 전환에 대한 원시 데이터를 제공합니다.
참고: 맞춤 측정항목은
플러드라이트 보고서 열.
사용자가 플러드라이트 보고서 열에 맞춤 측정항목을 추가한 다음
보고서의 플러드라이트 보고서 열입니다. 또한 이러한 플러드라이트 열을
다른 유형의 맞춤 측정기준을 포함할 수 있는 것처럼
저장된 열을 참고하세요.
측정기준: 측정기준으로 정의되는 변수는 분류 기준으로 사용할 수 있습니다.
확인할 수 있습니다
예를 들어 광고주가 맞춤 플러드라이트 변수를 사용하여 매장 이름을 추적합니다. 후(After)
Search Ads 360 사용자가 이 변수를 측정기준으로 정의하면 이를 사용하여
adGroup 보고서 및
광고그룹의 광고로 인해 발생한 각 매장의 구매 건수를 확인할 수 있습니다.
conversion
Search Ads 360은 기존 보고서 대신 개별 전환에 대한 원시 데이터를
합산 데이터입니다. 따라서 conversion 보고서에 맞춤 측정기준을 추가하면
측정기준 값이 표시됩니다. 이전 단락의 예를 계속 살펴보겠습니다.
conversion 보고서를 storeName 맞춤 측정기준으로 분류하는 경우
각 특정 구매가 발생한 매장의 이름
참고: Search Ads 360 사용자가
플러드라이트 보고서 열을 사용하여
맞춤 측정기준을 필터로 사용할 수 있으므로
특정 측정기준 값을 기록합니다.
보고서 요청에 맞춤 측정항목 포함
보고서 요청에 맞춤 측정항목을 포함하려면 다음 단계를 따르세요.
그런 다음 보고서 요청에 다음을 포함합니다.
예를 들어 광고주가 shippingCost라는 맞춤 측정항목을 만든 경우
보고서에 shippingCost customMetricName 포함:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
맞춤 측정기준에 따라 보고서 분류하기
맞춤 측정기준을 기준으로 보고서를 분류하는 방법은 다음과 같습니다.
친숙한 이름을 알아야 합니다.
커스텀
Campaign Manager에서 플러드라이트 변수가 생성되었습니다.
설정 시 Search Ads 360 UI에도 친숙한 이름이 표시됩니다.
맞춤 측정기준 및 측정항목을
사용 설정할 수 있습니다
보고서 범위는 특정 광고주여야 함
이하는 것이 좋습니다
-
각 보고서 요청에서 맞춤 측정기준을 하나만 지정할 수 있습니다. 하지만
요청에
추가 세그먼트를 만들기도 합니다.
예를 들어 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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-20(UTC)
[null,null,["최종 업데이트: 2024-08-20(UTC)"],[[["\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```"]]
