CustomAudience

Audiens kustom. Ini adalah daftar pengguna menurut minat.

Representasi JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource audiens kustom. Nama resource audiens kustom memiliki bentuk:

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Hanya output. ID audiens kustom.
status

enum (CustomAudienceStatus)

Hanya output. Status audiens kustom ini. Menunjukkan apakah audiens kustom diaktifkan atau dihapus.
name

string

Nama audiens kustom. ID ini harus unik untuk semua audiens kustom yang dibuat oleh pelanggan. Kolom ini wajib diisi untuk membuat operasi.
type

enum (CustomAudienceType)

Jenis audiens kustom. ("MINAT" ATAU "PURCHASE_INTENT" tidak diizinkan untuk audiens kustom yang baru dibuat, tetapi disimpan untuk audiens yang sudah ada)
description

string

Deskripsi audiens kustom ini.
members[]

object (CustomAudienceMember)

Daftar anggota audiens kustom yang terdiri dari audiens kustom ini. Anggota dapat ditambahkan selama pembuatan CustomAudience. Jika anggota disajikan dalam operasi UPDATE, anggota yang sudah ada akan diganti.

CustomAudienceStatus

Enum yang berisi kemungkinan status audiens kustom.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
ENABLED Status diaktifkan - audiens kustom diaktifkan dan dapat ditargetkan.
REMOVED Status dihapus - audiens kustom dihapus dan tidak dapat digunakan untuk penargetan.

CustomAudienceType

Enum yang berisi kemungkinan jenis audiens kustom.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
AUTO Google Ads akan otomatis memilih interpretasi terbaik pada waktu penayangan.
INTEREST Mencocokkan pengguna berdasarkan minat mereka.
PURCHASE_INTENT Mencocokkan pengguna berdasarkan topik yang mereka cari informasinya atau produk yang mereka pertimbangkan untuk dibeli.
SEARCH Mencocokkan pengguna menurut apa yang mereka telusuri di Google Penelusuran.

CustomAudienceMember

Anggota audiens kustom. Anggota dapat berupa KATA KUNCI, URL, PLACE_CATEGORY, atau APLIKASI. Anggota hanya dapat dibuat atau dihapus, tetapi tidak dapat diubah.

Representasi JSON 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Kolom
memberType

enum (CustomAudienceMemberType)

Jenis anggota audiens kustom, KATA KUNCI, URL, PLACE_CATEGORY, atau APP.
Kolom union value. Nilai CustomAudienceMember. Satu kolom diisi bergantung pada jenis anggota. value hanya ada berupa salah satu diantara berikut:
keyword

string

Frasa kata kunci atau kata kunci — maksimal 10 kata dan 80 karakter. Bahasa dengan karakter berukuran ganda seperti China, Jepang, atau Korea, diizinkan sebanyak 40 karakter, yang menggambarkan minat atau tindakan pengguna.
url

string

URL HTTP, disertakan protokol — maksimal 2.048 karakter, yang mencakup konten yang diminati pengguna.
placeCategory

string (int64 format)

Jenis tempat yang dijelaskan menurut kategori tempat yang dikunjungi pengguna.
app

string

Nama paket aplikasi Android yang diinstal pengguna, seperti com.google.example.

CustomAudienceMemberType

Enum yang berisi kemungkinan jenis anggota audiens kustom.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
KEYWORD Pengguna yang minat atau tindakannya dijelaskan oleh kata kunci.
URL Pengguna yang memiliki minat yang berkaitan dengan konten situs.
PLACE_CATEGORY Pengguna yang mengunjungi jenis tempat yang dijelaskan menurut kategori tempat.
APP Pengguna yang telah menginstal aplikasi seluler.