Créer des rapports sur les cibles des campagnes et des groupes d'annonces

La nouvelle API Search Ads 360 Reporting est désormais disponible. La nouvelle API vous offre davantage de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications et processus de reporting. En savoir plus sur la migration vers et l'utilisation de la nouvelle API Search Ads 360 Reporting

Les cibles sont des critères permettant de diffuser des annonces en fonction de la zone géographique, des données démographiques et d'autres caractéristiques d'une requête de recherche. Par exemple, un annonceur peut faire en sorte que les annonces d'une campagne ne soient diffusées qu'à New York, Boston et Chicago. Un annonceur peut également augmenter les enchères pour les recherches effectuées par les membres d'une audience publicitaire spécifique, augmentant ainsi la probabilité que l'annonce soit diffusée auprès de cette audience.

Certains types de cibles ne peuvent être appliqués qu'aux campagnes, tandis que d'autres ne peuvent s'appliquer qu'à des groupes d'annonces. Pour savoir quelles cibles sont disponibles à chaque niveau, consultez la documentation sur les rapports campaignTarget et adGroupTarget.

Vous pouvez demander des rapports contenant des métriques de performances pour des types de cibles spécifiques. Par exemple, si un annonceur cible une campagne sur des zones géographiques, incluez la colonne locationTargetName dans une requête campaignTarget. Lorsque vous récupérez le rapport généré, vous pouvez consulter les performances de la campagne dans chaque zone ciblée.

Cibles à exclure

Les cibles à exclure empêchent la diffusion de vos annonces lorsque les recherches correspondent à des critères spécifiques. Comme pour les cibles, certains types de cibles à exclure ne peuvent être appliqués qu'aux campagnes, tandis que d'autres ne peuvent s'appliquer qu'à des groupes d'annonces. Pour en savoir plus, consultez negativeCampaignTarget et negativeAdGroupTarget.

Vous pouvez demander des rapports pour connaître les critères utilisés par les cibles à exclure pour exclure des annonces. Par exemple, si un annonceur utilise des cibles à exclure pour empêcher une campagne de diffuser des annonces dans des zones géographiques spécifiques, incluez la colonne locationTargetName dans une requête negativeCampaignTarget. Lorsque vous récupérez le rapport généré, vous pouvez consulter la liste des zones géographiques exclues de la campagne.

Exemples de requête

Voici des exemples de requêtes pour différents types de cibles:

Créer des rapports sur les cibles géographiques d'une campagne

L'exemple de demande asynchrone suivant renvoie le nombre de clics, d'impressions et d'autres données pour les cibles géographiques (la création de rapports sur les cibles géographiques n'est disponible que pour les campagnes Google Ads). Search Ads 360 accepte quelques types de cibles géographiques, comme les cibles géographiques, les zones de proximité ciblées et les rayons cibles pour les extensions de lieu Google Ads. Les rapports sur les cibles géographiques contiennent des données pour tous les types de cibles géographiques qui s'appliquent à la portée du rapport.

Exemple de requête

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemple de rapport

Voici un exemple de rapport campaignTarget. Le rapport présente les performances pour une cible de géolocalisation avec "US", une zone de proximité ciblée dont le champ est "100,0 miles" (environ 160 km) (37.4220041,-122.0862462)" et une autre cible de géolocalisation avec un code postal américain (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

Cibles de remarketing pour tous les groupes d'annonces d'un compte

L'exemple de demande asynchrone suivant renvoie le nombre de clics, d'impressions et d'autres données pour toutes les cibles de remarketing définies pour les groupes d'annonces d'une campagne Google Ads spécifique.

Exemple de requête

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemple de rapport

Voici un exemple de rapport adGroupTarget. Le rapport montre que trois groupes d'annonces de la campagne "Accessoires" définissent des cibles de remarketing. Les métriques de performances de chaque cible de remarketing sont également incluses:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

Cibles d'annonces dynamiques pour tous les groupes d'annonces d'un compte

Une cible d'annonces dynamiques définit les pages de votre site sur lesquelles vous souhaitez diffuser des annonces dynamiques du Réseau de Recherche. Les cibles d'annonces dynamiques ne sont disponibles que dans les comptes de moteur Google Ads. Elles sont toujours créées dans des groupes d'annonces spécifiques. Google utilise son index de recherche pour déterminer à quel moment la recherche d'un client correspond aux pages qui correspondent à vos cibles d'annonces dynamiques. Si une recherche est pertinente, Google diffuse une annonce dynamique du Réseau de Recherche que vous avez définie dans le même groupe d'annonces que les cibles.

L'exemple de demande asynchrone suivant renvoie le nombre de clics et d'impressions, ainsi que d'autres données pour toutes les cibles d'annonces dynamiques définies pour les groupes d'annonces d'un compte associé à un moteur.

Exemple de requête

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemple de rapport

Voici un exemple de rapport adGroupTarget. Le rapport indique qu'un groupe d'annonces de la campagne "Google Store" définit une cible d'annonces dynamiques. Les métriques de performances de la cible sont également incluses:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

Créer des rapports sur les cibles géographiques à exclure pour les campagnes

L'exemple de demande asynchrone suivant renvoie les zones géographiques exclues des campagnes d'un compte de moteur (la création de rapports sur les cibles géographiques à exclure n'est disponible que pour les campagnes Google Ads). Les cibles géographiques à exclure n'utilisent que des cibles de géolocalisation comme critères (elles ne peuvent pas spécifier de zones de proximité ciblées ni de rayons cibles). Ainsi, les rapports sur les cibles géographiques à exclure ne contiennent que la liste des zones géographiques exclues des campagnes incluses dans le champ d'application du rapport.

Notez qu'il n'est pas nécessaire de spécifier une période pour une demande de rapport sur les cibles à exclure. Les rapports négatifs renvoient toujours les paramètres actuels. Par exemple, il n'est pas possible de demander un rapport indiquant les cibles négatives utilisées au cours du dernier trimestre.

Exemple de requête

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

Exemple de rapport

Voici un exemple de rapport negativeCampaignTarget. Le rapport montre que la campagne "Grandes ouvertures - NE" exclut l'État du Maine, et la campagne "Grandes ouvertures - Ouest" exclut l'État de Californie:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA