CustomAudience

Audiens kustom. Ini adalah daftar pengguna berdasarkan 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 format:

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. Nama harus unik untuk semua audiens kustom yang dibuat oleh pelanggan. Kolom ini wajib diisi untuk membuat operasi.

type

enum (CustomAudienceType)

Jenis audiens kustom. ("INTEREST" ATAU "PURCHASE_INTENT" tidak diizinkan untuk audiens kustom yang baru dibuat, tetapi dipertahankan untuk audiens yang sudah ada)

description

string

Deskripsi audiens kustom ini.

members[]

object (CustomAudienceMember)

Daftar anggota audiens kustom yang membentuk audiens kustom ini. Anggota dapat ditambahkan selama pembuatan CustomAudience. Jika anggota ditampilkan dalam operasi UPDATE, anggota yang ada akan diganti.

CustomAudienceStatus

Enum yang berisi kemungkinan status audiens kustom.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Merepresentasikan nilai yang tidak diketahui dalam 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 yang ditampilkan. Merepresentasikan nilai yang tidak diketahui dalam 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 pelajari atau produk yang mereka pertimbangkan untuk dibeli.
SEARCH Mencocokkan pengguna berdasarkan penelusuran mereka di Google Penelusuran.

CustomAudienceMember

Anggota audiens kustom. Anggota dapat berupa KATA KUNCI, URL, PLACE_CATEGORY, atau APP. 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, KEYWORD, URL, PLACE_CATEGORY, atau APP.

Kolom union value. Nilai CustomAudienceMember. Satu kolom diisi bergantung pada jenis anggota. value hanya dapat berupa salah satu dari berikut:
keyword

string

Kata kunci atau frasa kata kunci — maksimal 10 kata dan 80 karakter. Bahasa dengan karakter berukuran ganda seperti China, Jepang, atau Korea, diizinkan 40 karakter, yang menjelaskan minat atau tindakan pengguna.

url

string

URL HTTP, termasuk protokol — maksimal 2.048 karakter, yang menyertakan konten yang diminati pengguna.

placeCategory

string (int64 format)

Jenis tempat yang dijelaskan oleh 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 yang ditampilkan. Merepresentasikan nilai yang tidak diketahui dalam versi ini.
KEYWORD Pengguna yang minat atau tindakannya dijelaskan oleh kata kunci.
URL Pengguna yang memiliki minat terkait konten situs.
PLACE_CATEGORY Pengguna yang mengunjungi jenis tempat yang dijelaskan oleh kategori tempat.
APP Pengguna yang telah menginstal aplikasi seluler.