Method: customers.generateInsightsFinderReport

Insights Finder aracında görüntülenebilecek kayıtlı bir rapor oluşturur.

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

HTTP isteği

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

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 gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Alanlar
baselineAudience

object (BasicInsightsAudience)

Zorunlu. Bu rapor için temel kitle. Bu genellikle bir bölgedeki tüm kullanıcılardır.
specificAudience

object (BasicInsightsAudience)

Zorunlu. Bu rapor için ilgili kitle. Rapordaki analizler, raporun temel kitlesinde olduğundan bu kitlede daha yaygın olan özellikleri temel alır.
customerInsightsGroup

string

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

Yanıt gövdesi

Raporun paylaşılabilir URL'sini içeren AudienceInsightsService.GenerateInsightsFinderReport için yanıt mesajı.

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

JSON gösterimi 
{
  "savedReportUrl": string
}
Alanlar
savedReportUrl

string

İsteğe göre doldurulan rapor girişleriyle Insights Finder kullanıcı arayüzüne derin bağlantı sağlayan HTTPS URL'si.

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ı makaleye bakın.

BasicInsightsAudience

Analiz istemek için kullanılan kitlenin açıklaması.

JSON gösterimi 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Alanlar
countryLocation[]

object (LocationInfo)

Zorunlu. Bu kitlenin ülkeleri.
subCountryLocations[]

object (LocationInfo)

Ülke alt bölgesi coğrafi konum özellikleri. Bu gruplar varsa bunların her biri, bu kitledeki ülkelerden birinde yer almalıdır.
gender

object (GenderInfo)

Kitlenin cinsiyeti. Kitle yoksa cinsiyete göre kısıtlama yapılmaz.
ageRanges[]

object (AgeRangeInfo)

Kitle için yaş aralıkları. Yoksa kitle, diğer özelliklerle eşleşen 18 yaşından büyük tüm kullanıcıları temsil eder.
userInterests[]

object (UserInterestInfo)

Bu kitleyi tanımlayan kullanıcı ilgi alanları. Yakın ilgi alanı kitleleri ve Pazardaki kitleler desteklenir.
topics[]

object (AudienceInsightsTopic)

Bu kitlenin ilgilendiği Bilgi Grafiği varlıkları ve/veya Ürün ve Hizmet kategorileriyle temsil edilen konular.

AudienceInsightsTopic

Bir kitleyi tanımlayan konuyu temsil eden varlık veya kategori.

JSON gösterimi 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Alanlar
topic alanı. Bir varlık veya kategori özelliği. topic şunlardan yalnızca biri olabilir:
entity

object (AudienceInsightsEntity)

Bilgi Grafiği öğesi
category

object (AudienceInsightsCategory)

Ürün ve Hizmet kategorisi