Method: customers.generateAudienceOverlapInsights

Potansiyel YouTube erişimleri ile belirli bir giriş özelliğinin erişimi arasındaki çakışma tahminlerinin yanı sıra bir kitle özelliği koleksiyonu döndürür.

Atılan hataların listesi: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşterinin kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Alanlar
countryLocation

object (LocationInfo)

Zorunlu. Kitlelerin boyutlarının ve çakışmalarının hesaplanacağı ülke.
primaryAttribute

object (AudienceInsightsAttribute)

Zorunlu. Diğer tüm uygun kitlelerle kesişmesi gereken kitle özelliği. Bu, bir Yakın İlgi Alanı veya Pazardaki Kullanıcı İlgi Alanı, bir Yaş Aralığı veya Cinsiyet olmalıdır.
dimensions[]

enum (AudienceInsightsDimension)

Zorunlu. primaryAttribute ile çakışmalarının hesaplanacağı özellik türleri. Değerler AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE ve GENDER alt kümesi olmalıdır.
customerInsightsGroup

string

Planlama yapılan müşterinin adı. Bu, kullanıcı tanımlı bir değerdir.

Yanıt gövdesi

AudienceInsightsService.GenerateAudienceOverlapInsights için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Alanlar
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Potansiyel YouTube erişimi de dahil olmak üzere birincil özelliğin meta verileri.
dimensionResults[]

object (DimensionOverlapResult)

Özellik listeleri ve bunların birincil özellikle çakıştığı, istenen her boyut için bir liste olur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

DimensionOverlapResult

Bir birincil özellikle çakışma noktaları da dahil olmak üzere tek bir boyutun kitle özelliklerinin listesi. GenerateAudienceOverlapInsightsResponse kapsamında döndürülür.

JSON gösterimi 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Alanlar
dimension

enum (AudienceInsightsDimension)

Bu bölümdeki tüm özelliklerin boyutu.
items[]

object (AudienceOverlapItem)

Özellikler ve birincil özellikle örtüşmeleri.

AudienceOverlapItem

Bu özelliğin potansiyel YouTube erişimi ile birincil özelliğin erişimi arasındaki örtüşmeyi içeren meta verilere sahip bir kitle özelliği.

JSON gösterimi 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Alanlar
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Özellik ve potansiyel YouTube erişimi dahil olmak üzere meta verileri.
potentialYoutubeReachIntersection

string (int64 format)

Bu kitle özelliğinin birincil özellikle kesişiminin tahmini boyutu, yani HEM birincil özellikle hem de bu özellikle eşleşen, erişilebilir YouTube kullanıcılarının sayısı.