Voici un exemple de requête destinée à product_performance_view qui renvoie les performances de votre compte au cours des 30 derniers jours, segmentées par marketing_method et offer_id. Vous pouvez essayer cet exemple simple pour vous familiariser avec l'API Merchant Reports.
Vous devez disposer du rôle "Performances et insights" pour récupérer ce rapport. Pour en savoir plus, consultez les conditions requises.
Pour envoyer la requête, transmettez cette instruction de langage de requête Merchant Center à la méthode 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 de la requête HTTP
La requête consiste en une requête HTTP POST adressée au serveur de l'API Merchant Reports à l'URL suivante:
https://merchantapi.googleapis.com/reports/v1beta/accounts/PARENT/reports:search
Exemple de requête HTTP complète
Voici un exemple complet illustrant la définition de rapport incluse dans une requête HTTP POST:
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'" }
Voici un exemple de réponse :
{
"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"
}
}
]
}