Exemple de cas d'utilisation courant

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.

Important :Cet exemple ne montre la requête HTTP sous-jacente qu'en tant que requête . nous vous conseillons vivement d'utiliser l'une des bibliothèques clientes pour envoyer des demandes dans votre propre application.

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.