Method: customers.generateInsightsFinderReport

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

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

HTTP isteği

POST https://googleads.googleapis.com/v16/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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

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

object (BasicInsightsAudience)

Zorunlu. Bu raporun temel kitlesi, genellikle bir bölgedeki herkestir.
specificAudience

object (BasicInsightsAudience)

Zorunlu. Bu raporla ilgilenen spesifik 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

Insights Finder kullanıcı arayüzüne, isteğe göre doldurulan rapor girişleriyle bir 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 kitle için ülkeler.
subCountryLocations[]

object (LocationInfo)

Alt ülke coğrafi konum özellikleri. Varsa bunların her biri bu kitledeki ülkelerden birinde yer almalıdır.
gender

object (GenderInfo)

Kitlenin cinsiyeti. Yoksa kitle, cinsiyete göre kısıtlamaz.
ageRanges[]

object (AgeRangeInfo)

Kitlenin yaş aralıkları. Yoksa kitle, diğer özelliklerle eşleşen 18 yaşından büyük tüm kişileri 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 öğeleri ve/veya Ürün ve Hizmet kategorileriyle temsil edilen konular.

AudienceInsightsTopic

Bir kitleyi tanımlayan bir 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
Birleştirme alanı topic. 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