Method: customers.generateSuggestedTargetingInsights

Affiche un ensemble d'insights sur le ciblage (par exemple, les audiences pouvant être ciblées) qui sont 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/v17/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 qui vous intéresse 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 d'un mois de données historiques à utiliser pour les insights, au format "aaaa-mm". Si cette règle n'est pas configurée, les insights sont renvoyés pour les 30 derniers jours de données.
customerInsightsGroup

string

Facultatif. Nom du client prévu. 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)

Suggestions d'insights 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 susceptible d'être ciblée, correspondant à 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 peut être vide, indiquant qu'il n'y a pas de ciblage par tranche d'âge.
gender

object (GenderInfo)

Ciblage par sexe suggéré. Si cet attribut est présent, la dimension est GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Suggestions de segments d'audience à 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 pouvant être touchée à l'aide du ciblage suggéré.
index

number

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

string (int64 format)

Estimation du nombre approximatif d'utilisateurs que vous pouvez toucher sur YouTube à l'aide de ce ciblage.