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/v15/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. Par défaut, si elle n'est pas spécifiée, 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 sur les données des 30 derniers jours s'affichent.
customerInsightsGroup

string

Facultatif. Nom du client pour lequel effectuer la planification. Cette valeur est 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 susceptibles d'ê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 pouvant être ciblée 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é. Tous ces attributs sont associés à la dimension GEO_TARGET_COUNTRY ou SUB_COUNTRY_LOCATION.
ageRanges[]

object (AgeRangeInfo)

Ciblage par tranche d'âge suggéré. Le champ peut être vide si le champ n'indique pas de ciblage par tranche d'âge.
gender

object (GenderInfo)

Ciblage par genre suggéré. S'il est présent, cet attribut est associé à la dimension 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 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 égal à zéro si ce ratio n'est pas défini ou n'est pas significatif.
potentialYoutubeReach

string (int64 format)

Estimation approximative du nombre d'utilisateurs que vous pouvez toucher sur YouTube avec ce ciblage.