Segmentation

La segmentation est disponible dans l'interface utilisateur Google Ads dans un menu distinct. Vous pouvez implémenter la segmentation dans l'API Google Ads en ajoutant le champ approprié à une requête. Par exemple, supposons que vous ajoutiez segments.device à une requête. Le rapport obtenu comporte une ligne pour chaque combinaison d'appareil et de ressource spécifiée dans la clause FROM, et les valeurs statistiques (impressions, clics, conversions, etc.) sont réparties entre elles.

Dans l'UI Google Ads, vous ne pouvez utiliser qu'un seul segment à la fois, mais avec l'API, vous pouvez spécifier plusieurs segments dans la même requête.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

L'envoi de cette requête à GoogleAdsService.SearchStream génère une chaîne JSON semblable à celle-ci :

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    }
  ]
}

Dans cet exemple de résultat, les attributs du premier et du deuxième objet, y compris le nom de la ressource, sont identiques. Les impressions sont segmentées par appareil. Par conséquent, deux objets ou plus peuvent être renvoyés pour la même campagne.

Segmentation implicite

Chaque rapport est initialement segmenté par la ressource spécifiée dans la clause FROM. Le champ resource_name de la ressource dans la clause FROM est renvoyé et les métriques sont segmentées par ce champ, même lorsqu'il resource_namen'est pas explicitement inclus dans la requête. Par exemple, lorsque vous spécifiez ad_group comme ressource dans la clause FROM, ad_group.resource_name est automatiquement renvoyé et les métriques sont segmentées de manière implicite par rapport à celui-ci au niveau ad_group.

Pour cette requête :

SELECT metrics.impressions
FROM ad_group

Vous obtenez une chaîne JSON comme celle-ci :

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

Le champ resource_name de adGroup est toujours renvoyé, car ad_group est spécifié comme ressource dans la clause FROM.

search_term_view

La ressource search_term_view est également segmentée de manière implicite par groupe d'annonces, et pas seulement par terme de recherche, comme le reflète la structure de son nom de ressource, qui inclut également le groupe d'annonces. Par conséquent, vous pouvez recevoir des lignes qui semblent en double avec les mêmes termes de recherche dans vos résultats, lorsque ces lignes appartiennent à différents groupes d'annonces :

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

Bien que les deux objets renvoyés dans cet exemple semblent être des doublons, leurs noms de ressources sont en fait différents, en particulier au niveau de l'ID du groupe d'annonces. Cela signifie que le terme de recherche "google photos" est attribué à deux groupes d'annonces (ID 2222222222 et 33333333333) à la même date (2024-06-15). L'API a donc fonctionné comme prévu et n'a pas renvoyé d'objets en double dans ce cas.

Champs de segment sélectionnables

Les champs de segment ne peuvent pas tous être sélectionnés pour une ressource donnée dans la clause FROM. Par exemple, supposons que vous continuiez à interroger la ressource ad_group. Pour qu'un champ de segment puisse être sélectionné à partir de la ressource ad_group, il doit figurer dans la liste Segments pour ad_group. La liste Segments correspond à la partie jaune du tableau des champs disponibles sur la page des métadonnées de la ressource ad_group.

Ressources de segment

Lorsque vous sélectionnez des ressources, vous pouvez avoir la possibilité d'effectuer une jointure implicite sur les ressources associées en sélectionnant leurs champs en même temps que ceux de la ressource dans la clause FROM. Ces ressources associées sont disponibles dans la liste Attributed Resources de la ressource sur la page des métadonnées de la clause FROM. Dans le cas de la ressource ad_group, vous verrez que vous pouvez également sélectionner des champs à partir de la ressource campaign. Le champ resource_name de tout Attributed Resources comportant au moins un champ dans la clause SELECT est renvoyé automatiquement, même lorsque le champ resource_name n'est pas explicitement inclus dans la requête.

Comme pour la sélection des champs Attributed Resource, vous pouvez également sélectionner des champs Segmenting Resource. Si une ressource donnée comporte une liste Segmenting Resources sur sa page de métadonnées, la sélection de champs à partir de l'une de ces ressources listées entraîne une segmentation plus poussée de la requête par le resource_name renvoyé de ce Segmenting Resource. Par exemple, vous constaterez que la ressource campaign est listée comme Segmenting Resource pour la ressource campaign_budget. Si vous sélectionnez un champ de campagne, comme campaign.name, à partir de la ressource campaign_budget, le champ campaign.name est renvoyé, mais le champ campaign.resource_name est également renvoyé et segmenté.

Possibilité de sélectionner des segments et des métriques

Il est possible qu'un champ de segment donné ne soit pas compatible avec certains autres champs de segment ou avec certains champs de métrique. Pour identifier les champs de segment compatibles entre eux, consultez la liste selectable_with des segments dans la clause SELECT.

Dans le cas de la ressource ad_group, vous pouvez sélectionner plus de 50 segments disponibles. Toutefois, la liste selectable_with pour segments.hotel_check_in_date est un ensemble beaucoup plus petit de segments compatibles. Cela signifie que si vous ajoutez le champ segments.hotel_check_in_date à la clause SELECT, vous limitez les segments disponibles que vous pouvez encore sélectionner à l'intersection de ces deux listes.

Contraintes de segment conjointes

Certains champs de segment sont soumis à des contraintes de sélection explicites qui les obligent à être demandés avec un segment parent dans la clause SELECT :

• Si vous sélectionnez segments.ad_sub_network_type (qui détaille les sous-réseaux publicitaires YouTube tels que InStream, In-Feed et Shorts), vous devez également sélectionner segments.ad_network_type.
• Dans la version 25 et les versions ultérieures, si vous sélectionnez segments.ad_sub_format_type (qui répartit les annonces InStream YouTube non désactivables par durée), vous devez également sélectionner segments.ad_format_type.

Filtrage implicite par sélection de segment

Lorsque vous sélectionnez certains champs de segment dans votre requête, l'API Google Ads peut filtrer implicitement les résultats pour n'inclure que les lignes où ce segment est applicable et a une valeur.

Impact de segments.keyword.*

Un exemple courant et important de ce comportement se produit lorsque vous sélectionnez un champ sous segments.keyword (tel que segments.keyword.info.text et segments.keyword.ad_group_criterion) :

• Exclusion du trafic non lié aux mots clés : si vous incluez un champ segments.keyword.* dans votre clause SELECT, les résultats seront limités aux lignes directement associées à un critère de groupe d'annonces de mot clé du Réseau de Recherche.
• Types de campagnes concernés : par conséquent, les données des types de campagnes ou des groupes d'annonces qui ne reposent pas sur des mots clés de recherche sont exclues des résultats. Cela inclut, sans s'y limiter :
  • Annonces dynamiques du Réseau de Recherche (ADR) : les cibles d'ADR sont basées sur le contenu du site Web plutôt que sur les mots clés.
  • Campagnes Shopping : elles utilisent des groupes de produits au lieu de mots clés.
  • Campagnes Performance Max : bien que Performance Max puisse être diffusé sur le Réseau de Recherche, ses rapports ne sont généralement pas segmentés selon les mêmes critères de mots clés.
• Réseau Display : les champs segments.keyword.* concernent les mots clés utilisés sur le Réseau de Recherche. Ils ne sont pas segmentés par mots clés du Réseau Display ni par d'autres méthodes de ciblage display.

Règles pour les segments dans la clause WHERE

Lorsqu'un segment se trouve dans la clause WHERE, il doit également se trouver dans la clause SELECT. Les segments de date suivants font exception à cette règle et sont appelés segments de date principaux :

• segments.date
• segments.week
• segments.month
• segments.quarter
• segments.year

Règles pour les champs de segment de date principaux

Les segments segments.date, segments.week, segments.month, segments.quarter et segments.year fonctionnent comme suit :

• Ces segments peuvent être filtrés dans la clause WHERE sans apparaître dans la clause SELECT.
• Si l'un de ces segments figure dans la clause SELECT, une plage de dates finie composée de segments de date principaux doit être spécifiée dans la clause WHERE. Les segments de date ne doivent pas nécessairement être les mêmes que ceux spécifiés dans SELECT.

Exemples

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date >= '2024-01-01'
  AND segments.date <= '2024-01-31'

SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year >= 2020
  AND segments.year <= 2024