Générer un rapport sur les variables Floodlight personnalisées
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les annonceurs utilisent des variables Floodlight personnalisées pour générer des rapports sur les données de conversion
spécifiques à leurs besoins, comme le genre d'un film acheté par un utilisateur, le nom
du magasin auprès duquel l'article est acheté, les frais de port, etc. Les données peuvent être importées
par un tag Floodlight sur le site de l'annonceur
par l'API Search Ads 360,
et vous pouvez utiliser l'API pour télécharger des rapports contenant les données.
En savoir plus sur Floodlight personnalisé
variables dans Search Ads 360.
Métrique ou dimension
Lors de la configuration des variables Floodlight personnalisées, un annonceur utilise l'interface Search Ads 360
UI indiquant comment utiliser chaque variable dans les rapports:
Métrique: dans la plupart des rapports, Search Ads 360 agrège les valeurs des
variables qui sont définies en tant que métriques.
Par exemple, un annonceur utilise une variable Floodlight personnalisée pour effectuer le suivi des frais de port.
Si un utilisateur de Search Ads 360 définit cette variable en tant que métrique et que vous l'incluez
dans un rapport adGroup
,
vous voyez le total des frais de port associés à chaque groupe d'annonces compris dans la portée du rapport.
Dans la conversion
, Search Ads 360 fournit des données brutes sur des conversions spécifiques plutôt que des données globales.
Remarque: Les métriques personnalisées peuvent également s'afficher dans
Colonnes de rapports Floodlight Dans
Interface utilisateur de Search Ads 360, les utilisateurs ajoutent des métriques personnalisées aux colonnes de rapports Floodlight, puis incluent
les colonnes des rapports Floodlight. Vous pouvez également inclure ces colonnes Floodlight
dans une demande de rapport, tout comme vous pouvez inclure n'importe quel autre type
colonne enregistrée.
Dimension: les variables définies en tant que dimensions peuvent servir à segmenter
la plupart des rapports.
Par exemple, un annonceur utilise une variable Floodlight personnalisée pour effectuer le suivi des noms de magasins. Après
si un utilisateur de Search Ads 360 définit cette variable comme une dimension, vous pouvez l'utiliser pour segmenter une
adGroup
rapport et
consulter le nombre d'achats dans chaque magasin attribués aux annonces du groupe d'annonces ;
Dans la conversion
, Search Ads 360 fournit des données brutes concernant chaque conversion,
des données agrégées. Ainsi, lorsque vous ajoutez une dimension personnalisée au rapport conversion
,
la valeur de la dimension s'affiche. Reprenons l'exemple du paragraphe précédent, si vous
vous pouvez segmenter un rapport "conversion
" en fonction de la dimension personnalisée "storeName"
Le nom du magasin dans lequel chaque achat a été effectué
Remarque: Lorsque les utilisateurs Search Ads 360 définissent
colonne de rapport Floodlight,
vous pouvez utiliser les dimensions personnalisées comme filtre afin que la colonne n'indique que les conversions
enregistré une valeur de dimension spécifique.
Inclure des métriques personnalisées dans une demande de rapport
Pour inclure des métriques personnalisées dans une demande de rapport:
Ensuite, dans une demande de rapport, incluez les éléments suivants:
<ph type="x-smartling-placeholder"></ph>
customMetricName
: spécifie le nom descriptif de la métrique personnalisée.
Le nom de la métrique personnalisée est sensible à la casse.
<ph type="x-smartling-placeholder"></ph>
platformSource
: définissez toujours ce paramètre sur floodlight.
Par exemple, si un annonceur a créé une métrique personnalisée nommée shippingCost,
incluez la valeur shippingCost customMetricName
dans un rapport:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Segmenter un rapport en fonction d'une dimension personnalisée
Pour segmenter un rapport en fonction d'une dimension personnalisée:
Vous devez connaître le nom amical qui a été
spécifiée lorsque la règle personnalisée
La variable Floodlight a été créée dans Campaign Manager.
Le nom descriptif s'affiche également dans l'interface utilisateur de Search Ads 360 lors de la configuration
des dimensions et des métriques personnalisées.
La portée du rapport doit être un annonceur spécifique
ou inférieure.
-
Chaque demande de rapport ne peut spécifier qu'une dimension personnalisée. Toutefois,
peut inclure
segments non personnalisés supplémentaires.
Par exemple, vous pouvez segmenter un rapport en fonction de la dimension personnalisée storeName et
par trimestre et les segments
non personnalisés en fonction de l'appareil. Sachez simplement que le nombre de lignes
augmenter de façon exponentielle à chaque segment supplémentaire.
Ensuite, dans une demande de rapport, incluez les éléments suivants:
<ph type="x-smartling-placeholder"></ph>
customDimensionName
: spécifie le nom descriptif de la dimension personnalisée.
Le nom de la dimension personnalisée est sensible à la casse.
<ph type="x-smartling-placeholder"></ph>
platformSource
: définissez toujours ce paramètre sur floodlight.
Par exemple, si un annonceur a créé une dimension personnalisée nommée storeName,
Incluez le paramètre storeName customDimensionName
dans un rapport pour segmenter les métriques par nom de magasin:
{
"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"
}
],
...
}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/20 (UTC).
[null,null,["Dernière mise à jour le 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```"]]