Method: customers.generateAudienceOverlapInsights

Zwraca zbiór atrybutów odbiorców wraz z szacunkami 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

Wymagane. 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)

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

object (AudienceInsightsAttribute)

Wymagane. 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)

Wymagane. 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 planowane jest utworzenie konta. Jest to wartość definiowana przez użytkownika.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą 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 artykule Omówienie OAuth 2.0.

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 pokrywają się z atrybutem głównym.

AudienceOverlapItem

Atrybut odbiorców zawierający metadane obejmujące pokrywanie się potencjalnego zasięgu tego atrybutu w YouTube i tego 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 podstawowym, czyli liczba dostępnych użytkowników YouTube, którzy pasują DO OBYDWODÓW atrybutów.