Method: customers.generateInsightsFinderReport

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/v14/customers/{customerId}:generateInsightsFinderReport

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Kolom
baselineAudience

object (BasicInsightsAudience)

Wajib. Audiens dasar untuk laporan ini, biasanya semua orang di suatu wilayah.
specificAudience

object (BasicInsightsAudience)

Wajib. Audiens spesifik yang diminati untuk laporan ini. Insight dalam laporan akan didasarkan pada atribut yang lebih umum di audiens ini dibandingkan di audiens dasar laporan.
customerInsightsGroup

string

Nama pelanggan yang direncanakan. Nilai ini adalah nilai yang ditentukan 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

string

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 analisis.

Representasi JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Kolom
countryLocation[]

object (LocationInfo)

Wajib. Negara untuk audiens ini.
subCountryLocations[]

object (LocationInfo)

Atribut lokasi geografis sub-negara. Jika ada, masing-masing harus berada di salah satu negara di audiens ini.
gender

object (GenderInfo)

Gender untuk audiens. Jika tidak ada, audiens tidak akan dibatasi berdasarkan gender.
ageRanges[]

object (AgeRangeInfo)

Rentang usia untuk audiens. Jika tidak ada, audiens mewakili semua orang berusia di atas 18 tahun yang cocok dengan atribut lainnya.
userInterests[]

object (UserInterestInfo)

Minat pengguna yang menentukan audiens ini. Audiens Minat dan Berniat Beli didukung.
topics[]

object (AudienceInsightsTopic)

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 topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Kolom
Kolom union topic. Atribut entitas atau kategori. topic hanya ada berupa salah satu diantara berikut:
entity

object (AudienceInsightsEntity)

Entitas Pustaka Pengetahuan
category

object (AudienceInsightsCategory)

Kategori Produk & Layanan