- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- BasicInsightsAudience
- AudienceInsightsTopic
- Cobalah!
Membuat laporan tersimpan yang dapat dilihat di alat Insights Finder.
Daftar error yang ditampilkan: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Permintaan HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
customerId |
Wajib. ID pelanggan. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "baselineAudience": { object ( |
Kolom | |
---|---|
baselineAudience |
Wajib. Audiens dasar untuk laporan ini, biasanya semua orang di suatu wilayah. |
specificAudience |
Wajib. Audiens spesifik yang diminati untuk laporan ini. Insight dalam laporan akan didasarkan pada atribut yang lebih umum di audiens ini daripada di audiens dasar laporan. |
customerInsightsGroup |
Nama pelanggan yang direncanakan. Nilai ini ditentukan oleh pengguna. |
Isi respons
Pesan respons untuk AudienceInsightsService.GenerateInsightsFinderReport
, yang berisi URL yang dapat dibagikan untuk laporan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "savedReportUrl": string } |
Kolom | |
---|---|
savedReportUrl |
URL HTTPS yang menyediakan deep link ke UI Insights Finder dengan input laporan yang diisi sesuai dengan permintaan. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/adwords
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
BasicInsightsAudience
Deskripsi audiens yang digunakan untuk meminta insight.
Representasi JSON |
---|
{ "countryLocation": [ { object ( |
Kolom | |
---|---|
countryLocation[] |
Wajib. Negara untuk audiens ini. |
subCountryLocations[] |
Atribut lokasi geografis sub-negara. Jika ada, masing-masing harus terdapat di salah satu negara dalam audiens ini. |
gender |
Gender untuk audiens. Jika tidak ada, penonton tidak akan dibatasi berdasarkan gender. |
ageRanges[] |
Rentang usia untuk audiens. Jika tidak ada, audiens mewakili semua pengguna berusia di atas 18 tahun yang cocok dengan atribut lainnya. |
userInterests[] |
Minat pengguna menentukan audiens ini. Audiens Minat dan Berniat Beli didukung. |
topics[] |
Topik, yang diwakili oleh entitas Pustaka Pengetahuan dan/atau kategori Produk & Layanan, yang diminati audiens ini. |
AudienceInsightsTopic
Entitas atau kategori yang mewakili topik yang menentukan audiens.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union topic . Atribut entitas atau kategori. topic hanya ada berupa salah satu diantara berikut: |
|
entity |
Entitas Pustaka Pengetahuan |
category |
Kategori Produk & Layanan |