Présentation des rapports

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vidéo: GAQL Workshop

Avec l'unification des rapports et des requêtes, vous n'avez plus besoin de définir un rapport. Vous pouvez interroger directement des ressources pour obtenir des données à l'aide d'un objet SearchGoogleAdsStreamRequest ou SearchGoogleAdsRequest.

Commencez la planification de la migration de vos rapports en consultant les tables de mappage de champs appropriées. Ces tableaux indiquent le nom du champ de l'API AdWords et son équivalent dans l'API Google Ads.

Exemple

Le rapport sur les performances des groupes d'annonces et le rapport sur les performances des campagnes sont deux des rapports les plus utilisés dans l'API AdWords. Nous comparons les requêtes équivalentes dans le langage de requête AdWords (AWQL) et le langage de requête Google Ads (GAQL):

Rapport sur les performances des groupes d'annonces
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
Rapport sur les performances des campagnes
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
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

Rapport sur les attributions uniques

Lors de la migration, certains rapports sur certains critères de l'API AdWords peuvent nécessiter un examen particulier, tels que le rapport sur les performances des mots clés ou le rapport sur les performances par tranche d'âge. Il existe deux types de rapports:

Dans l'API Google Ads, il n'existe pas de rapports d'attribution uniques. Tous les rapports au niveau des critères de l'API Google Ads sont basés sur l'attribution multiple dans le sens où chaque rapport est spécifique à un groupe de types de critères et résume les statistiques en fonction des critères de ce type. N'additionnez pas de statistiques provenant de différentes ressources criteria_view, car cela entraînerait un double comptage et des totaux incorrects.

En-tête HTTP includeZeroImpressions

API AdWords

Dans l'API AdWords, vous pouvez utiliser l'en-tête includeZeroImpressions pour contrôler si les lignes de rapport contenant tous les champs de métriques spécifiés dans la requête ne doivent avoir aucune valeur.

Définissez l'en-tête sur true ; le résultat du rapport inclut de telles lignes. Pour false, ce n'est pas le cas.

Bien que le nom de l'en-tête mentionne "Impressions", une ligne de rapport doit inclure zéro dans tous les champs de métriques spécifiés dans la requête (pas uniquement les impressions) pour être exclue lorsque l'en-tête est défini sur false.

Étant donné qu'il n'existe pas d'en-tête dans l'API Google Ads, vous ne pouvez pas mapper les requêtes de l'API AdWords directement à des requêtes dans l'API Google Ads.

De manière approximative, vous pouvez spécifier le prédicat metrics.impressions > 0 dans votre requête pour exclure les lignes de rapport dont les impressions sont égales à zéro. Dans la plupart des cas, les résultats sont équivalents, car l'en-tête includeZeroImpressions de l'API AdWords est défini sur false, car lorsque les impressions sont différentes de zéro, les autres valeurs de métriques sont souvent également nulles.

Toutefois, gardez à l'esprit que metrics.impressions est égal à zéro, mais que d'autres valeurs de métriques (telles que la valeur metrics.search_impression_share de prédiction) peuvent ne pas l'être. Dans ce cas, une ligne de rapport peut toujours être renvoyée.