製作 Floodlight 自訂變數報表
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
新版 Search Ads 360 Reporting API 現已上線。新版 API 提供
更有彈性,可用來建立自訂報表,以及將資料整合至報表應用程式
和處理程序進一步瞭解如何遷移至及使用
新版 Search Ads 360 報表
API。
廣告客戶會使用 Floodlight 自訂變數回報
特定業務需求,例如使用者所購買的電影類型、名稱
例如銷售商品的商店、運費等等。可以上傳資料
透過廣告客戶網站上的 Floodlight 廣告代碼
透過 Search Ads 360 API,
您可透過 API 下載內含相關資料的報表。
進一步瞭解 Floodlight 自訂功能
變數。
指標或維度
設定 Floodlight 自訂變數時,廣告客戶會使用 Search Ads 360
指出每個變數在報表中的使用方式的使用者介面:
指標:在大多數報表中,Search Ads 360 會匯總
先前稱為指標的變數
舉例來說,廣告客戶使用 Floodlight 自訂變數追蹤運費。
如果 Search Ads 360 使用者將這個變數定義為指標,而您加入該變數
呈現於adGroup
報表中
就會看到報表範圍內,每個廣告群組相關的運費總額。
在 conversion
Search Ads 360 提供的是個別轉換的原始資料,而不是匯總資料。
注意:自訂指標也可能會在
Floodlight 報表欄:在
Search Ads 360 UI,使用者在 Floodlight 報表欄中新增自訂指標,然後納入
報表中的 Floodlight 報表欄。您也可以納入這些 Floodlight 資料欄
就像您可以加入任何其他類型的
。
維度:定義為維度的變數可用於區隔
。
舉例來說,廣告客戶使用 Floodlight 自訂變數追蹤商店名稱。更新後
Search Ads 360 使用者將這個變數定義為維度,可用於區隔
adGroup
報告和
查看廣告群組中廣告歸因於每間商店的消費次數。
在 conversion
報表,Search Ads 360 會提供個別轉換的原始資料,而不是
匯總資料因此,在conversion
報表中加入自訂維度後
你會看到維度值延續上一段範例
按 storeName 自訂維度區隔「conversion
」報表
每筆交易發生的商店名稱。
注意:當 Search Ads 360 使用者定義
Floodlight 報表欄,而是
可以使用自訂維度做為篩選器,讓資料欄只記錄符合以下條件的轉換
所記錄的特定維度值
在報表要求中加入自訂指標
如要在報表要求中加入自訂指標,請按照下列步驟操作:
接著,請在報表要求中加入:
舉例來說,假設廣告客戶建立了一個名為 shippingCost 的自訂指標,
在報表中加入運費 customMetricName
:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
依自訂維度區隔報表
如要按自訂維度區隔報表,請按照下列步驟操作:
接著,請在報表要求中加入:
舉例來說,如果廣告客戶建立名為「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"
}
],
...
}
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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```"]]