Method: customers.generateAudienceOverlapInsights

Zwraca zbiór atrybutów odbiorców wraz z szacowanymi wartościami ich potencjalnego zasięgu w YouTube i danego atrybutu wejściowego.

Lista błędów: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagany. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Pola
countryLocation

object (LocationInfo)

Wymagany. Kraj, w którym mają być obliczane rozmiary i nakładanie się list odbiorców.
primaryAttribute

object (AudienceInsightsAttribute)

Wymagany. Atrybut listy odbiorców, który powinien być przecinany ze wszystkimi innymi odpowiednimi listami odbiorców. Musi to być grupa odbiorców na podstawie podobieństwa, grupa odbiorców na podstawie zainteresowań na rynku, przedział wiekowy lub płeć.
dimensions[]

enum (AudienceInsightsDimension)

Wymagany. Typy atrybutów, dla których ma być obliczone pokrycie z atrybutem podstawowym. Wartości muszą być podzbiorem wartości AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE i GENDER.
customerInsightsGroup

string

Nazwa klienta, dla którego planujesz kampanię. Jest to wartość zdefiniowana przez użytkownika.

Treść odpowiedzi

Odpowiedź na pytanie „AudienceInsightsService.GenerateAudienceOverlapInsights”.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Pola
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

metadane atrybutu głównego, w tym potencjalny zasięg w YouTube;
dimensionResults[]

object (DimensionOverlapResult)

Listy atrybutów i ich pokrycia atrybutem głównym, po jednej liście na każdy żądany wymiar.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

DimensionOverlapResult

Lista atrybutów listy odbiorców w ramach jednego wymiaru, w tym ich pokrycia z atrybutem głównym, zwracana w ramach elementu GenerateAudienceOverlapInsightsResponse.

Zapis JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Pola
dimension

enum (AudienceInsightsDimension)

Wymiar wszystkich atrybutów w tej sekcji.
items[]

object (AudienceOverlapItem)

atrybuty i ich pokrycie z atrybutem głównym.

AudienceOverlapItem

Atrybut listy odbiorców z metadanymi, w tym z danymi o nakładaniu się potencjalnego zasięgu tego atrybutu w YouTube i atrybutu głównego.

Zapis JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Pola
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Atrybut i jego metadane, w tym potencjalny zasięg w YouTube.
potentialYoutubeReachIntersection

string (int64 format)

Szacowany rozmiar przecięcia tego atrybutu listy odbiorców z atrybutem głównym, czyli liczba dostępnych użytkowników YouTube, którzy pasują DO OBYDWODÓW atrybutów.