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:
Les rapports sur l'attribution unique, tels que le rapport sur les performances des critères ou le rapport sur les performances des mots clés, dans lequel un seul critère de déclenchement (emplacement, âge, mot clé, etc.) est enregistré pour une impression donnée. Une impression peut être déclenchée par plusieurs critères, mais l'impression et toutes ses statistiques ne sont attribuées qu'à un seul critère sur un seul rapport d'attribution.
Les rapports sur l'attribution multiples, tels que le rapport sur les performances par sexe ou le rapport sur les performances des emplacements, dans lesquels jusqu'à un critère de chaque dimension ayant déclenché l'impression a enregistré l'impression. Plusieurs rapports sur l'attribution peuvent être considérés comme des rapports spécifiques à un type de critère. Contrairement à une attribution unique, où une ligne peut contenir différents types de critères, chaque rapport sur l'attribution multiple ne contient que des critères pour un seul type.
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.
API Google Ads
É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.