- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- BasicInsightsAudience
- AudienceInsightsTopic
- Deneyin.
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/v15/customers/{customerId}:generateInsightsFinderReport
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
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 ( |
Alanlar | |
---|---|
baselineAudience |
Zorunlu. Bu rapor için temel kitle. Bu genellikle bir bölgedeki tüm kullanıcılardır. |
specificAudience |
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 |
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 |
İ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 ( |
Alanlar | |
---|---|
countryLocation[] |
Zorunlu. Bu kitlenin ülkeleri. |
subCountryLocations[] |
Ülke alt bölgesi coğrafi konum özellikleri. Bu gruplar varsa bunların her biri, bu kitledeki ülkelerden birinde yer almalıdır. |
gender |
Kitlenin cinsiyeti. Kitle yoksa cinsiyete göre kısıtlama yapılmaz. |
ageRanges[] |
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[] |
Bu kitleyi tanımlayan kullanıcı ilgi alanları. Yakın ilgi alanı kitleleri ve Pazardaki kitleler desteklenir. |
topics[] |
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 |
Alanlar | |
---|---|
topic alanı. Bir varlık veya kategori özelliği. topic şunlardan yalnızca biri olabilir: |
|
entity |
Bilgi Grafiği öğesi |
category |
Ürün ve Hizmet kategorisi |