カスタム Floodlight 変数に関するレポートを作成する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
広告主は、カスタム Floodlight 変数を使用して、
たとえば、ユーザーが購入した映画のジャンル、名前、名前など、ビジネスニーズに
アイテムを購入した店舗の場所、送料などがあります。データはアップロードできます
広告主のサイトの Floodlight タグ
Search Ads 360 API
データを含むレポートをダウンロードできます
カスタム Floodlight の詳細
変数を使用できます。
指標またはディメンション
カスタム Floodlight 変数の設定の一環として、広告主は検索広告 360 を使用して
各変数をレポートで使用する方法を示す UI:
指標: 検索広告 360 のほとんどのレポートでは、
指標として定義された変数を使用します。
たとえば、広告主がカスタム Floodlight 変数を使用して送料をトラッキングしているとします。
検索広告 360 のユーザーがこの変数を指標として定義しており、
adGroup
レポート
レポートの範囲内で、各広告グループに関連付けられた送料の合計が表示されます。
conversion
レポートでは、集計データではなく、個々のコンバージョンに関する元データが提供されます。
注: カスタム指標は
Floodlight レポートの列。
検索広告 360 の管理画面で、Floodlight レポートの列にカスタム指標を追加して
Floodlight レポートの列を確認します。これらの Floodlight 列も追加できます
レポート リクエストには、他の種類の URL や
保存済み列。
ディメンション: ディメンションとして定義された変数は、セグメント化に使用できます。
ほとんどありません
たとえば、広告主がカスタム Floodlight 変数を使用して店舗名をトラッキングしているとします。変更後
検索広告 360 のユーザーがこの変数をディメンションとして定義した場合、その変数を使用して
adGroup
のレポートと
広告グループ内の広告に起因する各店舗での購入数を確認する。
conversion
レポートとは異なり、検索広告 360 では個々のコンバージョンに関する元データが、
集計データですconversion
レポートにカスタム ディメンションを追加すると、次のようになります。
ディメンションの値が表示されます。前の段落の例の続きを見ると、
conversion
レポートを storeName のカスタムディメンションで分割すると
購入が行われた店舗の名前。
注: 検索広告 360 のユーザーが
Floodlight レポート列
カスタム ディメンションをフィルタとして使用し、該当するコンバージョンのみを列に表示する
記録したデータを確認できます
レポート リクエストにカスタム指標を含める
レポート リクエストにカスタム指標を含めるには:
次に、レポート リクエストに以下を含めます。
たとえば、広告主が「shippingCostshippingCost」というカスタム指標を作成した場合、
レポートに shippingCost customMetricName
を含めます。
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
カスタム ディメンションでレポートを分割する
カスタム ディメンションでレポートを分割するには:
テキスト メッセージに付けられたわかりやすい名前を
カスタム属性が
Floodlight 変数がキャンペーン マネージャーで作成されている。
このわかりやすい名前は、検索広告 360 の設定時に検索広告 360 の管理画面にも表示されます。
カスタムディメンションとカスタム指標
レポートの対象は特定の広告主である必要があります。
以下です。
-
各レポート リクエストに指定できるカスタム ディメンションは 1 つのみです。しかし、
リクエストに を含めることができます。
カスタム以外の追加のセグメント。
たとえば、storeName のカスタム ディメンションでレポートを分割できます。かつ
カスタムセグメント以外の
四半期とデバイス別に確認できますただし、処理できる行数が
セグメントを追加するごとに
指数関数的に増加します
次に、レポート リクエストに以下を含めます。
たとえば、広告主様が「storeNamestoreName」というカスタム ディメンションを作成した場合、
レポートに 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"
}
],
...
}
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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```"]]