L'API Search Ads 360 Reporting precedente è stata ritirata. Ora puoi creare i report utilizzando la nuova API Search Ads 360 Reporting.
Tieni presente che i metodi get e getByCustomerId nell'API Search Ads 360 Conversion verranno ritirati nel terzo trimestre del 2025. Per continuare ad accedere ai dati sulle conversioni, devi creare un report utilizzando la risorsa conversion con la nuova API Search Ads 360 Reporting. Scopri di più qui.
Le restanti funzioni dell'API Search Ads 360 Conversion continueranno a essere supportate.
Report sulle variabili Floodlight personalizzate
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La nuova API Search Ads 360 Reporting è ora disponibile. La nuova API fornisce
Maggiore flessibilità per la creazione di report personalizzati e l'integrazione dei dati nelle applicazioni di generazione dei report
e processi. Scopri di più sulla migrazione e sull'utilizzo dei
nuovi report di Search Ads 360
tramite Google Cloud.
Gli inserzionisti utilizzano le variabili Floodlight personalizzate per generare report sui dati sulle conversioni che:
specifiche delle sue esigenze aziendali, come il genere di un film acquistato da un utente, il nome
del negozio in cui viene acquistato un articolo, i costi di spedizione e così via. I dati possono essere caricati
da un tag Floodlight sul sito dell'inserzionista oppure
dall'API Search Ads 360,
e potrai utilizzare l'API per scaricare i report contenenti i dati.
Scopri di più su Floodlight personalizzato
in Search Ads 360.
Metrica o dimensione
Nell'ambito della configurazione delle variabili Floodlight personalizzate, un inserzionista utilizza Search Ads 360
UI per indicare come ogni variabile può essere utilizzata nei report:
Metrica: nella maggior parte dei report, Search Ads 360 aggrega i valori di
variabili definite come metriche.
Ad esempio, un inserzionista utilizza una variabile Floodlight personalizzata per monitorare i costi di spedizione.
Se un utente di Search Ads 360 definisce questa variabile come metrica e tu includi la variabile
in un report di adGroup
,
vengono visualizzati i costi totali di spedizione associati a ciascun gruppo di annunci nell'ambito del rapporto.
In conversion
, Search Ads 360 fornisce dati non elaborati sulle singole conversioni anziché dati aggregati.
Nota: le metriche personalizzate possono essere visualizzate anche
Colonne dei report Floodlight. Nella
UI di Search Ads 360: gli utenti aggiungono metriche personalizzate alle colonne dei report Floodlight e poi includono
le colonne dei report Floodlight nei report. Puoi anche includere queste colonne Floodlight
in una richiesta di rapporto, così come puoi includere qualsiasi altro tipo di
colonna salvata.
Dimensione: le variabili definite come dimensioni possono essere utilizzate per segmentare
nella maggior parte dei report.
Ad esempio, un inserzionista utilizza una variabile Floodlight personalizzata per monitorare i nomi dei negozi. Dopo il giorno
un utente di Search Ads 360 definisce questa variabile come dimensione, puoi utilizzarla per segmentare una
adGroup
e
visualizzare il numero di acquisti effettuati in ciascun negozio attribuiti agli annunci del gruppo di annunci.
In conversion
Search Ads 360 fornisce i dati non elaborati sulle singole conversioni
e aggregati. Perciò, quando aggiungi una dimensione personalizzata
al report conversion
,
vedrai il valore della dimensione. Riprendo l'esempio del paragrafo precedente, se
segmentare un report conversion
in base alla dimensione personalizzata storeName, vedrai
Il nome del negozio in cui è avvenuto ogni acquisto specifico.
Nota: quando gli utenti di Search Ads 360 definiscono una
colonna Floodlight, vengono
puoi utilizzare le dimensioni personalizzate come filtro, in modo che la colonna riporti solo le conversioni che
hanno registrato un valore di dimensione specifico.
Includere metriche personalizzate in una richiesta di report
Per includere metriche personalizzate in una richiesta di report:
Quindi, in una richiesta di report, includi:
Ad esempio, se un inserzionista ha creato una metrica personalizzata denominata shippingCost,
includi il costo di spedizione customMetricName
in un report:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Segmentare un report in base a una dimensione personalizzata
Per segmentare un report in base a una dimensione personalizzata:
Dovrai conoscere il nome descrittivo che è stato
specificato quando il parametro personalizzato
La variabile Floodlight è stata creata in Campaign Manager.
Il nome descrittivo viene visualizzato anche nell'interfaccia utente di Search Ads 360 durante la configurazione
dimensioni e metriche personalizzate.
L'ambito del report deve essere un inserzionista specifico
o inferiore.
-
Ogni richiesta di report può specificare una sola dimensione personalizzata. Ma
la richiesta può includere
segmenti non personalizzati aggiuntivi.
Ad esempio, puoi segmentare un report in base alla dimensione personalizzata storeName e
i segmenti non personalizzati per dispositivo. Tieni presente che il numero di righe può
aumentano in modo esponenziale con ogni segmento aggiuntivo.
Quindi, in una richiesta di report, includi:
customDimensionName
: specifica il nome descrittivo della dimensione personalizzata.
Il nome della dimensione personalizzata è sensibile alle maiuscole.
platformSource
: imposta sempre questa opzione su Faretto.
Ad esempio, se un inserzionista ha creato una dimensione personalizzata denominata storeName,
Includi storeName customDimensionName
in un report per segmentare le metriche in base al nome del negozio:
{
"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"
}
],
...
}
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-08-20 UTC.
[null,null,["Ultimo aggiornamento 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```"]]