Examinons à présent un cas d'utilisation courant: résumer les performances d'une au cours des 30 derniers jours par campagne, segmentés par appareil. La requête pour ce rapport se présente comme suit:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Pour émettre cette demande, transmettez la déclaration de langage de requête Google Ads ci-dessus au
GoogleAdsService.SearchStream
de commande.
URL de la requête HTTP
La demande consiste en une requête HTTP POST adressée au serveur de l'API Google Ads à l'URL suivante:
https://googleads.googleapis.com/v17/customers/{customer_id}/googleAds:searchStream
Exemple de requête HTTP complète
Voici un exemple complet de la définition de rapport ci-dessus, inclus dans une requête HTTP requête POST.
POST /v17/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]
Parameters:
{
"query" : "SELECT campaign.name, campaign.status, segments.device,
metrics.impressions, metrics.clicks, metrics.ctr,
metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS"
}
Exemples de code
Regarder un tutoriel vidéo présentant un exemple de code qui recherche des campagnes avec des métriques au cours des 7 derniers jours. L'exemple de code de la vidéo est écrit en Java, mais est similaire pour tous les langages.