Extraire des données géographiques pour les tests

Pour les extractions de données automatisées ou à grande échelle pour les tests GeoX, vous devez utiliser l'API Google Ads pour extraire les données sur les coûts et les dépenses. Vous devrez les combiner avec des données brutes, non filtrées et non attribuées sur les conversions ou les revenus provenant de votre CRM interne, d'un point de vente ou de bases de données de ventes internes.

Pour extraire avec précision les données sur les campagnes et les données de coût par segments géographiques, suivez cette architecture :

  • Service : utilisez GoogleAdsService, en particulier les méthodes Search ou SearchStream.

  • Ressource : interrogez geographic_view pour voir où l'utilisateur se trouvait physiquement ou ce qui l'intéressait, ce qui est généralement la norme pour les tests GeoX. Vous pouvez également interroger les location_view pour afficher les performances en fonction des zones géographiques spécifiques ciblées par la campagne.

  • Champs à inclure :

  • Exemple de requête GAQL : pour GeoX, les annonceurs doivent extraire les métriques de coût à l'aide de l'API Google Ads plutôt que des conversions attribuées (qui doivent provenir d'un CRM interne ou de systèmes tiers). Vous pouvez utiliser la requête suivante :

    SELECT
  campaign.id,
  segments.date,
  segments.geo_target_city,
  metrics.cost_micros
FROM geographic_view
WHERE segments.date DURING LAST_30_DAYS

Post-traitement et extraction des données

  • Mappage des segments géographiques : l'API ne renvoie pas de noms en texte brut (comme "New York") ni de codes courts (comme "501" ou "ES") dans les vues de rapport. Les champs tels que segments.geo_target_city ou segments.geo_target_country renvoient une chaîne de nom de ressource pointant vers un GeoTargetConstant (par exemple, geoTargetConstants/1023191). Les développeurs peuvent interroger directement la geo_target_constant table :

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    Vous pouvez également effectuer la jointure localement dans le code en téléchargeant le fichier CSV des cibles géo graphiques statiques sur la page Cibles géographiques.

  • Conversion des coûts : l'API renvoie les valeurs de coût en micros. Vous devez diviser metrics.cost_micros par 1 000 000 pour obtenir la valeur de devise standard requise dans votre fichier d'importation.

Codes de ciblage (zone de marché désignée et pays)

Lors de l'exécution de mutations de ciblage, les annonceurs doivent rechercher et transmettre l'ID GeoTargetConstant exact pour les régions sélectionnées. Vous ne pouvez pas transmettre de codes ISO ou Nielsen bruts.

Type de région ID d'API requis (GeoTargetConstant) Ancien format (ne pas utiliser)
Zone de marché désignée ID 200501 (pour New York) Code Nielsen (par exemple, 501 pour New York)
Pays ID 2724 (pour l'Espagne) Code ISO (par exemple, "ES" pour l'Espagne)

Bonnes pratiques et erreurs de mise en forme courantes

  • Mise en forme des dates : le champ segments.date renvoie les données au format YYYY-MM-DD. Les applications de feuilles de calcul comme Excel modifient souvent automatiquement les formats de date. Importez d'abord votre fichier dans Google Sheets pour vous assurer que la plage de dates est lue avec précision au format YYYY-MM-DD requis.
  • Zéros non significatifs : assurez-vous que les zéros non significatifs des codes postaux (par exemple, 01234) ne sont pas supprimés. Utilisez le "Format numérique personnalisé" dans Google Sheets pour forcer une chaîne à cinq chiffres.
  • Agrégation : si vous effectuez une étude multicellulaire, vous devez fournir des métriques de dépenses distinctes pour chaque groupe de traitement.
  • Jointure des données de conversion : lorsque vous effectuez une jointure avec des données de conversion provenant d'un système CRM interne ou de bases de données de ventes internes, assurez-vous que les données de conversion présentent les propriétés suivantes pour garantir un traitement fluide des données avec les données de l'API Google Ads et GeoX :
    • Séries temporelles quotidiennes : les données doivent être agrégées par jour.
    • Niveau géographique : chaque conversion doit être associée aux unités géographiques exactes que vous testez (par exemple, en faisant correspondre le code postal de livraison du client à la zone de marché désignée ou au groupe de codes postaux utilisé dans la conception).
    • Valeurs brutes : les données doivent être des valeurs absolues non négatives, telles que le revenu brut ou le nombre brut de conversions. Si votre CRM suit le revenu net avec des valeurs négatives pour les remboursements, vous devez utiliser les chiffres bruts pour le test et appliquer un taux de remboursement ultérieurement.