Berichte zu benutzerdefinierten Floodlight-Variablen erstellen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Werbetreibende verwenden benutzerdefinierte Floodlight-Variablen zur Erfassung von Conversion-Daten, die
speziell auf ihre geschäftlichen Anforderungen zugeschnitten sind, wie z. B. das Genre eines Films, den ein Nutzer kauft, der Name
des Geschäfts, in dem ein Artikel gekauft wird, die Versandkosten usw. Die Daten können hochgeladen werden,
von einem Floodlight-Tag auf der Website des Werbetreibenden
über die Search Ads 360 API
Außerdem können Sie die API verwenden, um Berichte mit den entsprechenden Daten herunterzuladen.
Weitere Informationen zu benutzerdefinierten Floodlight-Tags
Variablen in Search Ads 360.
Messwert oder Dimension
Beim Einrichten von benutzerdefinierten Floodlight-Variablen verwendet ein Werbetreibender die Search Ads 360-
Benutzeroberfläche, auf der angegeben wird, wie die einzelnen Variablen in Berichten verwendet werden können:
Messwert: In den meisten Berichten aggregiert Search Ads 360 die Werte
Variablen, die als Messwerte definiert sind.
Ein Werbetreibender verwendet beispielsweise eine benutzerdefinierte Floodlight-Variable, um Versandkosten zu verfolgen.
Wenn ein Search Ads 360-Nutzer diese Variable als Messwert definiert und Sie die Variable
in einem adGroup-Bericht
sehen Sie die Versandkosten für jede Anzeigengruppe im Gültigkeitsbereich des Berichts.
In der conversion
liefert Search Ads 360 Rohdaten zu einzelnen Conversions anstelle von aggregierten Daten.
Hinweis: Benutzerdefinierte Messwerte können auch in
Spalten für Floodlight-Berichte: Im
können Nutzer in der Search Ads 360-Benutzeroberfläche
benutzerdefinierte Messwerte zu Floodlight-Berichtsspalten hinzufügen
Floodlight-Berichtsspalten in Berichten. Sie können diese Floodlight-Spalten auch
in einer Berichtsanfrage, genau wie Sie jede andere Art von
gespeicherte Spalte.
Dimension: Variablen, die als Dimensionen definiert sind, können zur Segmentierung verwendet werden.
in den meisten Berichten.
Ein Werbetreibender verwendet beispielsweise eine benutzerdefinierte Floodlight-Variable, um Filialnamen zu erfassen. Nachher
ein Search Ads 360-Nutzer diese Variable als Dimension definiert, können Sie damit
adGroup-Bericht und
Sie sehen die Anzahl der Käufe in jedem Geschäft, die Anzeigen in der Anzeigengruppe zugeordnet sind.
In der conversion
liefert Search Ads 360 Rohdaten zu einzelnen Conversions statt
aggregierte Daten. Wenn Sie also eine benutzerdefinierte Dimension zum conversion-Bericht hinzufügen,
sehen Sie den Dimensionswert. Ausgehend vom Beispiel aus dem vorherigen Absatz
einen Bericht vom Typ „conversion“ nach der benutzerdefinierten Dimension „storeName“ segmentieren,
Den Namen des Geschäfts, in dem der jeweilige Kauf stattgefunden hat
Hinweis: Wenn Search Ads 360-Nutzer ein
Floodlight-Berichtsspalte angezeigt wird,
können benutzerdefinierte Dimensionen als Filter verwenden, sodass in der Spalte nur die Conversions enthalten sind,
einen bestimmten Dimensionswert erfasst hat.
Benutzerdefinierte Messwerte in eine Berichtsanfrage einbeziehen
So schließen Sie benutzerdefinierte Messwerte in eine Berichtsanfrage ein:
Geben Sie dann in einer Berichtsanfrage Folgendes an:
<ph type="x-smartling-placeholder"></ph>
customMetricName: Gibt den Anzeigenamen des benutzerdefinierten Messwerts an.
Beim Namen des benutzerdefinierten Messwerts wird zwischen Groß- und Kleinschreibung unterschieden.
<ph type="x-smartling-placeholder"></ph>
platformSource: Stellen Sie hier immer Flutlight ein.
Beispiel: Ein Werbetreibender hat einen benutzerdefinierten Messwert namens shippingCost erstellt.
Nehmen Sie die Versandkosten customMetricName in einen Bericht auf:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Bericht nach einer benutzerdefinierten Dimension segmentieren
So segmentieren Sie einen Bericht nach einer benutzerdefinierten Dimension:
Sie müssen den Anzeigenamen kennen, der
angegeben, wenn die benutzerdefinierte
Die Floodlight-Variable wurde in Campaign Manager erstellt.
Der Anzeigename wird auch auf der Search Ads 360-Benutzeroberfläche angezeigt, wenn Sie
benutzerdefinierten Dimensionen und Messwerten.
Der Geltungsbereich des Berichts muss ein bestimmter Werbetreibender sein
oder niedriger.
-
In jeder Berichtsanfrage kann nur eine benutzerdefinierte Dimension angegeben werden. Die
Anfrage kann enthalten
zusätzliche nicht benutzerdefinierte Segmente.
Beispielsweise können Sie einen Bericht nach der benutzerdefinierten Dimension „storeName“ segmentieren und
und nicht benutzerdefinierte Segmente
nach Quartal und Gerät. Beachten Sie jedoch, dass die Anzahl der Zeilen
mit jedem weiteren Segment exponentiell an.
Geben Sie dann in einer Berichtsanfrage Folgendes an:
<ph type="x-smartling-placeholder"></ph>
customDimensionName: Gibt den Anzeigenamen der benutzerdefinierten Dimension an.
Beim Namen der benutzerdefinierten Dimension wird zwischen Groß- und Kleinschreibung unterschieden.
<ph type="x-smartling-placeholder"></ph>
platformSource: Stellen Sie hier immer Flutlight ein.
Beispiel: Ein Werbetreibender hat eine benutzerdefinierte Dimension namens storeName erstellt.
Nehmen Sie den storeName customDimensionName in einen Bericht auf, um Messwerte nach Shopnamen zu segmentieren:
{
"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"
}
],
...
}
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-08-20 (UTC).
[null,null,["Zuletzt aktualisiert: 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```"]]
