Method: customers.generateSuggestedTargetingInsights

Affiche un ensemble d'insights sur le ciblage (par exemple, les audiences pouvant être ciblées) pertinents pour l'audience demandée.

Liste des erreurs générées: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Requête HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Champs
audience

object (InsightsAudience)

Obligatoire. Audience pour laquelle des insights sont demandés.
baselineAudience

object (InsightsAudience)

Facultatif. Audience de référence. Si aucune valeur n'est spécifiée, la valeur par défaut inclut toutes les personnes situées dans le même pays que l'audience qui vous intéresse.
dataMonth

string

Facultatif. Plage de données historiques d'un mois à utiliser pour les insights, au format "aaaa-mm". Si cette règle n'est pas configurée, les insights s'affichent pour les 30 derniers jours de données.
customerInsightsGroup

string

Facultatif. Nom du client pour lequel la planification est effectuée. Il s'agit d'une valeur définie par l'utilisateur.

Corps de la réponse

Message de réponse pour AudienceInsightsService.GenerateSuggestedTargetingInsights.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Champs
suggestions[]

object (TargetingSuggestionMetrics)

Insights suggérés pour les audiences pouvant être ciblées.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

TargetingSuggestionMetrics

Une suggestion d'audience disponible pour le ciblage en rapport avec l'audience demandée.

Représentation JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Champs
locations[]

object (AudienceInsightsAttributeMetadata)

Ciblage géographique suggéré. Ces attributs sont tous associés à la dimension GEO_TARGET_COUNTRY ou SUB_COUNTRY_LOCATION.
ageRanges[]

object (AgeRangeInfo)

Suggestion de ciblage par tranche d'âge. Ce champ peut être vide pour indiquer l'absence de ciblage par tranche d'âge.
gender

object (GenderInfo)

Suggestions de ciblage par genre. Si cet attribut est présent, la dimension GENDER est indiquée.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Segments d'audience suggérés à cibler. Ces attributs sont tous associés à la dimension AFFINITY_USER_INTEREST ou IN_MARKET_USER_INTEREST.
coverage

number

Fraction (de 0 à 1 inclus) de l'audience demandée qui peut être touchée à l'aide du ciblage suggéré.
index

number

Ratio entre la couverture et l'audience de référence, ou valeur nulle si ce ratio n'est pas défini ou n'est pas significatif.
potentialYoutubeReach

string (int64 format)

Estimation du nombre approximatif d'utilisateurs pouvant être touchés sur YouTube avec ce ciblage.