Package google.ads.datamanager.v1

Indeks

IngestionService

Layanan untuk mengirim data audiens ke tujuan yang didukung.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Mengupload daftar resource AudienceMember ke Destination yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Mengupload daftar resource Event dari Destination yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Menghapus daftar resource AudienceMember dari Destination yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Mendapatkan status permintaan berdasarkan ID permintaan yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

Layanan untuk menampilkan insight tentang data pemasaran.

Fitur ini hanya tersedia untuk partner data.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

Mengambil insight data pemasaran untuk daftar pengguna tertentu.

Fitur ini hanya tersedia untuk partner data.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager

PartnerLinkService

Layanan untuk mengelola link partner.

UserListDirectLicenseService

Layanan untuk mengelola lisensi langsung daftar pengguna. Penghapusan bukan operasi yang didukung untuk UserListDirectLicenses. Pemanggil harus memperbarui status lisensi menjadi DISABLED untuk menonaktifkan lisensi.

Fitur ini hanya tersedia untuk partner data.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Membuat lisensi langsung daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
GetUserListDirectLicense

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Mengambil lisensi langsung daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
ListUserListDirectLicenses

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Mencantumkan semua lisensi langsung daftar pengguna yang dimiliki oleh akun induk.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListDirectLicense

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Memperbarui lisensi langsung daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseService

Layanan untuk mengelola lisensi global daftar pengguna. Penghapusan bukan operasi yang didukung untuk UserListGlobalLicenses. Pemanggil harus memperbarui status lisensi menjadi DISABLED untuk menonaktifkan lisensi.

Fitur ini hanya tersedia untuk partner data.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Membuat lisensi global daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
GetUserListGlobalLicense

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Mengambil lisensi global daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenseCustomerInfos

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Mencantumkan semua info pelanggan untuk lisensi global daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenses

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Mencantumkan semua lisensi global daftar pengguna yang dimiliki oleh akun induk.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListGlobalLicense

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Memperbarui lisensi global daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager

UserListService

Layanan untuk mengelola resource UserList.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

Membuat UserList.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

Menghapus UserList.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

Mendapatkan UserList.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

Mencantumkan UserList.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

Memperbarui UserList.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager

AdIdentifiers

ID dan informasi lain yang digunakan untuk mencocokkan peristiwa konversi dengan aktivitas online lainnya (seperti klik iklan).

Kolom
session_attributes

string

Opsional. Atribut sesi untuk atribusi dan pemodelan peristiwa.
gclid

string

Opsional. ID klik Google (gclid) yang terkait dengan peristiwa ini.
gbraid

string

Opsional. ID klik untuk klik yang terkait dengan peristiwa aplikasi dan berasal dari perangkat iOS mulai dari iOS14.
wbraid

string

Opsional. ID klik untuk klik yang terkait dengan peristiwa web dan berasal dari perangkat iOS mulai dari iOS14.
landing_page_device_info

DeviceInfo

Opsional. Informasi yang dikumpulkan tentang perangkat yang digunakan (jika ada) pada saat membuka situs pengiklan setelah berinteraksi dengan iklan.

AddressInfo

Informasi alamat pengguna.

Kolom
given_name

string

Wajib. Mengingat nama (depan) pengguna, semua huruf kecil, tanpa tanda baca, tanpa spasi kosong di awal atau akhir, dan di-hash sebagai SHA-256.
family_name

string

Wajib. Nama (belakang) pengguna, semua huruf kecil, tanpa tanda baca, tanpa spasi kosong di awal atau akhir, dan di-hash sebagai SHA-256.
region_code

string

Wajib. Kode wilayah 2 huruf dalam ISO-3166-1 alpha-2 dari alamat pengguna.
postal_code

string

Wajib. Kode pos alamat pengguna.

RentangUsia

Rentang usia demografi

Enum
AGE_RANGE_UNSPECIFIED Tidak ditentukan.
AGE_RANGE_UNKNOWN Tak diketahui.
AGE_RANGE_18_24 Berusia antara 18 dan 24 tahun.
AGE_RANGE_25_34 Berusia antara 25 dan 34 tahun.
AGE_RANGE_35_44 Berusia antara 35 dan 44 tahun.
AGE_RANGE_45_54 Berusia antara 45 dan 54 tahun.
AGE_RANGE_55_64 Berusia antara 55 dan 64 tahun.
AGE_RANGE_65_UP 65 tahun ke atas.

AudienceMember

Anggota audiens yang akan dioperasikan.

Kolom
destination_references[]

string

Opsional. Menentukan Destination yang akan dituju oleh anggota audiens.
consent

Consent

Opsional. Setelan izin untuk pengguna.
Kolom union data. Jenis data identifikasi yang akan dioperasikan. data hanya dapat berupa salah satu dari berikut:
user_data

UserData

Data yang disediakan pengguna yang mengidentifikasi pengguna.
pair_data

PairData

ID Publisher Advertiser Identity Reconciliation (PAIR).

Fitur ini hanya tersedia untuk partner data.
mobile_data

MobileData

Data yang mengidentifikasi perangkat seluler pengguna.
user_id_data

UserIdData

Data yang terkait dengan ID unik untuk pengguna, sebagaimana ditentukan oleh pengiklan.
ppid_data

PpidData

Data yang terkait dengan ID yang diberikan penayang.

Fitur ini hanya tersedia untuk partner data.

AwsWrappedKeyInfo

Kunci enkripsi data yang di-wrap oleh kunci AWS KMS.

Kolom
key_type

KeyType

Wajib. Jenis algoritma yang digunakan untuk mengenkripsi data.
role_arn

string

Wajib. Amazon Resource Name dari Peran IAM yang akan diasumsikan untuk akses dekripsi KMS. Harus dalam format arn:{partition}:iam::{account_id}:role/{role_name}
kek_uri

string

Wajib. URI kunci AWS KMS yang digunakan untuk mendekripsi DEK. Harus dalam format arn:{partition}:kms:{region}:{account_id}:key/{key_id} atau aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}
encrypted_dek

string

Wajib. Kunci enkripsi data terenkripsi berenkode base64.

KeyType

Jenis algoritma yang digunakan untuk mengenkripsi data.

Enum
KEY_TYPE_UNSPECIFIED Jenis kunci tidak ditentukan. Tidak boleh digunakan.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Dasar pengukuran

Kriteria dasar yang digunakan untuk membandingkan insight.

Kolom
Kolom union baseline. Lokasi dasar yang menjadi pembanding insight. baseline hanya dapat berupa salah satu dari berikut:
baseline_location

Location

Lokasi dasar permintaan. Lokasi dasar adalah daftar OR dari wilayah yang diminta.
location_auto_detection_enabled

bool

Jika disetel ke benar (true), layanan akan mencoba mendeteksi lokasi dasar untuk insight secara otomatis.

Lokasi

Lokasi dasar permintaan. Lokasi dasar berada di daftar OR kode wilayah ISO 3166-1 alpha-2 dari wilayah yang diminta.

Kolom
region_codes[]

string

Daftar kode wilayah ISO 3166-1 alpha-2.

CartData

Data keranjang yang terkait dengan peristiwa.

Kolom
merchant_id

string

Opsional. ID Merchant Center yang terkait dengan item.
merchant_feed_label

string

Opsional. Label feed Merchant Center yang terkait dengan feed item.
merchant_feed_language_code

string

Opsional. Kode bahasa dalam ISO 639-1 yang terkait dengan feed Merchant Center item tempat item Anda diupload.
transaction_discount

double

Opsional. Jumlah semua diskon yang terkait dengan transaksi.
items[]

Item

Opsional. Daftar item yang terkait dengan acara.

Setelan izin Digital Markets Act (DMA) untuk pengguna.

Kolom
ad_user_data

ConsentStatus

Opsional. Menunjukkan apakah pengguna memberikan izin untuk data pengguna iklan.
ad_personalization

ConsentStatus

Opsional. Menunjukkan apakah pengguna memberikan izin untuk personalisasi iklan.

ConsentStatus

Menunjukkan apakah pengguna memberikan, menolak, atau belum menentukan izin.

Enum
CONSENT_STATUS_UNSPECIFIED Tidak ditentukan.
CONSENT_GRANTED Diberikan.
CONSENT_DENIED Ditolak.

ContactIdInfo

Informasi tambahan jika CONTACT_ID adalah salah satu dari upload_key_types.

Kolom
match_rate_percentage

int32

Hanya output. Tingkat kecocokan untuk daftar pengguna Customer Match.
data_source_type

DataSourceType

Opsional. Tidak dapat diubah. Sumber data upload

CreatePartnerLinkRequest

Permintaan untuk membuat resource PartnerLink. Menampilkan PartnerLink.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Induk, yang memiliki kumpulan link partner ini. Format: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

Permintaan untuk membuat resource UserListDirectLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun yang memiliki daftar pengguna yang dilisensikan. Harus dalam format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_direct_license

UserListDirectLicense

Wajib. Lisensi langsung daftar pengguna yang akan dibuat.

CreateUserListGlobalLicenseRequest

Permintaan untuk membuat resource UserListGlobalLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun yang memiliki daftar pengguna yang dilisensikan. Harus dalam format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
user_list_global_license

UserListGlobalLicense

Wajib. Lisensi global daftar pengguna yang akan dibuat.

CreateUserListRequest

Pesan permintaan untuk CreateUserList.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun induk tempat daftar pengguna ini akan dibuat. Format: accountTypes/{account_type}/accounts/{account}
user_list

UserList

Wajib. Daftar pengguna yang akan dibuat.
validate_only

bool

Opsional. Jika benar, permintaan divalidasi tetapi tidak dieksekusi.

CustomVariable

Variabel kustom untuk konversi iklan.

Kolom
variable

string

Opsional. Nama variabel kustom yang akan disetel. Jika variabel tidak ditemukan untuk tujuan tertentu, variabel tersebut akan diabaikan.
value

string

Opsional. Nilai yang akan disimpan untuk variabel kustom.
destination_references[]

string

Opsional. String referensi yang digunakan untuk menentukan Event.destination_references mana yang harus dikirimi variabel kustom. Jika kosong, Event.destination_references akan digunakan.

CustomerType

Jenis pelanggan yang terkait dengan peristiwa.

Enum
CUSTOMER_TYPE_UNSPECIFIED CustomerType tidak ditentukan. Tidak boleh digunakan.
NEW Pelanggan baru bagi pengiklan.
RETURNING Pelanggan kembali ke pengiklan.
REENGAGED Pelanggan telah berinteraksi kembali dengan pengiklan.

CustomerValueBucket

Nilai pelanggan yang dinilai oleh pengiklan.

Enum
CUSTOMER_VALUE_BUCKET_UNSPECIFIED CustomerValueBucket tidak ditentukan. Tidak boleh digunakan.
LOW Pelanggan bernilai rendah.
MEDIUM Pelanggan bernilai sedang.
HIGH Pelanggan bernilai tinggi.

DataSourceType

Menunjukkan sumber data upload.

Enum
DATA_SOURCE_TYPE_UNSPECIFIED Tidak ditentukan.
DATA_SOURCE_TYPE_FIRST_PARTY Data yang diupload adalah data pihak pertama.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU Data yang diupload berasal dari biro kredit pihak ketiga.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE Data yang diupload berasal dari file pemilih pihak ketiga.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA Data yang diupload adalah data partner pihak ketiga.

DeletePartnerLinkRequest

Permintaan untuk menghapus resource PartnerLink. Menampilkan google.protobuf.Empty.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
name

string

Wajib. Nama resource link partner yang akan dihapus. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

Pesan permintaan untuk DeleteUserList.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
name

string

Wajib. Nama daftar pengguna yang akan dihapus. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
validate_only

bool

Opsional. Jika benar, permintaan divalidasi tetapi tidak dieksekusi.

Destination

Produk Google yang Anda kirimi data. Misalnya, akun Google Ads.

Kolom
reference

string

Opsional. ID untuk resource Destination ini, unik dalam permintaan. Gunakan untuk mereferensikan Destination ini di IngestEventsRequest dan IngestAudienceMembersRequest.
login_account

ProductAccount

Opsional. Akun yang digunakan untuk melakukan panggilan API ini. Untuk menambahkan atau menghapus data dari operating_account, login_account ini harus memiliki akses tulis ke operating_account. Misalnya, akun pengelola operating_account, atau akun yang memiliki tautan yang sudah dibuat ke operating_account.
linked_account

ProductAccount

Opsional. Akun yang dapat diakses oleh login_account pengguna yang memanggil, melalui penautan akun yang telah dibuat. Misalnya, login_account partner data mungkin memiliki akses ke linked_account klien. Partner dapat menggunakan kolom ini untuk mengirim data dari linked_account ke operating_account lain.
operating_account

ProductAccount

Wajib. Akun yang akan menerima data atau akun yang akan dihapus datanya.
product_destination_id

string

Wajib. Objek dalam akun produk yang akan di-ingest ke dalamnya. Misalnya, ID audiens Google Ads, ID audiens Display & Video 360, atau ID tindakan konversi Google Ads.

DeviceInfo

Informasi tentang perangkat yang digunakan (jika ada) saat peristiwa terjadi.

Kolom
user_agent

string

Opsional. String agen pengguna perangkat untuk konteks tertentu.
ip_address

string

Opsional. Alamat IP perangkat untuk konteks tertentu.

Catatan: Google Ads tidak mendukung pencocokan alamat IP untuk pengguna akhir di Wilayah Ekonomi Eropa (EEA), Inggris Raya (UK), atau Swiss (CH). Tambahkan logika untuk secara bersyarat mengecualikan pembagian alamat IP dari pengguna di wilayah tersebut dan pastikan Anda memberikan informasi yang jelas dan komprehensif kepada pengguna tentang data yang Anda kumpulkan di situs, aplikasi, dan properti Anda lainnya, serta mendapatkan izin jika diwajibkan oleh hukum atau kebijakan Google yang berlaku. Lihat halaman Tentang impor konversi offline untuk mengetahui detail selengkapnya.

Encoding

Jenis encoding informasi identifikasi yang di-hash.

Enum
ENCODING_UNSPECIFIED Jenis Encoding tidak ditentukan. Tidak boleh digunakan.
HEX Encoding hex.
BASE64 Encoding Base64.

EncryptionInfo

Informasi enkripsi untuk data yang sedang di-ingest.

Kolom
Kolom union wrapped_key. Kunci yang di-wrap yang digunakan untuk mengenkripsi data. wrapped_key hanya dapat berupa salah satu dari berikut:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Informasi kunci yang dienkapsulasi Google Cloud Platform.
aws_wrapped_key_info

AwsWrappedKeyInfo

Informasi kunci yang dienkapsulasi Amazon Web Services.

ErrorCount

Jumlah error untuk alasan error tertentu.

Kolom
record_count

int64

Jumlah catatan yang gagal diupload karena alasan tertentu.
reason

ProcessingErrorReason

Alasan error untuk data yang gagal.

ErrorInfo

Jumlah error untuk setiap jenis error.

Kolom
error_counts[]

ErrorCount

Daftar error dan jumlah per alasan error. Mungkin tidak diisi dalam semua kasus.

ErrorReason

Alasan error untuk Data Manager API. CATATAN: Enum ini tidak tetap dan nilai baru dapat ditambahkan pada masa mendatang.

Enum
ERROR_REASON_UNSPECIFIED Jangan gunakan nilai default ini.
INTERNAL_ERROR Terjadi kesalahan internal.
DEADLINE_EXCEEDED Permintaan memerlukan waktu terlalu lama untuk direspons.
RESOURCE_EXHAUSTED Terlalu banyak permintaan.
NOT_FOUND Aset tidak ditemukan.
PERMISSION_DENIED Pengguna tidak memiliki izin atau resource tidak ditemukan.
INVALID_ARGUMENT Ada masalah dengan permintaan.
REQUIRED_FIELD_MISSING Bidang wajib diisi tidak ada.
INVALID_FORMAT Format tidak valid.
INVALID_HEX_ENCODING Format nilai yang dienkode dengan HEX salah.
INVALID_BASE64_ENCODING Format nilai berenkode base64 salah.
INVALID_SHA256_FORMAT Format nilai yang dienkode dengan SHA256 salah.
INVALID_POSTAL_CODE Kode pos tidak valid.
INVALID_COUNTRY_CODE Kode negara tidak valid.
INVALID_ENUM_VALUE Nilai enum tidak dapat digunakan.
INVALID_USER_LIST_TYPE Jenis daftar pengguna tidak berlaku untuk permintaan ini.
INVALID_AUDIENCE_MEMBER Anggota audiens ini tidak valid.
TOO_MANY_AUDIENCE_MEMBERS Jumlah maksimum anggota audiens yang diizinkan per permintaan adalah 10.000.
TOO_MANY_USER_IDENTIFIERS Jumlah maksimum ID pengguna yang diizinkan per anggota audiens adalah 10.
TOO_MANY_DESTINATIONS Jumlah maksimum tujuan yang diizinkan per permintaan adalah 10.
INVALID_DESTINATION Tujuan ini tidak valid.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Partner Data tidak memiliki akses ke daftar pengguna yang dimiliki akun operasi.
INVALID_MOBILE_ID_FORMAT Format ID seluler tidak valid.
INVALID_USER_LIST_ID Daftar pengguna tidak valid.
MULTIPLE_DATA_TYPES_NOT_ALLOWED Beberapa jenis data tidak diizinkan untuk diproses dalam satu permintaan.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Konfigurasi tujuan yang berisi akun login PartnerData harus memiliki akun login yang sama di semua konfigurasi tujuan.
TERMS_AND_CONDITIONS_NOT_SIGNED Persyaratan dan ketentuan yang diperlukan tidak disetujui.
INVALID_NUMBER_FORMAT Format nomor tidak valid.
INVALID_CONVERSION_ACTION_ID ID tindakan konversi tidak valid.
INVALID_CONVERSION_ACTION_TYPE Jenis tindakan konversi tidak valid.
INVALID_CURRENCY_CODE Kode mata uang tidak didukung.
INVALID_EVENT Acara ini tidak valid.
TOO_MANY_EVENTS Jumlah maksimum peristiwa yang diizinkan per permintaan adalah 10.000.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Akun tujuan tidak diaktifkan untuk konversi yang disempurnakan untuk prospek.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Konversi yang disempurnakan tidak dapat digunakan untuk akun tujuan karena kebijakan data pelanggan Google. Hubungi perwakilan Google Anda.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Akun tujuan belum menyetujui persyaratan untuk konversi yang disempurnakan.
DUPLICATE_DESTINATION_REFERENCE Dua tujuan atau lebih dalam permintaan memiliki referensi yang sama.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Akun operasi tidak didukung untuk otorisasi partner data.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Akun tertaut yang tidak didukung untuk otorisasi partner data.
NO_IDENTIFIERS_PROVIDED Data peristiwa tidak berisi ID pengguna atau ID iklan.
INVALID_PROPERTY_TYPE Jenis properti tidak didukung.
INVALID_STREAM_TYPE Jenis streaming tidak didukung.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT Akun tertaut hanya didukung jika akun login adalah akun DATA_PARTNER.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Akun login harus sama dengan akun operasi untuk kasus penggunaan tertentu.
EVENT_TIME_INVALID Acara tidak terjadi dalam jangka waktu yang dapat diterima.
RESERVED_NAME_USED Parameter menggunakan nama yang dicadangkan.
INVALID_EVENT_NAME Nama peristiwa tidak didukung.
NOT_ALLOWLISTED Akun tidak masuk daftar yang diizinkan untuk fitur tertentu.
INVALID_REQUEST_ID ID permintaan yang digunakan untuk mengambil status permintaan tidak valid. Status hanya dapat diambil untuk permintaan yang berhasil dan tidak memiliki validate_only=true.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT Peristiwa memiliki 2 tujuan Google Analytics atau lebih.
FIELD_VALUE_TOO_LONG Nilai kolom terlalu panjang.
TOO_MANY_ELEMENTS Terlalu banyak elemen dalam daftar di permintaan.
ALREADY_EXISTS Resource sudah ada.
IMMUTABLE_FIELD_FOR_UPDATE Mencoba menyetel kolom yang tidak dapat diubah untuk permintaan pembaruan.
INVALID_RESOURCE_NAME Nama resource tidak valid.
INVALID_FILTER Filter kueri tidak valid.
INVALID_UPDATE_MASK Masker pembaruan tidak valid.
INVALID_PAGE_TOKEN Token halaman tidak valid.
CANNOT_UPDATE_DISABLED_LICENSE Tidak dapat memperbarui lisensi yang telah dinonaktifkan.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST Daftar pengguna sensitif tidak dapat dilisensikan ke klien ini.
INSUFFICIENT_COST Biaya terlalu rendah untuk lisensi ini.
CANNOT_DISABLE_LICENSE Lisensi reseller tidak dapat dinonaktifkan karena sedang digunakan.
INVALID_CLIENT_ACCOUNT_ID ID akun klien tidak valid.
PRICING_ONLY_ZERO_COST_ALLOWED Biaya tidak boleh nol untuk akun klien ini.
PRICE_TOO_HIGH Biaya terlalu tinggi untuk lisensi ini.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE Pelanggan tidak diizinkan membuat lisensi.
INVALID_PRICING_END_DATE Tanggal akhir harga tidak valid untuk lisensi ini.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT Daftar pengguna logis dengan segmen bersama atau berlisensi tidak dapat diberi lisensi.
MISMATCHED_ACCOUNT_TYPE Jenis akun pelanggan klien dalam permintaan tidak cocok dengan jenis akun pelanggan sebenarnya.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE Jenis lisensi tidak mendukung biaya berbagi media.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER Jenis pelanggan klien tidak mendukung biaya berbagi media.
INVALID_MEDIA_SHARE_COST Biaya pembagian media tidak valid.
INVALID_COST_TYPE Jenis biaya tidak valid.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST Jenis UserList tidak mendukung biaya berbagi media.
MAX_COST_NOT_ALLOWED Biaya maks hanya diizinkan untuk cost_type MEDIA_SHARE.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED Audiens e-commerce hanya dapat dilisensikan secara langsung.
INVALID_DESCRIPTION Deskripsi tidak valid.
INVALID_DISPLAY_NAME Nama tampilan tidak valid.
DISPLAY_NAME_ALREADY_USED Nama tampilan sudah digunakan untuk daftar pengguna lain di akun tersebut.
OWNERSHIP_REQUIRED_FOR_UPDATE Kepemilikan diperlukan untuk mengubah daftar pengguna.
USER_LIST_MUTATION_NOT_SUPPORTED Jenis daftar pengguna bersifat hanya baca dan tidak mendukung mutasi.
SENSITIVE_USER_LIST_IMMUTABLE Daftar pengguna yang sensitif terhadap privasi atau ditolak secara hukum tidak dapat diubah oleh pengguna eksternal.
BILLABLE_RECORD_COUNT_IMMUTABLE Kolom catatan yang dapat ditagih dari daftar pengguna pemasaran ulang tidak dapat diubah setelah ditetapkan.
USER_LIST_NAME_RESERVED Nama daftar pengguna dicadangkan untuk daftar sistem.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA Pengiklan harus masuk dalam daftar yang diizinkan untuk menggunakan daftar pemasaran ulang yang dibuat dari data yang diupload pengiklan.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE Sumber audiens partner tidak didukung untuk jenis daftar pengguna.
COMMERCE_PARTNER_NOT_ALLOWED Menyetel kolom commerce_partner hanya didukung jika partner_audience_source adalah COMMERCE_AUDIENCE.
UNSUPPORTED_PARTNER_AUDIENCE_INFO Kolom partner_audience_info tidak didukung untuk jenis daftar pengguna.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED Daftar pengguna Partner Match tidak dapat dibuat oleh akun pengelola.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Partner data tidak masuk dalam daftar yang diizinkan untuk THIRD_PARTY_PARTNER_DATA.
ADVERTISER_TOS_NOT_ACCEPTED Pengiklan belum menyetujui persyaratan layanan partner.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Pengiklan tidak diizinkan untuk THIRD_PARTY_PARTNER_DATA.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT Jenis daftar pengguna ini tidak didukung untuk akun ini.
INVALID_COMMERCE_PARTNER Kolom commerce_partner tidak valid.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE Penyedia data tidak diizinkan untuk membuat audiens e-commerce.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Jenis kunci upload daftar pengguna tidak didukung.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG Konfigurasi info daftar pengguna yang di-ingest tidak didukung.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Jenis akun tidak didukung untuk jenis daftar pengguna.

Acara

Peristiwa yang merepresentasikan interaksi pengguna dengan situs atau aplikasi pengiklan.

Kolom
destination_references[]

string

Opsional. String referensi yang digunakan untuk menentukan tujuan. Jika kosong, peristiwa akan dikirim ke semua destinations dalam permintaan.
transaction_id

string

Opsional. ID unik untuk peristiwa ini. Wajib untuk konversi yang menggunakan beberapa sumber data.
event_timestamp

Timestamp

Wajib. Waktu terjadinya peristiwa.
last_updated_timestamp

Timestamp

Opsional. Terakhir kali acara diperbarui.
user_data

UserData

Opsional. Bagian data yang disediakan pengguna, yang mewakili pengguna yang terkait dengan peristiwa.
consent

Consent

Opsional. Informasi tentang apakah pengguna terkait telah memberikan berbagai jenis izin.
ad_identifiers

AdIdentifiers

Opsional. ID dan informasi lain yang digunakan untuk mencocokkan peristiwa konversi dengan aktivitas online lainnya (seperti klik iklan).
currency

string

Opsional. Kode mata uang yang terkait dengan semua nilai uang dalam peristiwa ini.
event_source

EventSource

Opsional. Sinyal untuk tempat terjadinya peristiwa (web, aplikasi, dalam toko, dll.).
event_device_info

DeviceInfo

Opsional. Informasi yang dikumpulkan tentang perangkat yang digunakan (jika ada) saat peristiwa terjadi.
cart_data

CartData

Opsional. Informasi tentang transaksi dan item yang terkait dengan acara.
custom_variables[]

CustomVariable

Opsional. Informasi pasangan nilai/kunci tambahan yang akan dikirim ke penampung konversi (tindakan konversi atau aktivitas FL).
experimental_fields[]

ExperimentalField

Opsional. Daftar pasangan kunci/nilai untuk kolom eksperimental yang pada akhirnya dapat dipromosikan menjadi bagian dari API.
user_properties

UserProperties

Opsional. Informasi yang dinilai pengiklan tentang pengguna pada saat peristiwa terjadi.
event_name

string

Opsional. Nama peristiwa. Wajib untuk peristiwa GA4.
client_id

string

Opsional. ID unik untuk instance pengguna klien web untuk aliran web GA4 ini.
user_id

string

Opsional. ID unik untuk pengguna, sebagaimana ditentukan oleh pengiklan.
additional_event_parameters[]

EventParameter

Opsional. Bucket parameter peristiwa apa pun yang akan disertakan dalam peristiwa yang belum ditentukan menggunakan kolom terstruktur lainnya.
conversion_value

double

Opsional. Nilai konversi yang terkait dengan peristiwa, untuk konversi berbasis nilai.

EventParameter

Parameter peristiwa untuk peristiwa GA4.

Kolom
parameter_name

string

Wajib. Nama parameter yang akan digunakan.
value

string

Wajib. Representasi string dari nilai parameter yang akan ditetapkan.

EventSource

Sumber peristiwa.

Enum
EVENT_SOURCE_UNSPECIFIED EventSource tidak ditentukan. Tidak boleh digunakan.
WEB Acara dibuat dari browser web.
APP Acara dibuat dari aplikasi.
IN_STORE Acara ini dihasilkan dari transaksi di toko.
PHONE Acara ini dibuat dari panggilan telepon.
OTHER Peristiwa dihasilkan dari sumber lain.

ExperimentalField

Kolom eksperimental yang merepresentasikan kolom tidak resmi.

Kolom
field

string

Opsional. Nama kolom yang akan digunakan.
value

string

Opsional. Nilai yang ditetapkan untuk kolom.

GcpWrappedKeyInfo

Informasi tentang kunci terbungkus Google Cloud Platform.

Kolom
key_type

KeyType

Wajib. Jenis algoritma yang digunakan untuk mengenkripsi data.
wip_provider

string

Wajib. Penyedia pool Workload Identity yang diperlukan untuk menggunakan KEK.
kek_uri

string

Wajib. ID resource Cloud Key Management Service Google Cloud Platform. Harus dalam format projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} atau gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}
encrypted_dek

string

Wajib. Kunci enkripsi data terenkripsi berenkode base64.

KeyType

Jenis algoritma yang digunakan untuk mengenkripsi data.

Enum
KEY_TYPE_UNSPECIFIED Jenis kunci tidak ditentukan. Tidak boleh digunakan.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Gender

Jenis gender demografis (misalnya, perempuan).

Enum
GENDER_UNSPECIFIED Tidak ditentukan.
GENDER_UNKNOWN Tak diketahui.
GENDER_MALE Laki-laki.
GENDER_FEMALE Perempuan.

GetUserListDirectLicenseRequest

Permintaan untuk mendapatkan resource UserListDirectLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
name

string

Wajib. Nama resource lisensi langsung daftar pengguna.

GetUserListGlobalLicenseRequest

Permintaan untuk mendapatkan resource UserListGlobalLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
name

string

Wajib. Nama resource lisensi global daftar pengguna.

GetUserListRequest

Pesan permintaan untuk GetUserList.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
name

string

Wajib. Nama resource UserList yang akan diambil. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

IngestAudienceMembersRequest

Permintaan untuk mengupload anggota audiens ke tujuan yang diberikan. Menampilkan IngestAudienceMembersResponse.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
destinations[]

Destination

Wajib. Daftar tujuan untuk mengarahkan anggota audiens.
audience_members[]

AudienceMember

Wajib. Daftar pengguna yang akan dikirim ke tujuan yang ditentukan. Maksimal 10000 resource AudienceMember dapat dikirim dalam satu permintaan.
consent

Consent

Opsional. Izin tingkat permintaan untuk diterapkan kepada semua pengguna dalam permintaan. Izin tingkat pengguna menggantikan izin tingkat permintaan, dan dapat ditentukan di setiap AudienceMember.
validate_only

bool

Opsional. Untuk tujuan pengujian. Jika true, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.
encoding

Encoding

Opsional. Diperlukan untuk upload UserData. Jenis encoding ID pengguna. Untuk ID pengguna yang di-hash, ini adalah jenis encoding string yang di-hash. Untuk ID pengguna yang di-hash dan dienkripsi, ini adalah jenis encoding string terenkripsi luar, tetapi tidak harus string yang di-hash dalam, yang berarti string yang di-hash dalam dapat dienkode dengan cara yang berbeda dari string terenkripsi luar. Untuk upload non-UserData, kolom ini diabaikan.
encryption_info

EncryptionInfo

Opsional. Informasi enkripsi untuk upload UserData. Jika tidak disetel, diasumsikan bahwa informasi identitas yang diupload di-hash, tetapi tidak dienkripsi. Untuk upload non-UserData, kolom ini diabaikan.
terms_of_service

TermsOfService

Opsional. Persyaratan layanan yang telah disetujui/ditolak pengguna.

IngestAudienceMembersResponse

Respons dari IngestAudienceMembersRequest.

Kolom
request_id

string

ID permintaan yang dibuat otomatis.

IngestEventsRequest

Permintaan untuk mengupload anggota audiens ke tujuan yang diberikan. Menampilkan IngestEventsResponse.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
destinations[]

Destination

Wajib. Daftar tujuan untuk mengirim peristiwa.
events[]

Event

Wajib. Daftar peristiwa yang akan dikirim ke tujuan yang ditentukan. Maksimal 2.000 resource Event dapat dikirim dalam satu permintaan.
consent

Consent

Opsional. Izin tingkat permintaan untuk diterapkan kepada semua pengguna dalam permintaan. Izin tingkat pengguna menggantikan izin tingkat permintaan, dan dapat ditentukan di setiap Event.
validate_only

bool

Opsional. Untuk tujuan pengujian. Jika true, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.
encoding

Encoding

Opsional. Diperlukan untuk upload UserData. Jenis encoding ID pengguna. Untuk ID pengguna yang di-hash, ini adalah jenis encoding string yang di-hash. Untuk ID pengguna yang di-hash dan dienkripsi, ini adalah jenis encoding string terenkripsi luar, tetapi tidak harus string yang di-hash dalam, yang berarti string yang di-hash dalam dapat dienkode dengan cara yang berbeda dari string terenkripsi luar. Untuk upload non-UserData, kolom ini diabaikan.
encryption_info

EncryptionInfo

Opsional. Informasi enkripsi untuk upload UserData. Jika tidak disetel, diasumsikan bahwa informasi identitas yang diupload di-hash, tetapi tidak dienkripsi. Untuk upload non-UserData, kolom ini diabaikan.

IngestEventsResponse

Respons dari IngestEventsRequest.

Kolom
request_id

string

ID permintaan yang dibuat otomatis.

IngestedUserListInfo

Merepresentasikan daftar pengguna yang diisi dengan data yang disediakan pengguna.

Kolom
upload_key_types[]

UploadKeyType

Wajib. Tidak dapat diubah. Jenis kunci upload daftar pengguna ini.
contact_id_info

ContactIdInfo

Opsional. Informasi tambahan jika CONTACT_ID adalah salah satu dari upload_key_types.
mobile_id_info

MobileIdInfo

Opsional. Informasi tambahan jika MOBILE_ID adalah salah satu dari upload_key_types.
user_id_info

UserIdInfo

Opsional. Informasi tambahan jika USER_ID adalah salah satu dari upload_key_types.
pair_id_info

PairIdInfo

Opsional. Informasi tambahan jika PAIR_ID adalah salah satu dari upload_key_types.

Fitur ini hanya tersedia untuk partner data.
pseudonymous_id_info

PseudonymousIdInfo

Opsional. Informasi tambahan untuk PSEUDONYMOUS_ID adalah salah satu upload_key_types.
partner_audience_info

PartnerAudienceInfo

Opsional. Informasi tambahan untuk audiens partner.

Fitur ini hanya tersedia untuk partner data.

UploadKeyType

Enum yang berisi kemungkinan jenis kunci upload daftar pengguna.

Enum
UPLOAD_KEY_TYPE_UNSPECIFIED Tidak ditentukan.
CONTACT_ID Info pelanggan seperti alamat email, nomor telepon, atau alamat fisik.
MOBILE_ID ID iklan seluler.
USER_ID ID pengguna yang disediakan pihak ketiga.
PAIR_ID ID rekonsiliasi identitas pengiklan penayang.
PSEUDONYMOUS_ID ID Platform Pengelolaan Data: - ID Pengguna Google - ID yang Disediakan Partner - ID yang Disediakan Penayang - IDFA iOS - ID iklan Android - ID Roku - ID Amazon Fire TV - ID Xbox atau Microsoft

Item

Mewakili item dalam keranjang yang terkait dengan acara.

Kolom
merchant_product_id

string

Opsional. ID produk dalam akun Merchant Center.
quantity

int64

Opsional. Jumlah item ini yang terkait dengan peristiwa.
unit_price

double

Opsional. Harga satuan tidak termasuk pajak, pengiriman, dan diskon tingkat transaksi.
item_id

string

Opsional. ID unik untuk merujuk item.
additional_item_parameters[]

ItemParameter

Opsional. Bucket parameter peristiwa yang terkait dengan item yang akan disertakan dalam peristiwa yang belum ditentukan menggunakan kolom terstruktur lainnya.

ItemParameter

Bucket parameter peristiwa yang terkait dengan item yang akan disertakan dalam peristiwa yang belum ditentukan menggunakan kolom terstruktur lainnya.

Kolom
parameter_name

string

Wajib. Nama parameter yang akan digunakan.
value

string

Wajib. Representasi string dari nilai parameter yang akan ditetapkan.

ListUserListDirectLicensesRequest

Permintaan untuk mencantumkan semua resource UserListDirectLicense untuk akun tertentu.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun yang lisensinya sedang dikueri. Harus dalam format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

Opsional. Filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123).

Operasi yang Didukung:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Kolom yang Tidak Didukung:

  • name (gunakan metode get sebagai gantinya)
  • historical_pricings dan semua sub-kolomnya
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opsional. Jumlah maksimum lisensi yang akan ditampilkan per halaman. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 lisensi akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListUserListDirectLicense sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListUserListDirectLicense harus sesuai dengan panggilan yang memberikan token halaman.

ListUserListDirectLicensesResponse

Respons dari ListUserListDirectLicensesRequest.

Kolom
user_list_direct_licenses[]

UserListDirectLicense

Lisensi untuk daftar pengguna tertentu dalam permintaan.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListUserListGlobalLicenseCustomerInfosRequest

Permintaan untuk mencantumkan semua resource UserListGlobalLicenseCustomerInfo untuk lisensi global daftar pengguna tertentu.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Lisensi global yang info pelanggannya sedang dikueri. Harus dalam format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Untuk mencantumkan semua info pelanggan lisensi global di akun, ganti ID lisensi global daftar pengguna dengan '-' (misalnya, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-)
filter

string

Opsional. Filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123).

Operasi yang Didukung:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Kolom yang Tidak Didukung:

  • name (gunakan metode get sebagai gantinya)
  • historical_pricings dan semua sub-kolomnya
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opsional. Jumlah maksimum lisensi yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 lisensi akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListUserListDirectLicense sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListUserListDirectLicense harus sesuai dengan panggilan yang memberikan token halaman.

ListUserListGlobalLicenseCustomerInfosResponse

Respons dari [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Kolom
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

Informasi pelanggan untuk lisensi tertentu dalam permintaan.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListUserListGlobalLicensesRequest

Permintaan untuk mencantumkan semua resource UserListGlobalLicense untuk akun tertentu.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun yang lisensinya sedang dikueri. Harus dalam format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

Opsional. Filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123).

Operasi yang Didukung:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Kolom yang Tidak Didukung:

  • name (gunakan metode get sebagai gantinya)
  • historical_pricings dan semua sub-kolomnya
  • pricing.start_time
  • pricing.end_time
page_size

int32

Opsional. Jumlah maksimum lisensi yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 lisensi akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListUserListGlobalLicense sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListUserListDirectLicense harus sesuai dengan panggilan yang memberikan token halaman.

ListUserListGlobalLicensesResponse

Respons dari ListUserListGlobalLicensesRequest.

Kolom
user_list_global_licenses[]

UserListGlobalLicense

Lisensi untuk daftar pengguna tertentu dalam permintaan.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListUserListsRequest

Pesan permintaan untuk ListUserLists.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun induk yang memiliki kumpulan daftar pengguna ini. Format: accountTypes/{account_type}/accounts/{account}
page_size

int32

Opsional. Jumlah maksimum daftar pengguna yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 daftar pengguna akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListUserLists sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListUserLists harus sesuai dengan panggilan yang memberikan token halaman.
filter

string

Opsional. String filter. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: display_name = "list 1").

Operasi yang didukung:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (memiliki)

Kolom yang didukung:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

Pesan respons untuk ListUserLists.

Kolom
user_lists[]

UserList

Daftar pengguna dari akun yang ditentukan.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

MatchRateRange

Rentang tingkat kecocokan upload atau daftar pengguna.

Enum
MATCH_RATE_RANGE_UNKNOWN Rentang rasio kecocokan tidak diketahui.
MATCH_RATE_RANGE_NOT_ELIGIBLE Rentang rasio kecocokan tidak memenuhi syarat.
MATCH_RATE_RANGE_LESS_THAN_20 Rentang tingkat kecocokan kurang dari 20% (dalam interval [0, 20)).
MATCH_RATE_RANGE_20_TO_30 Rentang tingkat kecocokan adalah antara 20% dan 30% (dalam interval [20, 31)).
MATCH_RATE_RANGE_31_TO_40 Rentang tingkat kecocokan adalah antara 31% dan 40% (dalam interval [31, 41)).
MATCH_RATE_RANGE_41_TO_50 Rentang tingkat kecocokan adalah antara 41% dan 50% (dalam interval [41, 51)).
MATCH_RATE_RANGE_51_TO_60 Rentang tingkat kecocokan adalah antara 51% dan 60% (dalam interval [51, 61).
MATCH_RATE_RANGE_61_TO_70 Rentang tingkat kecocokan adalah antara 61% dan 70% (dalam interval [61, 71)).
MATCH_RATE_RANGE_71_TO_80 Rentang tingkat kecocokan adalah antara 71% dan 80% (dalam interval [71, 81)).
MATCH_RATE_RANGE_81_TO_90 Rentang tingkat kecocokan adalah antara 81% dan 90% (dalam interval [81, 91)).
MATCH_RATE_RANGE_91_TO_100

Rentang tingkat kecocokan adalah antara 91% dan 100% (dalam interval [91, 100]).

MobileData

ID seluler untuk audiens. Setidaknya diperlukan satu ID seluler.

Kolom
mobile_ids[]

string

Wajib. Daftar ID perangkat seluler (ID iklan/IDFA). Maksimal 10 mobileIds dapat diberikan dalam satu AudienceMember.

MobileIdInfo

Informasi tambahan jika MOBILE_ID adalah salah satu dari upload_key_types.

Kolom
data_source_type

DataSourceType

Opsional. Tidak dapat diubah. Sumber data upload.
key_space

KeySpace

Wajib. Tidak dapat diubah. Ruang utama ID seluler.
app_id

string

Wajib. Tidak dapat diubah. String yang secara unik mengidentifikasi aplikasi seluler tempat data dikumpulkan.

KeySpace

Ruang kunci untuk ID seluler.

Enum
KEY_SPACE_UNSPECIFIED Tidak ditentukan.
IOS Ruang kunci iOS.
ANDROID Keyspace Android.

PairData

ID PAIR untuk audiens. Minimal satu ID PASANGAN diperlukan.

Fitur ini hanya tersedia untuk partner data.

Kolom
pair_ids[]

string

Wajib. Data PII yang disediakan ruang bersih, di-hash dengan SHA256, dan dienkripsi dengan sandi komutatif EC menggunakan kunci penayang untuk daftar pengguna PAIR. Maksimal 10 pairIds dapat diberikan dalam satu AudienceMember.

PairIdInfo

Informasi tambahan jika PAIR_ID adalah salah satu dari upload_key_types.

Fitur ini hanya tersedia untuk partner data.

Kolom
match_rate_percentage

int32

Hanya output. Kolom ini menunjukkan persentase kecocokan keanggotaan daftar pengguna ini dengan data pihak pertama penayang yang sesuai. Harus antara 0 dan 100 inklusif.
advertiser_identifier_count

int64

Hanya output. Jumlah catatan data pihak pertama pengiklan yang telah diupload ke penyedia ruang bersih. Hal ini tidak menunjukkan ukuran daftar pengguna PAIR.
publisher_id

int64

Wajib. Tidak dapat diubah. Mengidentifikasi penayang yang daftar pengguna Rekonsiliasi Identitas Pengiklan Penayang direkonsiliasi. Kolom ini disediakan oleh penyedia cleanroom dan hanya unik dalam cakupan cleanroom tersebut. ID ini tidak dapat digunakan sebagai ID global di beberapa ruang bersih.
publisher_name

string

Opsional. Nama deskriptif penayang yang akan ditampilkan di UI untuk pengalaman penargetan yang lebih baik.
clean_room_identifier

string

Wajib. Tidak dapat diubah. Mengidentifikasi hubungan unik pengiklan dengan penayang dengan satu penyedia ruang bersih atau di beberapa penyedia ruang bersih.

PartnerAudienceInfo

Informasi tambahan untuk audiens partner.

Fitur ini hanya tersedia untuk partner data.

Kolom
partner_audience_source

PartnerAudienceSource

Wajib. Tidak dapat diubah. Sumber audiens partner.
commerce_partner

string

Opsional. Nama partner e-commerce. Hanya diizinkan jika partner_audience_source adalah COMMERCE_AUDIENCE.

PartnerAudienceSource

Sumber audiens partner.

Enum
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED Tidak ditentukan.
COMMERCE_AUDIENCE Sumber Audiens partner adalah audiens commerce.
LINEAR_TV_AUDIENCE Sumber Audiens Partner adalah audiens TV linear.
AGENCY_PROVIDER_AUDIENCE Sumber Audiens Partner adalah audiens agensi/penyedia.

PpidData

Data ID yang diberikan penayang yang menyimpan PPID. Setidaknya diperlukan satu ppid.

Fitur ini hanya tersedia untuk partner data.

Kolom
ppids[]

string

Wajib. Daftar ID yang diberikan penayang untuk pengguna.

ProcessingErrorReason

Alasan error pemrosesan.

Enum
PROCESSING_ERROR_REASON_UNSPECIFIED Alasan error pemrosesan tidak diketahui.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Variabel kustom tidak valid.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Status variabel kustom tidak diaktifkan.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Konversi lebih lama dari usia maksimum yang didukung.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Konversi dengan GCLID dan waktu konversi yang sama sudah ada dalam sistem.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Konversi dengan kombinasi ID pesanan dan tindakan konversi yang sama sudah diupload.
PROCESSING_ERROR_REASON_INVALID_GBRAID GBRAID tidak dapat didekode.
PROCESSING_ERROR_REASON_INVALID_GCLID ID klik Google tidak dapat didekode.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID ID penjual berisi karakter non-digit.
PROCESSING_ERROR_REASON_INVALID_WBRAID WBRAID tidak dapat didekode.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Error internal.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Persyaratan konversi yang disempurnakan belum ditandatangani di akun tujuan.
PROCESSING_ERROR_REASON_INVALID_EVENT Acara tidak valid.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Transaksi yang cocok kurang dari nilai minimum.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS Transaksi kurang dari nilai minimum.
PROCESSING_ERROR_REASON_INVALID_FORMAT Terjadi error format pada acara.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Acara mengalami error dekripsi.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR DEK gagal didekripsi.
PROCESSING_ERROR_REASON_INVALID_WIP WIP diformat dengan salah atau WIP tidak ada.
PROCESSING_ERROR_REASON_INVALID_KEK KEK tidak dapat mendekripsi data karena KEK salah, atau tidak ada.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED WIP tidak dapat digunakan karena ditolak oleh kondisi pengesahannya.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Sistem tidak memiliki izin yang diperlukan untuk mengakses KEK.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED Sistem gagal melakukan autentikasi dengan AWS.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Gagal mendekripsi data UserIdentifier menggunakan DEK.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Pengguna mencoba memproses peristiwa dengan ID iklan yang bukan berasal dari iklan akun operasi.

ProcessingWarningReason

Alasan peringatan pemrosesan.

Enum
PROCESSING_WARNING_REASON_UNSPECIFIED Alasan peringatan pemrosesan tidak diketahui.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Sistem tidak memiliki izin yang diperlukan untuk mengakses KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR DEK gagal didekripsi.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Acara mengalami error dekripsi.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED WIP tidak dapat digunakan karena ditolak oleh kondisi pengesahannya.
PROCESSING_WARNING_REASON_INVALID_WIP WIP diformat dengan salah atau WIP tidak ada.
PROCESSING_WARNING_REASON_INVALID_KEK KEK tidak dapat mendekripsi data karena KEK salah, atau tidak ada.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Gagal mendekripsi data UserIdentifier menggunakan DEK.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Error internal.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Sistem gagal melakukan autentikasi dengan AWS.

Produk

Tidak digunakan lagi. Sebagai gantinya, gunakan AccountType. Mewakili produk Google tertentu.

Enum
PRODUCT_UNSPECIFIED Produk tidak ditentukan. Tidak boleh digunakan.
GOOGLE_ADS Google Ads.
DISPLAY_VIDEO_PARTNER Partner Display & Video 360.
DISPLAY_VIDEO_ADVERTISER Pengiklan Display & Video 360.
DATA_PARTNER Partner Data.

ProductAccount

Mewakili akun tertentu.

Kolom
product
(deprecated)

Product

Tidak digunakan lagi. Sebagai gantinya, gunakan account_type.
account_id

string

Wajib. ID akun. Misalnya, ID akun Google Ads Anda.
account_type

AccountType

Opsional. Jenis akun. Misalnya, GOOGLE_ADS. account_type atau product yang tidak digunakan lagi harus ada. Jika keduanya ditetapkan, nilainya harus cocok.

AccountType

Mewakili jenis akun Google. Digunakan untuk menemukan akun dan tujuan.

Enum
ACCOUNT_TYPE_UNSPECIFIED Produk tidak ditentukan. Tidak boleh digunakan.
GOOGLE_ADS Google Ads.
DISPLAY_VIDEO_PARTNER Partner Display & Video 360.
DISPLAY_VIDEO_ADVERTISER Pengiklan Display & Video 360.
DATA_PARTNER Partner Data.
GOOGLE_ANALYTICS_PROPERTY Google Analytics.

PseudonymousIdInfo

Informasi tambahan jika PSEUDONYMOUS_ID adalah salah satu dari upload_key_types.

Kolom
sync_status

SyncStatus

Hanya output. Status sinkronisasi daftar pengguna.
billable_record_count

int64

Opsional. Tidak dapat diubah. Jumlah catatan yang dapat ditagih (misalnya, diupload atau dicocokkan).

SyncStatus

Status sinkronisasi daftar pengguna.

Enum
SYNC_STATUS_UNSPECIFIED Tidak ditentukan.
CREATED Daftar pengguna telah dibuat sebagai placeholder. Isi dan/atau metadata daftar masih disinkronkan. Daftar pengguna belum siap digunakan.
READY_FOR_USE Daftar pengguna siap digunakan. Konten dan cookie telah disinkronkan dengan benar.
FAILED Terjadi error saat menyinkronkan konten dan/atau metadata daftar pengguna. Daftar pengguna tidak dapat digunakan.

RemoveAudienceMembersRequest

Permintaan untuk menghapus pengguna dari audiens di tujuan yang diberikan. Menampilkan RemoveAudienceMembersResponse.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
destinations[]

Destination

Wajib. Daftar tujuan untuk menghapus pengguna.
audience_members[]

AudienceMember

Wajib. Daftar pengguna yang akan dihapus.
validate_only

bool

Opsional. Untuk tujuan pengujian. Jika true, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.
encoding

Encoding

Opsional. Diperlukan untuk upload UserData. Jenis encoding ID pengguna. Hanya berlaku untuk encoding luar ID pengguna terenkripsi. Untuk upload non-UserData, kolom ini diabaikan.
encryption_info

EncryptionInfo

Opsional. Informasi enkripsi untuk upload UserData. Jika tidak disetel, diasumsikan bahwa informasi identitas yang diupload di-hash, tetapi tidak dienkripsi. Untuk upload non-UserData, kolom ini diabaikan.

RemoveAudienceMembersResponse

Respons dari RemoveAudienceMembersRequest.

Kolom
request_id

string

ID permintaan yang dibuat otomatis.

RequestStatusPerDestination

Status permintaan per tujuan.

Kolom
destination

Destination

Tujuan dalam permintaan DM API.
request_status

RequestStatus

Status permintaan tujuan.
error_info

ErrorInfo

Error info error yang berisi alasan error dan jumlah error terkait upload.
warning_info

WarningInfo

Info peringatan yang berisi alasan peringatan dan jumlah peringatan terkait upload.
Kolom union status. Status tujuan. status hanya dapat berupa salah satu dari berikut:
audience_members_ingestion_status

IngestAudienceMembersStatus

Status permintaan anggota audiens penyerapan.
events_ingestion_status

IngestEventsStatus

Status permintaan penyerapan peristiwa.
audience_members_removal_status

RemoveAudienceMembersStatus

Status permintaan penghapusan anggota audiens.

IngestAudienceMembersStatus

Status permintaan anggota audiens penyerapan.

Kolom
Kolom union status. Status penyerapan anggota audiens ke tujuan. status hanya dapat berupa salah satu dari berikut:
user_data_ingestion_status

IngestUserDataStatus

Status penyerapan data pengguna ke tujuan.
mobile_data_ingestion_status

IngestMobileDataStatus

Status penyerapan data seluler ke tujuan.
pair_data_ingestion_status

IngestPairDataStatus

Status penyerapan data pasangan ke tujuan.
user_id_data_ingestion_status

IngestUserIdDataStatus

Status penyerapan data ID pengguna ke tujuan.
ppid_data_ingestion_status

IngestPpidDataStatus

Status penyerapan data ppid ke tujuan.

IngestEventsStatus

Status penyerapan peristiwa ke tujuan.

Kolom
record_count

int64

Jumlah total peristiwa yang dikirim dalam permintaan upload. Mencakup semua peristiwa dalam permintaan, terlepas dari apakah peristiwa tersebut berhasil diproses atau tidak.

IngestMobileDataStatus

Status penyerapan data seluler ke tujuan yang berisi statistik terkait penyerapan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil di-ingest atau tidak.
mobile_id_count

int64

Jumlah total ID seluler yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua ID seluler dalam permintaan, terlepas dari apakah ID tersebut berhasil diproses atau tidak.

IngestPairDataStatus

Status penyerapan data berpasangan ke tujuan yang berisi statistik terkait penyerapan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil di-ingest atau tidak.
pair_id_count

int64

Jumlah total ID pasangan yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua ID pasangan dalam permintaan, terlepas dari apakah ID tersebut berhasil di-ingest atau tidak.

IngestPpidDataStatus

Status penyerapan data ppid ke tujuan yang berisi statistik terkait penyerapan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil di-ingest atau tidak.
ppid_count

int64

Jumlah total ppid yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua ppid dalam permintaan, terlepas dari apakah ppid tersebut berhasil diserap atau tidak.

IngestUserDataStatus

Status penyerapan data pengguna ke tujuan yang berisi statistik terkait penyerapan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil di-ingest atau tidak.
user_identifier_count

int64

Jumlah total ID pengguna yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua ID pengguna dalam permintaan, terlepas dari apakah ID tersebut berhasil diproses atau tidak.
upload_match_rate_range

MatchRateRange

Rentang tingkat kecocokan upload.

IngestUserIdDataStatus

Status penyerapan data ID pengguna ke tujuan yang berisi statistik terkait penyerapan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil diproses atau tidak.
user_id_count

int64

Jumlah total ID pengguna yang dikirim dalam permintaan upload untuk tujuan. Mencakup semua ID pengguna dalam permintaan, terlepas dari apakah ID tersebut berhasil diproses atau tidak.

RemoveAudienceMembersStatus

Status permintaan penghapusan anggota audiens.

Kolom
Kolom union status. Status penghapusan anggota audiens dari tujuan. status hanya dapat berupa salah satu dari berikut:
user_data_removal_status

RemoveUserDataStatus

Status penghapusan data pengguna dari tujuan.
mobile_data_removal_status

RemoveMobileDataStatus

Status penghapusan data seluler dari tujuan.
pair_data_removal_status

RemovePairDataStatus

Status penghapusan data pasangan dari tujuan.
user_id_data_removal_status

RemoveUserIdDataStatus

Status penghapusan data ID pengguna dari tujuan.
ppid_data_removal_status

RemovePpidDataStatus

Status penghapusan data ppid dari tujuan.

RemoveMobileDataStatus

Status penghapusan data seluler dari tujuan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan penghapusan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil dihapus atau tidak.
mobile_id_count

int64

Jumlah total ID seluler yang dikirim dalam permintaan penghapusan. Mencakup semua ID seluler dalam permintaan, terlepas dari apakah ID tersebut berhasil dihapus atau tidak.

RemovePairDataStatus

Status penghapusan data pasangan dari tujuan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan penghapusan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil dihapus atau tidak.
pair_id_count

int64

Jumlah total ID pasangan yang dikirim dalam permintaan penghapusan. Mencakup semua ID pasangan dalam permintaan, terlepas dari apakah ID tersebut berhasil dihapus atau tidak.

RemovePpidDataStatus

Status penghapusan data ppid dari tujuan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan penghapusan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil dihapus atau tidak.
ppid_count

int64

Jumlah total ppid yang dikirim dalam permintaan penghapusan. Mencakup semua ppid dalam permintaan, terlepas dari apakah ppid tersebut berhasil dihapus atau tidak.

RemoveUserDataStatus

Status penghapusan data pengguna dari tujuan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan penghapusan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil dihapus atau tidak.
user_identifier_count

int64

Jumlah total ID pengguna yang dikirim dalam permintaan penghapusan. Mencakup semua ID pengguna dalam permintaan, terlepas dari apakah ID tersebut berhasil dihapus atau tidak.

RemoveUserIdDataStatus

Status penghapusan data ID pengguna dari tujuan.

Kolom
record_count

int64

Jumlah total anggota audiens yang dikirim dalam permintaan penghapusan. Mencakup semua anggota audiens dalam permintaan, terlepas dari apakah mereka berhasil dihapus atau tidak.
user_id_count

int64

Jumlah total ID pengguna yang dikirim dalam permintaan penghapusan. Mencakup semua ID pengguna dalam permintaan, terlepas dari apakah ID tersebut berhasil dihapus atau tidak.

RequestStatus

Status permintaan.

Enum
REQUEST_STATUS_UNKNOWN Status permintaan tidak diketahui.
SUCCESS Permintaan berhasil.
PROCESSING Permintaan sedang diproses.
FAILED Permintaan gagal.
PARTIAL_SUCCESS Permintaan berhasil sebagian.

RetrieveInsightsRequest

Pesan permintaan untuk DM API MarketingDataInsightsService.RetrieveInsights

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun induk yang memiliki daftar pengguna. Format: accountTypes/{account_type}/accounts/{account}
baseline

Baseline

Wajib. Dasar untuk insight yang diminta.
user_list_id

string

Wajib. ID daftar pengguna yang insight-nya diminta.

RetrieveInsightsResponse

Pesan respons untuk DM API MarketingDataInsightsService.RetrieveInsights

Kolom
marketing_data_insights[]

MarketingDataInsight

Berisi insight untuk data pemasaran.

MarketingDataInsight

Insight untuk data pemasaran.

Fitur ini hanya tersedia untuk partner data.

Kolom
dimension

AudienceInsightsDimension

Dimensi yang terkait dengan insight.
attributes[]

MarketingDataInsightsAttribute

Insight untuk nilai dimensi tertentu.

AudienceInsightsDimension

Kemungkinan dimensi untuk digunakan dalam membuat insight.

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Tidak ditentukan.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Nilai tidak diketahui dalam versi ini.
AFFINITY_USER_INTEREST Affinity UserInterest.
IN_MARKET_USER_INTEREST UserInterest Berniat Beli.
AGE_RANGE Rentang usia.
GENDER Gender.

MarketingDataInsightsAttribute

Insight untuk kumpulan atribut terkait dari dimensi yang sama.

Kolom
user_interest_id

int64

ID minat pengguna.
lift

float

Pengukuran peningkatan yang dimiliki audiens untuk nilai atribut dibandingkan dengan dasar pengukuran. Rentang [0-1].
age_range

AgeRange

Rentang usia audiens yang datanya disediakan.
gender

Gender

Gender audiens yang datanya digunakan untuk menghitung peningkatan.

RetrieveRequestStatusRequest

Permintaan untuk mendapatkan status permintaan yang dibuat ke DM API untuk ID permintaan tertentu. Menampilkan RetrieveRequestStatusResponse.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
request_id

string

Wajib. Wajib. ID permintaan untuk permintaan Data Manager API.

RetrieveRequestStatusResponse

Respons dari RetrieveRequestStatusRequest.

Kolom
request_status_per_destination[]

RequestStatusPerDestination

Daftar status permintaan per tujuan. Urutan status sesuai dengan urutan tujuan dalam permintaan asli.

SearchPartnerLinksRequest

Permintaan untuk menelusuri resource PartnerLink. Menampilkan SearchPartnerLinksResponse.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
parent

string

Wajib. Akun untuk menelusuri link partner. Jika tidak ada filter yang ditentukan, semua link partner yang menggunakan akun ini sebagai owning_account atau partner_account akan ditampilkan.

Format: accountTypes/{account_type}/accounts/{account}
page_size

int32

Jumlah maksimum link partner yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 10 link partner akan ditampilkan. Nilai maksimum adalah 100; nilai di atas 100 akan dikonversi menjadi 100.
page_token

string

Token halaman, yang diterima dari panggilan SearchPartnerLinks sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk SearchPartnerLinks harus sesuai dengan panggilan yang memberikan token halaman.
filter

string

Opsional. String filter. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: partner_link_id = 123456789).

Operasi yang didukung:

  • AND
  • =
  • !=

Kolom yang didukung:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

Contoh: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

Respons dari SearchPartnerLinksRequest.

Kolom
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

SizeInfo

Estimasi jumlah anggota dalam daftar pengguna ini di berbagai jaringan target.

Kolom
display_network_members_count

int64

Hanya output. Perkiraan jumlah anggota dalam daftar pengguna ini, di Jaringan Display Google.
search_network_members_count

int64

Hanya output. Perkiraan jumlah anggota dalam daftar pengguna ini di domain google.com. Berikut adalah anggota yang tersedia untuk penargetan di kampanye Penelusuran.

TargetNetworkInfo

Informasi kelayakan untuk berbagai jaringan target.

Kolom
eligible_for_display

bool

Hanya output. Menunjukkan bahwa daftar pengguna ini memenuhi syarat untuk Jaringan Display Google.

TermsOfService

Persyaratan layanan yang telah disetujui/ditolak pengguna.

Kolom
customer_match_terms_of_service_status

TermsOfServiceStatus

Opsional. Persyaratan layanan Customer Match: https://support.google.com/adspolicy/answer/6299717. Persyaratan ini harus disetujui saat memproses UserData atau MobileData. Kolom ini tidak diperlukan untuk daftar pengguna Partner Match.

TermsOfServiceStatus

Mewakili keputusan penelepon untuk menyetujui atau menolak persyaratan layanan.

Enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Tidak ditentukan.
ACCEPTED Status yang menunjukkan bahwa pemanggil telah memilih untuk menyetujui persyaratan layanan.
REJECTED Status yang menunjukkan bahwa pemanggil telah memilih untuk menolak persyaratan layanan.

UpdateUserListDirectLicenseRequest

Permintaan untuk memperbarui resource UserListDirectLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
user_list_direct_license

UserListDirectLicense

Wajib. Kolom name lisensi digunakan untuk mengidentifikasi lisensi yang akan diperbarui.
update_mask

FieldMask

Opsional. Daftar kolom yang akan diperbarui. Karakter khusus * tidak didukung dan error INVALID_UPDATE_MASK akan ditampilkan jika digunakan.

UpdateUserListGlobalLicenseRequest

Permintaan untuk memperbarui resource UserListGlobalLicense.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
user_list_global_license

UserListGlobalLicense

Wajib. Kolom name lisensi digunakan untuk mengidentifikasi lisensi yang akan diperbarui.
update_mask

FieldMask

Opsional. Daftar kolom yang akan diperbarui. Karakter khusus * tidak didukung dan error INVALID_UPDATE_MASK akan ditampilkan jika digunakan.

UpdateUserListRequest

Pesan permintaan untuk UpdateUserList.

Anda dapat mencoba metode ini di REST API Explorer:
Coba dengan REST
Kolom
user_list

UserList

Wajib. Daftar pengguna yang akan diperbarui.

Kolom name daftar pengguna digunakan untuk mengidentifikasi daftar pengguna yang akan diperbarui. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
update_mask

FieldMask

Opsional. Daftar kolom yang akan diperbarui.
validate_only

bool

Opsional. Jika benar, permintaan divalidasi tetapi tidak dieksekusi.

UserData

Data yang mengidentifikasi pengguna. Minimal satu ID diperlukan.

Kolom
user_identifiers[]

UserIdentifier

Wajib. ID untuk pengguna. Anda dapat memberikan beberapa instance dari jenis data yang sama (misalnya, beberapa alamat email). Untuk meningkatkan kemungkinan kecocokan, berikan sebanyak mungkin ID. Maksimal 10 userIdentifiers dapat diberikan dalam satu AudienceMember atau Event.

UserIdData

Data ID pengguna yang menyimpan ID pengguna.

Kolom
user_id

string

Wajib. ID unik untuk pengguna, sebagaimana ditentukan oleh pengiklan.

UserIdInfo

Informasi tambahan jika USER_ID adalah salah satu dari upload_key_types.

Kolom
data_source_type

DataSourceType

Opsional. Tidak dapat diubah. Sumber data upload.

UserIdentifier

Satu ID untuk pengguna.

Kolom
Kolom union identifier. Tepatnya satu yang harus ditentukan. identifier hanya dapat berupa salah satu dari berikut:
email_address

string

Alamat email yang di-hash menggunakan fungsi hash SHA-256 setelah normalisasi.
phone_number

string

Nomor telepon yang di-hash menggunakan fungsi hash SHA-256 setelah normalisasi (standar E164).
address

AddressInfo

Komponen alamat pengguna yang diketahui. Berisi pengelompokan ID yang dicocokkan sekaligus.

UserList

Resource daftar pengguna.

Kolom
name

string

ID. Nama resource daftar pengguna. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
id

int64

Hanya output. ID unik daftar pengguna.
read_only

bool

Hanya output. Opsi yang menunjukkan apakah pengguna dapat mengedit daftar.
membership_duration

Duration

Opsional. Durasi pengguna tetap berada dalam daftar pengguna. Durasi yang valid adalah kelipatan 24 jam (86400 detik). Memberikan nilai yang bukan kelipatan 24 jam akan menghasilkan error INVALID_ARGUMENT.
access_reason

AccessReason

Hanya output. Alasan akun ini diberi akses ke daftar.
size_info

SizeInfo

Hanya output. Estimasi jumlah anggota dalam daftar pengguna ini di berbagai jaringan target.
target_network_info

TargetNetworkInfo

Opsional. Informasi kelayakan untuk berbagai jaringan target.
display_name

string

Wajib. Nama tampilan daftar pengguna.
description

string

Opsional. Deskripsi daftar pengguna.
membership_status

MembershipStatus

Opsional. Status keanggotaan daftar pengguna ini.
integration_code

string

Opsional. ID dari sistem eksternal. ID ini digunakan oleh penjual daftar pengguna untuk mengorelasikan ID di sistem mereka.
closing_reason

ClosingReason

Hanya output. Alasan status keanggotaan daftar pengguna ini ditutup.
account_access_status

AccessStatus

Opsional. Menunjukkan apakah berbagi ini masih diaktifkan. Jika daftar pengguna dibagikan ke akun, kolom ini akan ditetapkan ke ENABLED. Kemudian, pemilik daftar pengguna dapat memutuskan untuk mencabut pembagian dan menjadikannya DISABLED.
Kolom union user_list_info. Informasi tambahan tentang daftar pengguna. user_list_info hanya dapat berupa salah satu dari berikut:
ingested_user_list_info

IngestedUserListInfo

Opsional. Merepresentasikan daftar pengguna yang diisi dengan data yang dimasukkan pengguna.

AccessReason

Enum yang mendeskripsikan kemungkinan alasan akses.

Enum
ACCESS_REASON_UNSPECIFIED Tidak ditentukan.
OWNED Resource dimiliki oleh pengguna.
SHARED Resource dibagikan kepada pengguna.
LICENSED Resource dilisensikan kepada pengguna.
SUBSCRIBED Pengguna berlangganan resource.
AFFILIATED Resource dapat diakses oleh pengguna.

AccessStatus

Menunjukkan apakah klien ini masih memiliki akses ke daftar.

Enum
ACCESS_STATUS_UNSPECIFIED Tidak ditentukan.
ENABLED Akses diaktifkan.
DISABLED Akses dinonaktifkan.

ClosingReason

Menunjukkan alasan daftar pengguna ditutup. Enum ini hanya digunakan saat daftar ditutup secara otomatis oleh sistem.

Enum
CLOSING_REASON_UNSPECIFIED Tidak ditentukan.
UNUSED Daftar pengguna ditutup karena tidak digunakan dalam penargetan baru-baru ini. Lihat https://support.google.com/google-ads/answer/2472738 untuk mengetahui detailnya.

MembershipStatus

Status daftar pengguna.

Enum
MEMBERSHIP_STATUS_UNSPECIFIED Tidak ditentukan.
OPEN Status terbuka - Daftar pengguna sedang mengakuisisi anggota dan dapat ditargetkan.
CLOSED Status tertutup - Tidak ada anggota baru yang ditambahkan.

UserListDirectLicense

Lisensi langsung daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Kolom
name

string

ID. Nama resource lisensi langsung daftar pengguna.
user_list_display_name

string

Hanya output. Nama daftar pengguna yang diberi lisensi.

Kolom ini bersifat hanya baca.
client_account_display_name

string

Hanya output. Nama pelanggan klien yang diberi lisensi daftar penggunanya.

Kolom ini bersifat hanya baca.
pricing

UserListLicensePricing

Opsional. Harga UserListDirectLicense.
historical_pricings[]

UserListLicensePricing

Hanya output. Histori harga lisensi daftar pengguna ini.

Kolom ini bersifat hanya baca.
metrics

UserListLicenseMetrics

Hanya output. Metrik yang terkait dengan lisensi ini

Kolom ini bersifat hanya baca dan hanya diisi jika tanggal mulai dan akhir ditetapkan dalam panggilan ListUserListDirectLicenses
user_list_id

int64

Tidak dapat diubah. ID daftar pengguna yang dilisensikan.
client_account_type

UserListLicenseClientAccountType

Tidak dapat diubah. Jenis akun pelanggan klien yang diberi lisensi untuk daftar pengguna.
client_account_id

int64

Tidak dapat diubah. ID pelanggan klien yang diberi lisensi daftar penggunanya.
status

UserListLicenseStatus

Opsional. Status UserListDirectLicense - ENABLED atau DISABLED.

UserListGlobalLicense

Lisensi global daftar pengguna.

Fitur ini hanya tersedia untuk partner data.

Kolom
name

string

ID. Nama resource lisensi global daftar pengguna.
user_list_display_name

string

Hanya output. Nama daftar pengguna yang diberi lisensi.

Kolom ini bersifat hanya baca.
pricing

UserListLicensePricing

Opsional. Harga UserListGlobalLicense.
historical_pricings[]

UserListLicensePricing

Hanya output. Histori harga lisensi daftar pengguna ini.

Kolom ini bersifat hanya baca.
metrics

UserListLicenseMetrics

Hanya output. Metrik yang terkait dengan lisensi ini

Kolom ini bersifat hanya baca dan hanya diisi jika tanggal mulai dan akhir ditetapkan dalam panggilan ListUserListGlobalLicenses
user_list_id

int64

Tidak dapat diubah. ID daftar pengguna yang dilisensikan.
license_type

UserListGlobalLicenseType

Tidak dapat diubah. Jenis produk pelanggan klien yang diberi lisensi untuk daftar pengguna.
status

UserListLicenseStatus

Opsional. Status UserListGlobalLicense - ENABLED atau DISABLED.

UserListGlobalLicenseCustomerInfo

Informasi tentang pelanggan lisensi global daftar pengguna. Akun ini akan otomatis dibuat oleh sistem saat pelanggan membeli lisensi global.

Kolom
name

string

ID. Nama resource pelanggan lisensi global daftar pengguna.
user_list_id

int64

Hanya output. ID daftar pengguna yang dilisensikan.
user_list_display_name

string

Hanya output. Nama daftar pengguna yang diberi lisensi.
license_type

UserListGlobalLicenseType

Hanya output. Jenis produk pelanggan klien yang diberi lisensi untuk daftar pengguna.
status

UserListLicenseStatus

Hanya output. Status UserListDirectLicense - ENABLED atau DISABLED.
pricing

UserListLicensePricing

Hanya output. Harga UserListDirectLicense.
client_account_type

UserListLicenseClientAccountType

Hanya output. Jenis produk pelanggan klien yang diberi lisensi untuk daftar pengguna.
client_account_id

int64

Hanya output. ID pelanggan klien yang diberi lisensi daftar penggunanya.
client_account_display_name

string

Hanya output. Nama pelanggan klien yang diberi lisensi daftar penggunanya.
historical_pricings[]

UserListLicensePricing

Hanya output. Histori harga lisensi daftar pengguna ini.
metrics

UserListLicenseMetrics

Hanya output. Metrik yang terkait dengan lisensi ini

Kolom ini hanya diisi jika tanggal mulai dan akhir ditetapkan dalam panggilan ListUserListGlobalLicenseCustomerInfos.

UserListGlobalLicenseType

Jenis lisensi global daftar pengguna.

Enum
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED TIDAK DITENTUKAN.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER Lisensi reseller.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE Lisensi Sisi Penjualan DataMart.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE Lisensi Sisi Beli DataMart.

UserListLicenseClientAccountType

Kemungkinan produk akun klien untuk lisensi daftar pengguna.

Enum
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN Tak diketahui.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS Pelanggan Google Ads.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER Partner Display & Video 360.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER Pengiklan Display & Video 360.

UserListLicenseMetrics

Metrik yang terkait dengan lisensi daftar pengguna.

Kolom
click_count

int64

Hanya output. Jumlah klik untuk lisensi daftar pengguna.
impression_count

int64

Hanya output. Jumlah tayangan untuk lisensi daftar pengguna.
revenue_usd_micros

int64

Hanya output. Pendapatan untuk lisensi daftar pengguna dalam mikro USD.
start_date

int64

Hanya output. Tanggal mulai (inklusif) metrik dalam format YYYYMMDD. Misalnya, 20260102 mewakili 2 Januari 2026. Jika end_date digunakan dalam filter, start_date juga wajib ada. Jika start_date maupun end_date tidak disertakan dalam filter, kolom UserListLicenseMetrics tidak akan diisi dalam respons.
end_date

int64

Hanya output. Tanggal akhir (inklusif) metrik dalam format YYYYMMDD. Misalnya, 20260102 mewakili 2 Januari 2026. Jika start_date digunakan dalam filter, end_date juga wajib ada. Jika start_date maupun end_date tidak disertakan dalam filter, kolom UserListLicenseMetrics tidak akan diisi dalam respons.

UserListLicensePricing

Harga lisensi daftar pengguna.

Kolom
pricing_id

int64

Hanya output. ID harga ini.
start_time

Timestamp

Hanya output. Waktu mulai penetapan harga.
end_time

Timestamp

Opsional. Waktu berakhir harga.
pricing_active

bool

Hanya output. Apakah harga ini aktif.
buyer_approval_state

UserListPricingBuyerApprovalState

Hanya output. Status persetujuan pembeli untuk harga ini.

Kolom ini bersifat hanya baca.
cost_micros

int64

Opsional. Biaya yang terkait dengan model, dalam unit mikro (10^-6), dalam mata uang yang ditentukan oleh kolom currency_code. Misalnya, 2000000 berarti $2 jika currency_code adalah USD.
currency_code

string

Opsional. Mata uang yang digunakan untuk menentukan biaya dan max_cost. Harus berupa kode mata uang tiga huruf yang ditentukan dalam ISO 4217.
cost_type

UserListPricingCostType

Tidak dapat diubah. Jenis biaya harga ini.

Hanya dapat ditetapkan dalam operasi create. Tidak dapat diperbarui untuk lisensi yang ada.
max_cost_micros

int64

Opsional. CPM maksimum yang dapat dibebankan kepada audiens e-commerce saat jenis biaya MEDIA_SHARE digunakan. Nilainya dalam unit mikro (10^-6) dan dalam mata uang yang ditentukan oleh kolom currency_code. Misalnya, 2000000 berarti $2 jika currency_code adalah USD.

Kolom ini hanya relevan jika cost_type adalah MEDIA_SHARE. Jika cost_type bukan MEDIA_SHARE, dan kolom ini ditetapkan, error MAX_COST_NOT_ALLOWED akan ditampilkan. Jika tidak ditetapkan atau ditetapkan ke0, tidak ada batas.

UserListPricingBuyerApprovalState

Status persetujuan pembeli harga daftar pengguna.

Enum
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED TIDAK DITENTUKAN.
PENDING Klien daftar pengguna belum menyetujui persyaratan harga yang ditetapkan oleh pemilik daftar pengguna.
APPROVED Klien daftar pengguna telah menyetujui persyaratan harga yang ditetapkan oleh pemilik daftar pengguna.
REJECTED Klien daftar pengguna telah menolak persyaratan harga yang ditetapkan oleh pemilik daftar pengguna.

UserListPricingCostType

Jenis biaya harga daftar pengguna.

Enum
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Tidak ditentukan.
CPC Biaya per klik.
CPM Biaya per seribu tayangan iklan.
MEDIA_SHARE Berbagi media.

UserListLicenseStatus

Status lisensi daftar pengguna.

Enum
USER_LIST_LICENSE_STATUS_UNSPECIFIED Tak diketahui.
USER_LIST_LICENSE_STATUS_ENABLED Status aktif - daftar pengguna masih dilisensikan.
USER_LIST_LICENSE_STATUS_DISABLED Status tidak aktif - daftar pengguna tidak lagi dilisensikan.

UserProperties

Informasi yang dinilai pengiklan tentang pengguna pada saat peristiwa terjadi. Lihat https://support.google.com/google-ads/answer/14007601 untuk mengetahui detail selengkapnya.

Kolom
customer_type

CustomerType

Opsional. Jenis pelanggan yang terkait dengan peristiwa.
customer_value_bucket

CustomerValueBucket

Opsional. Nilai pelanggan yang dinilai oleh pengiklan.
additional_user_properties[]

UserProperty

Opsional. Bucket properti pengguna tambahan untuk pengguna yang terkait dengan peristiwa ini.

UserProperty

Bucket properti pengguna tambahan untuk pengguna yang terkait dengan peristiwa ini.

Kolom
property_name

string

Wajib. Nama properti pengguna yang akan digunakan.
value

string

Wajib. Representasi string dari nilai properti pengguna yang akan digunakan.

WarningCount

Jumlah peringatan untuk alasan peringatan tertentu.

Kolom
record_count

int64

Jumlah catatan yang memiliki peringatan.
reason

ProcessingWarningReason

Alasan peringatan.

WarningInfo

Jumlah peringatan untuk setiap jenis peringatan.

Kolom
warning_counts[]

WarningCount

Daftar peringatan dan jumlah per alasan peringatan.