Exemple de cas d'utilisation courant

Ce cas d'utilisation résume les performances d'un compte au cours des 30 derniers jours par campagne, segmentées par appareil. La requête pour obtenir 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 requête, transmettez cette instruction de langage de requête Google Ads à l'interface GoogleAdsService.SearchStream.

URL de la requête HTTP

La requête consiste en une requête HTTP POST adressée au serveur de l'API Google Ads à l'URL suivante :

https://googleads.googleapis.com/v24/customers/{customer_id}/googleAds:searchStream

Remplacez {customer_id} par l'ID du compte Google Ads spécifique que vous souhaitez interroger. N'incluez pas de tirets dans l'ID. Si vous souhaitez récupérer des données pour un sous-compte, vous devez utiliser l'ID de ce sous-compte. L'interrogation avec un ID de compte administrateur ne renvoie que les données appartenant directement à ce compte administrateur et n'inclut pas les données de ses sous-comptes.

Exemple de requête HTTP complète

Voici un exemple complet de cette définition de rapport, inclus dans une requête HTTP POST.

POST /v24/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

Regardez une vidéo de présentation d'un exemple de code qui recherche des campagnes avec des métriques au cours des sept derniers jours. Cet exemple de code est écrit en Java, mais le processus est similaire pour tous les langages.