Method: customers.generateAudienceOverlapInsights

Renvoie un ensemble d'attributs d'audience, ainsi que des estimations du chevauchement entre leur couverture YouTube potentielle et celle d'un attribut d'entrée donné.

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}:generateAudienceOverlapInsights

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 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Champs
countryLocation

object (LocationInfo)

Obligatoire. Pays dans lequel calculer les tailles et les chevauchements des audiences.
primaryAttribute

object (AudienceInsightsAttribute)

Obligatoire. Attribut d'audience à chevaucher avec toutes les autres audiences éligibles. Il doit s'agir d'un UserInterest d'affinité ou sur le marché, d'une tranche d'âge ou d'un genre.
dimensions[]

enum (AudienceInsightsDimension)

Obligatoire. Types d'attributs pour lesquels calculer le chevauchement avec l'attribut primaryAttribute. Les valeurs doivent être un sous-ensemble de AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE et GENDER.
customerInsightsGroup

string

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.GenerateAudienceOverlapInsights.

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

Représentation JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Champs
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Métadonnées de l'attribut principal, y compris la couverture potentielle sur YouTube.
dimensionResults[]

object (DimensionOverlapResult)

Listes d'attributs et de leurs chevauchements avec l'attribut principal, une liste par dimension demandée.

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.

DimensionOverlapResult

Liste des attributs d'audience d'une seule dimension, y compris leur chevauchement avec un attribut principal, renvoyée dans le cadre d'une GenerateAudienceOverlapInsightsResponse.

Représentation JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Champs
dimension

enum (AudienceInsightsDimension)

La dimension de tous les attributs dans cette section.
items[]

object (AudienceOverlapItem)

Les attributs et leur chevauchement avec l'attribut principal.

AudienceOverlapItem

Un attribut d'audience, avec des métadonnées incluant le chevauchement entre la couverture potentielle de cet attribut sur YouTube et celle d'un attribut principal

Représentation JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Champs
attributeMetadata

object (AudienceInsightsAttributeMetadata)

L'attribut et ses métadonnées, y compris la couverture potentielle sur YouTube
potentialYoutubeReachIntersection

string (int64 format)

Taille estimée de l'intersection de cet attribut d'audience avec l'attribut principal, c'est-à-dire le nombre d'utilisateurs YouTube accessibles qui correspondent à la fois à l'attribut principal et à celui-ci.