Ecco una query di esempio per la tabella
product_performance_view
che restituisce il rendimento del tuo account negli ultimi 30 giorni, suddiviso per
marketing_method e offer_id. Puoi provare questo breve esempio per familiarizzare con l'API Merchant Reports.
Per recuperare questo report, devi disporre del ruolo Rendimento e approfondimenti. Per maggiori dettagli, consulta i requisiti.
Per effettuare la richiesta, passa la seguente dichiarazione Merchant Center Query Language al metodo accounts.reports.search:
SELECT
marketing_method,
offer_id,
impressions,
clicks,
click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
URL della richiesta HTTP
La richiesta consiste in un POST HTTP al server dell'API Merchant Reports all'URL seguente:
https://merchantapi.googleapis.com/reports/v1beta/accounts/PARENT/reports:search
Esempio completo di richiesta HTTP
Ecco un esempio completo che mostra la definizione del report racchiusa in una richiesta POST HTTP:
POST /reports/v1beta/accounts/PARENT/reports:search HTTP/1.1 Host: merchantapi.googleapis.com User-Agent: curl Content-Type: application/json Accept: application/json Authorization: Bearer Parameters: { "query" : "SELECT marketing_method, offer_id, impressions, clicks, click_through_rate FROM product_performance_view WHERE date BETWEEN '2023-11-01' AND '2023-11-30'" }
Ecco una risposta di esempio:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38",
"impressions": "1038",
"clickThroughRate": "0.3661"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "126",
"impressions": "1126",
"clickThroughRate": "0.1119"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "26",
"impressions": "526",
"clickThroughRate": "0.0494"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "227",
"impressions": "1227",
"clickThroughRate": "0.1850"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "12",
"impressions": "512",
"clickThroughRate": "0.0234"
}
}
]
}