Package google.ads.datamanager.v1

Indeks

IngestionService

Layanan untuk mengirim data audiens ke tujuan yang didukung.

IngestAdEvents

rpc IngestAdEvents(IngestAdEventsRequest) returns (IngestAdEventsResponse)

Mengupload daftar resource AdEvent ke Google Analytics.

Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datamanager
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

AdEvent

Peristiwa iklan.

Kolom
advertiser_id

string

Wajib. ID pengiklan untuk peristiwa iklan.

ID ini harus cocok dengan ID yang dikirim dalam alur penautan.
event_type

EventType

Wajib. Jenis peristiwa.
timestamp

Timestamp

Wajib. Waktu terjadinya peristiwa.
event_id

string

Opsional. ID yang dibuat dan dikelola oleh pemanggil yang mengidentifikasi peristiwa ini secara unik.

Wajib diisi jika Anda ingin menghapus duplikat peristiwa iklan yang disertakan dalam beberapa permintaan. Jika tidak, kolom ini bersifat opsional.
user_data

UserData

Opsional. Beberapa bagian data yang disediakan pengguna, yang mewakili pengguna yang terkait dengan peristiwa.

Anda dapat memberikan beberapa instance dari jenis data yang sama (misalnya, alamat email). Makin banyak data yang diberikan, makin besar kemungkinan kecocokan akan ditemukan.
device_info

DeviceInfo

Opsional. Informasi yang dikumpulkan tentang perangkat yang digunakan saat peristiwa iklan terjadi.
mobile_device_id

string

Opsional. ID perangkat yang digunakan untuk menayangkan iklan.
campaign_id

string

Wajib. ID kampanye terkait.
campaign_name

string

Wajib. Nama kampanye terkait.
ad_group_id

string

Opsional. ID grup iklan terkait.
ad_id

string

Opsional. ID iklan terkait dalam grup.
ad_height

int32

Opsional. Tinggi iklan dalam piksel.
ad_width

int32

Opsional. Lebar iklan dalam piksel.
region_code

string

Wajib. Negara plus subdivisi ISO 3166-2.
source

string

Wajib. Sumber platform iklan, mirip dengan sumber Google Analytics.
medium

string

Wajib. Media iklan, mirip dengan media Google Analytics.
attribution_hint

AttributionHint

Opsional. Status atribusi yang diasumsikan partner untuk peristiwa iklan ini.

Hal ini hanya berfungsi sebagai sinyal tentang bagaimana partner mengasumsikan atribusi terjadi, dan tidak memaksakan hasil akhir dalam laporan akhir.
viewability_info

ViewabilityInfo

Wajib. Detail visibilitas iklan yang ditayangkan.

Kolom union event_subtype_oneof. Opsional. Klasifikasi tambahan tentang jenis peristiwa iklan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. event_subtype_oneof hanya dapat berupa salah satu dari hal berikut:
event_subtype

EventSubtype

Nilai enum untuk subjenis acara.
event_subtype_string

string

Nilai string untuk subjenis acara.

Kolom union ad_type_oneof. Opsional. Jenis iklan yang ditayangkan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. ad_type_oneof hanya dapat berupa salah satu dari hal berikut:
ad_type

AdType

Nilai enum untuk jenis iklan.
ad_type_string

string

Nilai string untuk jenis iklan.

Kolom union ad_format_oneof. Opsional. Jenis iklan yang ditayangkan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. ad_format_oneof hanya dapat berupa salah satu dari hal berikut:
ad_format

AdFormat

Nilai enum untuk format iklan.
ad_format_string

string

Nilai string untuk format iklan.

Kolom union ad_placement_oneof. Opsional. Penempatan iklan yang ditayangkan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. ad_placement_oneof hanya dapat berupa salah satu dari hal berikut:
ad_placement

AdPlacement

Nilai enum untuk penempatan iklan.
ad_placement_string

string

Nilai string untuk penempatan iklan.

Kolom union targeting_type_oneof. Opsional. Jenis penargetan yang digunakan untuk menayangkan iklan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. targeting_type_oneof hanya dapat berupa salah satu dari hal berikut:
targeting_type

TargetingType

Nilai enum untuk jenis penargetan.
targeting_type_string

string

Nilai string untuk jenis penargetan.

Kolom union platform_type_oneof. Opsional. Jenis platform tempat iklan ditayangkan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. platform_type_oneof hanya dapat berupa salah satu dari hal berikut:
platform_type

PlatformType

Nilai enum untuk jenis platform.
platform_type_string

string

Nilai string untuk jenis platform.

Kolom union platform_oneof. Opsional. Detail lebih lanjut tentang platform tempat iklan ditayangkan.

String mentah diterima untuk menangani nilai selain enum murni. Enum lebih disukai jika memungkinkan. platform_oneof hanya dapat berupa salah satu dari hal berikut:
platform

Platform

Nilai enum untuk platform.
platform_string

string

Nilai string untuk platform.
measurement_allowed

bool

Opsional. Menunjukkan apakah baris diizinkan untuk digunakan untuk tujuan pengukuran, sebagaimana diatur oleh hukum privasi yang berlaku dalam yurisdiksi regional.

EventSubtype

Klasifikasi tambahan tentang jenis peristiwa iklan.

Enum
EVENT_SUBTYPE_UNSPECIFIED Subjenis peristiwa tidak ditentukan.
EVENT_SUBTYPE_IMPRESSION Peristiwa tayangan iklan.
EVENT_SUBTYPE_ENGAGED_VIEW Peristiwa penayangan tak dilewati.
EVENT_SUBTYPE_ONSITE_CLICK Peristiwa klik di situs.
EVENT_SUBTYPE_OUTBOUND_CLICK Peristiwa klik keluar.

EventType

Jenis peristiwa.

Enum
EVENT_TYPE_UNSPECIFIED Jenis peristiwa tidak ditentukan.
EVENT_TYPE_VIEW Lihat acara.
EVENT_TYPE_CLICK Peristiwa klik.

AdFormat

Format iklan yang ditayangkan.

Enum
AD_FORMAT_UNSPECIFIED Format iklan tidak ditentukan.
AD_FORMAT_AR Iklan AR.
AD_FORMAT_AUDIO Iklan audio.
AD_FORMAT_BANNER Iklan banner.
AD_FORMAT_BUMPER Iklan bumper.
AD_FORMAT_COLLECTION Iklan koleksi.
AD_FORMAT_IMAGE Iklan gambar.
AD_FORMAT_INTERACTIVE Iklan interaktif.
AD_FORMAT_INTERSTITIAL Iklan interstisial.
AD_FORMAT_IN_FEED Iklan dalam feed.
AD_FORMAT_IN_STREAM Iklan dalam stream.
AD_FORMAT_IN_STREAM_SKIPPABLE Iklan dalam stream yang dapat dilewati.
AD_FORMAT_IN_STREAM_NON_SKIPPABLE Iklan in-stream yang tidak dapat dilewati.
AD_FORMAT_NATIVE Iklan native.
AD_FORMAT_SHORTS Iklan Shorts.
AD_FORMAT_STORY Iklan cerita.
AD_FORMAT_SPONSORED Iklan bersponsor.
AD_FORMAT_VIDEO Iklan video.

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

string

Opsional. ID seluler untuk pengiklan. ID ini adalah IDFA di iOS, AdID di Android, atau ID pengiklan platform lain.
dclid

string

Opsional. ID klik iklan display yang terkait dengan peristiwa ini.
impression_id

string

Opsional. ID tayangan iklan yang terkait dengan peristiwa ini.
match_id

string

Opsional. Kolom ID kecocokan yang digunakan untuk menggabungkan peristiwa ini dengan peristiwa sebelumnya.
encrypted_user_ids[]

EncryptedUserId

Opsional. Sejumlah ID pengguna terenkripsi.

AdPlacement

Penempatan iklan yang ditayangkan.

Enum
AD_PLACEMENT_UNSPECIFIED Penempatan iklan tidak ditentukan.
AD_PLACEMENT_DISCOVER Temukan penempatan.
AD_PLACEMENT_FEED Penempatan feed.
AD_PLACEMENT_HEADER Penempatan header.
AD_PLACEMENT_HOME Penempatan di halaman beranda.
AD_PLACEMENT_IN_CONTENT Penempatan dalam konten.
AD_PLACEMENT_PROMOTED Penempatan yang dipromosikan.
AD_PLACEMENT_STORY Penempatan cerita.

AdType

Jenis iklan yang ditayangkan.

Enum
AD_TYPE_UNSPECIFIED Jenis iklan tidak ditentukan.
AD_TYPE_DISPLAY Iklan Display.
AD_TYPE_TEXT Iklan teks.
AD_TYPE_IMAGE Iklan gambar.
AD_TYPE_RICH_MEDIA Iklan multimedia.
AD_TYPE_HTML Iklan HTML.
AD_TYPE_AUDIO Iklan audio.
AD_TYPE_VIDEO Iklan video.

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 keluarga (terakhir) 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.

AttributionHint

Status atribusi yang diasumsikan partner untuk peristiwa iklan ini.

Enum
ATTRIBUTION_HINT_UNSPECIFIED Status atribusi tidak diketahui.
ATTRIBUTION_HINT_CONVERTED Status terkonversi.
ATTRIBUTION_HINT_NOT_CONVERTED Status tidak dikonversi.

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

CompositeData

Grup dari beberapa jenis ID.

AwsWrappedKeyInfo

Kunci enkripsi data yang digabungkan oleh kunci AWS KMS.

Kolom
key_type

KeyType

Wajib. Jenis algoritma yang digunakan untuk mengenkripsi data.
role_arn

string

Wajib. Amazon Resource Name 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.
coupon_codes[]

string

Opsional. Daftar kode kupon yang diterapkan ke keranjang. Kode kupon tingkat keranjang dan tingkat item bersifat independen.

Jika peristiwa ditujukan untuk tujuan Google Analytics, berikan hanya satu kode kupon. Google Analytics mengabaikan kode kupon tambahan.

CompositeData

Data gabungan yang menyimpan ID dan data terkait untuk pengguna. Setidaknya salah satu dari user_data atau ip_data harus ada.

Kolom
user_data

UserData

Opsional. Data yang disediakan pengguna yang mengidentifikasi pengguna.
ip_data[]

IpData

Opsional. Data alamat IP yang mewakili interaksi pelanggan yang digunakan untuk membuat audiens.

Setelan izin Digital Markets Act (DMA) untuk pengguna.

Kolom
ad_user_data

ConsentStatus

Opsional. Mewakili 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

CoordinatorKeyInfo

Informasi tentang kunci koordinator.

Kolom
key_id

string

Wajib. ID kunci koordinator yang dipilih.

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. Daftar pengguna yang memiliki lisensi langsung untuk 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 menjadi tujuan pengiriman data Anda. 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 datanya akan dihapus.
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.
category

string

Opsional. Kategori perangkat. Misalnya, “desktop”, “tablet”, “mobile”, “smart TV”.
language_code

string

Opsional. Bahasa yang digunakan perangkat dalam format ISO 639-1.
screen_height

int32

Opsional. Tinggi layar dalam piksel.
screen_width

int32

Opsional. Lebar layar dalam piksel.
operating_system

string

Opsional. Sistem operasi atau platform perangkat.
operating_system_version

string

Opsional. Versi sistem operasi atau platform.
model

string

Opsional. Model perangkat.
brand

string

Opsional. Merek perangkat.
browser

string

Opsional. Merek atau jenis browser.
browser_version

string

Opsional. Versi browser.

Encoding

Jenis encoding informasi identitas pribadi yang di-hash.

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

EncryptedUserId

ID pengguna yang dikeluarkan untuk digunakan dalam atribusi. Semua kolom wajib diisi jika ini digunakan.

Kolom
encrypted_id

string

Wajib. ID terenkripsi alfanumerik.
entity_type

EncryptionEntityType

Wajib. Jenis entitas enkripsi. Setelan ini harus cocok dengan konfigurasi enkripsi untuk penayangan iklan atau Transfer Data.
entity_id

int64

Wajib. ID entitas enkripsi. Setelan ini harus cocok dengan konfigurasi enkripsi untuk penayangan iklan atau Transfer Data.
source

EncryptionSource

Wajib. Menjelaskan apakah cookie terenkripsi diterima dari penayangan iklan (makro %m) atau dari Transfer Data.

EncryptionEntityType

Jenis entitas enkripsi.

Enum
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED Jenis entitas enkripsi tidak ditentukan.
CAMPAIGN_MANAGER_ACCOUNT Akun Campaign Manager 360.
CAMPAIGN_MANAGER_ADVERTISER Pengiklan Campaign Manager 360.
DISPLAY_VIDEO_PARTNER Partner Display & Video 360.
DISPLAY_VIDEO_ADVERTISER Pengiklan Display & Video 360.
GOOGLE_ADS_CUSTOMER Pelanggan Google Ads.
GOOGLE_AD_MANAGER_NETWORK_CODE Kode jaringan Google Ad Manager.

EncryptionSource

Sumber enkripsi.

Enum
ENCRYPTION_SOURCE_UNSPECIFIED Sumber enkripsi tidak ditentukan.
AD_SERVING Sumber enkripsi penayangan iklan.
DATA_TRANSFER Sumber enkripsi transfer data.

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 hal berikut:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Informasi kunci terenkapsulasi Google Cloud Platform.
aws_wrapped_key_info

AwsWrappedKeyInfo

Informasi kunci yang dienkapsulasi Amazon Web Services.
coordinator_key_info

CoordinatorKeyInfo

Informasi utama untuk kunci koordinator yang dipilih.

Hal ini tidak didukung untuk metode IngestEvents, IngestAudienceMembers, dan RemoveAudienceMembers.

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 error 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

Tidak digunakan lagi: Enum tidak digunakan di Data Manager API.
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 boleh di-ingest dalam satu permintaan.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Konfigurasi tujuan yang berisi akun login DataPartner 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 lead.
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. Untuk penyerapan Peristiwa Floodlight, error ini menunjukkan bahwa permintaan tidak berisi 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 Panjang nilai kolom terlalu panjang.
FIELD_VALUE_TOO_SHORT Panjang nilai kolom terlalu pendek.
TOO_MANY_ELEMENTS Terlalu banyak elemen dalam daftar di permintaan.
TOO_FEW_ELEMENTS Terlalu sedikit elemen dalam daftar di permintaan.
ALREADY_EXISTS Resource sudah ada.
IMMUTABLE_FIELD_FOR_UPDATE Mencoba menyetel kolom yang tidak dapat diubah untuk permintaan update.
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 kepada 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 nol tidak diizinkan 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 dilisensikan.
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 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 dimasukkan 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.
MEMBERSHIP_DURATION_TOO_LONG Durasi keanggotaan daftar pengguna terlalu panjang.
INVALID_MERCHANT_ID Kolom merchant_id tidak valid.
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED Pelanggan berisi kampanye yang tidak dikecualikan tanpa pernyataan iklan politik Uni Eropa.
ACCOUNT_INELIGIBLE_FOR_STORE_SALES Akun tidak memenuhi syarat untuk Penjualan Toko.
INVALID_MERCHANT_FEED_LANGUAGE_CODE Kode bahasa feed penjual tidak valid.
INVALID_REGION_CODE Kode wilayah tidak valid.
INVALID_SUBDIVISION_CODE Kode sub-wilayah tidak valid.
INVALID_SUBCONTINENT_CODE Kode anak benua tidak valid.
INVALID_CONTINENT_CODE Kode benua tidak valid.
INVALID_DEVICE_CATEGORY Kategori perangkat tidak valid.
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED app_instance_id dan client_id ditetapkan.
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED Properti Google Analytics adalah sub-properti atau properti gabungan.
THIRD_PARTY_USER_DATA_NOT_ALLOWED Data pengguna pihak ketiga hanya dapat disetel oleh partner data.
INVALID_COUPON_CODE Kode kupon tidak valid.
EVENT_SOURCE_AND_DESTINATION_MISMATCH Jenis sumber peristiwa tidak cocok dengan jenis tujuan.
DESTINATION_ACCOUNT_TYPE_MISMATCH Jenis akun tujuan tidak cocok dengan ID akun yang ditentukan.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Nilai variabel khusus berisi informasi identitas pribadi (PII).
CUSTOM_VARIABLE_NOT_ENABLED Variabel kustom tidak diaktifkan.
INVALID_CUSTOM_VARIABLE_VALUE Nilai variabel kustom tidak valid.
CUSTOM_VARIABLE_NOT_FOUND Tujuan tidak memiliki variabel kustom dengan nama yang cocok dengan variable yang ditentukan.
BASELINE_LOCATION_AUTO_DETECTION_FAILED Kolom location_auto_detection_enabled permintaan ditetapkan ke true, tetapi deteksi otomatis lokasi dasar gagal.
INSIGHTS_MISSING_FOR_DIMENSION Insight tidak ada untuk dimensi ini.

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 diisi untuk peristiwa yang dikirim sebagai sumber data tambahan untuk konversi tag.
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 data 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.
third_party_user_data

UserData

Opsional. Jenis data yang sama yang diberikan di user_data, tetapi secara eksplisit ditandai sebagai data yang disediakan oleh pihak ketiga dan bukan data pengiklan pihak pertama.
event_location

EventLocation

Opsional. Informasi yang dikumpulkan tentang lokasi pengguna saat peristiwa ini terjadi.
app_instance_id

string

Opsional. ID unik untuk instance pengguna klien aplikasi untuk aliran aplikasi GA4 ini.
conversion_value

double

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

double

Opsional. Jumlah konversi yang terkait dengan peristiwa, untuk konversi berbasis penghitungan.

EventLocation

Lokasi terjadinya peristiwa.

Kolom
store_id

string

Opsional. Wajib untuk Penjualan di Toko. ID untuk merepresentasikan toko fisik tempat peristiwa terjadi.
city

string

Opsional. Nama kota tempat peristiwa terjadi.
subdivision_code

string

Opsional. Kode subdivisi ISO 3166-2 tempat acara berlangsung.
region_code

string

Opsional. Kode wilayah CLDR 2 huruf dari alamat pengguna.
subcontinent_code

string

Opsional. Kode subbenua dalam format UN M49 tempat peristiwa terjadi.
continent_code

string

Opsional. Kode benua dalam format UN M49 tempat peristiwa terjadi.

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.
MESSAGE Acara dibuat dari pesan.
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 kolom yang akan ditetapkan.

FeatureSet

Kumpulan fitur yang didukung untuk link partner.

Enum
FEATURE_SET_UNSPECIFIED Set fitur tidak ditentukan. Jika tidak ditentukan, perilaku sistem akan ditetapkan secara default ke FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT.
FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT Menunjukkan link yang digunakan untuk pengelolaan audiens dan acara.
FEATURE_SET_AD_EVENT_MANAGEMENT Menunjukkan link yang digunakan untuk pengelolaan peristiwa iklan.

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 demografi (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}

IngestAdEventsRequest

Permintaan untuk mengupload peristiwa iklan.

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

AdEvent

Wajib. Wajib (minimal 1). Daftar peristiwa iklan.
encryption_info

EncryptionInfo

Opsional. Informasi tentang kunci enkripsi yang digunakan untuk mengenkripsi data.
validate_only

bool

Opsional. Jika benar, permintaan divalidasi, tetapi tidak dieksekusi.

IngestAdEventsResponse

Jenis ini tidak memiliki kolom.

Respons dari operasi penyerapan peristiwa iklan.

IngestAudienceMembersRequest

Permintaan untuk mengupload anggota audiens ke tujuan yang ditentukan. 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. Wajib untuk upload UserData. Jenis encoding ID pengguna. Untuk ID pengguna yang di-hash, ini adalah jenis encoding string yang di-hash. Untuk ID pengguna hash terenkripsi, ini adalah jenis encoding string terenkripsi luar, tetapi tidak harus string hash dalam, yang berarti string 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 pribadi 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 oleh pengguna.

IngestAudienceMembersResponse

Respons dari IngestAudienceMembersRequest.

Kolom
request_id

string

ID permintaan yang dibuat otomatis.

IngestEventsRequest

Permintaan untuk mengupload anggota audiens ke tujuan yang ditentukan. 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. Wajib untuk upload UserData. Jenis encoding ID pengguna. Untuk ID pengguna yang di-hash, ini adalah jenis encoding string yang di-hash. Untuk ID pengguna hash terenkripsi, ini adalah jenis encoding string terenkripsi luar, tetapi tidak harus string hash dalam, yang berarti string 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 pribadi 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

IpData

Informasi alamat IP untuk pengguna. Sebaiknya sertakan observe_start_time dan observe_end_time untuk membantu meningkatkan tingkat kecocokan Customer Match.

Kolom
ip_address

string

Wajib. Alamat IP yang diambil pada saat interaksi pelanggan. Menerima format string standar untuk IPv4 dan IPv6.
observe_start_time

Timestamp

Opsional. Waktu interaksi pertama yang tercatat dari alamat IP ini dalam sebuah sesi.
observe_end_time

Timestamp

Opsional. Waktu interaksi terakhir yang tercatat dari alamat IP ini dalam sesi.

Item

Mewakili item di 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.
merchant_id

string

Opsional. ID Merchant Center yang terkait dengan item. Untuk peristiwa Penjualan Toko, nilai ini akan menggantikan nilai yang ditetapkan di tingkat keranjang. Kolom ini diabaikan untuk acara lainnya.
merchant_feed_label

string

Opsional. Label feed dari feed Merchant Center. Jika negara masih digunakan, kode negara 2 huruf dalam ISO-3166-1 alpha-2 dapat digunakan sebagai gantinya. Untuk peristiwa Penjualan Toko, nilai ini akan menggantikan nilai yang ditetapkan di tingkat keranjang. Kolom ini diabaikan untuk acara lainnya.
merchant_feed_language_code

string

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

ItemCustomVariable

Opsional. Informasi pasangan nilai/kunci tambahan yang akan dikirim ke penampung konversi (tindakan konversi atau aktivitas Floodlight), saat melacak konversi per item.
conversion_value

double

Opsional. Nilai konversi yang terkait dengan item ini dalam peristiwa, untuk kasus saat nilai konversi berbeda untuk setiap item.

ItemCustomVariable

Variabel kustom tingkat item 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.

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. String filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123). Kolom harus ditentukan menggunakan semua camel case atau semua snake case. Jangan gunakan kombinasi camel case dan snake case.

Operasi yang Didukung:

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

Fungsi yang Didukung: - IN(field, value1, value2, ...): menampilkan benar (true) jika kolom cocok dengan salah satu nilai. Contoh: IN(user_list_id, 123, 456)

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. String filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123). Kolom harus ditentukan menggunakan semua camel case atau semua snake case. Jangan gunakan kombinasi camel case dan snake case.

Operasi yang Didukung:

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

Fungsi yang Didukung: - IN(field, value1, value2, ...): menampilkan benar (true) jika kolom cocok dengan salah satu nilai. Contoh: IN(user_list_id, 123, 456)

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. String filter yang akan diterapkan ke permintaan daftar. Semua kolom harus berada di sisi kiri setiap kondisi (misalnya: user_list_id = 123). Kolom harus ditentukan menggunakan semua camel case atau semua snake case. Jangan gunakan kombinasi camel case dan snake case.

Operasi yang Didukung:

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

Fungsi yang Didukung: - IN(field, value1, value2, ...): menampilkan benar (true) jika kolom cocok dengan salah satu nilai. Contoh: IN(user_list_id, 123, 456)

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"). Kolom harus ditentukan menggunakan semua camel case atau semua snake case. Jangan gunakan kombinasi camel case dan snake case.

Operasi yang didukung:

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

Fungsi yang Didukung: - IN(field, value1, value2, ...): menampilkan benar (true) jika kolom cocok dengan salah satu nilai. Contoh: IN(display_name, "name1", "name2")

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]).

MediaQuartile

Jumlah media yang diputar sebagai kuartil terpisah.

Enum
MEDIA_QUARTILE_UNSPECIFIED Kuartil media tidak ditentukan.
MEDIA_QUARTILE_START Mulai.
MEDIA_QUARTILE_FIRST_QUARTILE Kuartil pertama.
MEDIA_QUARTILE_MIDPOINT Titik tengah.
MEDIA_QUARTILE_THIRD_QUARTILE Kuartil ketiga.
MEDIA_QUARTILE_COMPLETE Selesai.

MobileData

ID seluler untuk audiens. Diperlukan minimal 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 diperlukan satu ID PAIR.

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

Wajib. Nama deskriptif penayang yang akan ditampilkan di UI untuk pengalaman penargetan yang lebih baik.
match_rate_percentage

int32

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

Opsional. Jumlah catatan data pihak pertama pengiklan yang telah diupload ke penyedia ruang bersih. Hal ini tidak menunjukkan ukuran daftar pengguna PAIR.
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.

PartnerCustomerAccount

Mewakili akun pelanggan di sistem partner.

Kolom
account_id

string

Wajib. ID akun pelanggan di ruang ID partner.
account_name

string

Opsional. Nama akun.
account_type

string

Opsional. Jenis akun. Dapat digunakan untuk membedakan akun pengiklan dan akun tingkat bisnis, misalnya.

PartnerLinkMetadata

Mewakili metadata yang terkait dengan link partner.

Kolom
implicit_accounts[]

PartnerCustomerAccount

Opsional. Daftar akun implisit.

Platform

Detail lebih lanjut tentang platform tempat iklan ditayangkan.

Enum
PLATFORM_UNSPECIFIED Platform tidak ditentukan.
PLATFORM_IOS Platform iOS.
PLATFORM_ANDROID Platform Android.
PLATFORM_WEB Platform web.

PlatformType

Jenis platform tempat iklan ditayangkan.

Enum
PLATFORM_TYPE_UNSPECIFIED Jenis platform tidak ditentukan.
PLATFORM_TYPE_MOBILE Platform seluler.
PLATFORM_TYPE_DESKTOP Platform desktop.
PLATFORM_TYPE_CTV Platform CTV.
PLATFORM_TYPE_PHONE Platform ponsel.
PLATFORM_TYPE_TABLET Platform tablet.

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. Alasan baru dapat ditambahkan di masa mendatang.

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 tidak benar 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.
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Tindakan konversi satu per klik tidak dapat digunakan dengan BRAID.
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND ID pertandingan tidak dapat ditemukan.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID ID pengguna tidak dapat ditemukan untuk ID pertandingan.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID ID pengguna tidak dapat ditemukan untuk GCLID.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID ID pengguna tidak dapat ditemukan untuk DCLID.
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS Ada ID iklan yang tidak valid.
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT Format ID seluler tidak valid.
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND Konversi asli tidak dapat ditemukan.
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR ID peristiwa (dclid atau ID tayangan iklan) tidak dapat didekode.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID ID pengguna tidak dapat ditemukan untuk ID tayangan iklan tertentu.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND ID pengguna tidak dapat ditemukan.
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK Stempel waktu peristiwa pada peristiwa lebih awal daripada klik terkait.
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK Klik terjadi terlalu baru.
PROCESSING_ERROR_REASON_INVALID_CLICK Peristiwa tidak dapat diatribusikan ke klik (GCLID). Hal ini mungkin karena klik tidak berasal dari kampanye Google Ads, misalnya.
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK Klik dari peristiwa tidak dikaitkan dengan operating_account tujuan.
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND Klik yang sesuai tidak dapat ditemukan yang cocok dengan atribut yang diberikan.
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING Data atribusi eksternal tidak ada. Pengiriman peristiwa ke tujuan untuk tindakan konversi atribusi eksternal tidak didukung.

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 tidak benar 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

Wajib. 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.
FLOODLIGHT_CONFIG Konfigurasi Floodlight.

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. Wajib 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 pribadi 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 API DM.
request_status

RequestStatus

Status permintaan tujuan.
error_info

ErrorInfo

Error info error yang berisi alasan error dan jumlah error terkait upload. Hanya diisi jika request_status adalah FAILED atau PARTIAL_SUCCESS. Kolom ini tidak diisi saat permintaan memiliki request_status PROCESSING.
warning_info

WarningInfo

Info peringatan yang berisi alasan peringatan dan jumlah peringatan terkait upload. Kolom ini tidak diisi saat permintaan memiliki request_status PROCESSING.
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 peristiwa penyerapan.
audience_members_removal_status

RemoveAudienceMembersStatus

Status permintaan penghapusan anggota audiens.

DataType

Jenis data.

Enum
DATA_TYPE_UNSPECIFIED Jenis data tidak ditentukan.
EMAIL Data adalah alamat email.
PHONE_NUMBER Data adalah nomor telepon.
ADDRESS Data adalah alamat fisik.
IP_ADDRESS Data berupa alamat IP.

DataTypeCount

Jumlah untuk jenis data tertentu.

Kolom
type

DataType

Jenis data.
count

int64

Jumlah untuk jenis data ini.

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

IngestCompositeDataStatus

Status penyerapan data gabungan ke tujuan.

IngestCompositeDataStatus

Status penyerapan data gabungan 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 diserap atau tidak.
data_type_counts[]

DataTypeCount

Jumlah total jenis data yang dikirim dalam permintaan upload untuk tujuan, yang dikelompokkan menurut jenis data. Mencakup semua jenis data dalam permintaan, terlepas dari apakah data tersebut berhasil diserap atau tidak.
upload_match_rate_range

MatchRateRange

Rentang tingkat kecocokan upload.

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 diserap 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 diserap 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 diserap 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 diserap 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 diserap 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 diserap 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 diserap 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 diserap 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.
composite_data_removal_status

RemoveCompositeDataStatus

Status penghapusan data gabungan dari tujuan.

RemoveCompositeDataStatus

Status penghapusan data gabungan 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.
data_type_counts[]

DataTypeCount

Jumlah total jenis data yang dikirim dalam permintaan penghapusan, yang dikelompokkan menurut jenis data. Mencakup semua jenis data dalam permintaan, terlepas dari apakah data tersebut berhasil dihapus atau tidak.

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 Pemrosesan berhasil untuk semua catatan tanpa error. Namun, mungkin ada peringatan di kolom warning_info.
PROCESSING Permintaan sedang diproses.
FAILED Pemrosesan gagal untuk semua catatan. Periksa kolom error_info untuk mengetahui detail error, dan periksa kolom warning_info untuk mengetahui detail peringatan.
PARTIAL_SUCCESS Pemrosesan berhasil diselesaikan tanpa error untuk beberapa data, tetapi gagal dengan error untuk data lainnya. Periksa kolom error_info untuk mengetahui detail error, dan periksa kolom warning_info untuk mengetahui detail peringatan.

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 UserInterest Afinitas.
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). Kolom harus ditentukan menggunakan semua camel case atau semua snake case. Jangan gunakan kombinasi camel case dan snake case.

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" AND 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. Ini adalah anggota yang tersedia untuk penargetan di kampanye Penelusuran.
youtube_members_count

int64

Hanya output. Estimasi jumlah anggota dalam daftar pengguna ini di YouTube.
gmail_members_count

int64

Hanya output. Perkiraan jumlah anggota dalam daftar pengguna ini di Gmail.

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.

TargetingType

Jenis penargetan yang digunakan untuk menayangkan iklan.

Enum
TARGETING_TYPE_UNSPECIFIED Jenis penargetan tidak ditentukan.
TARGETING_TYPE_AUDIENCE Penargetan audiens.
TARGETING_TYPE_CONTEXTUAL Penargetan kontekstual.
TARGETING_TYPE_DEMOGRAPHIC Penargetan demografis.
TARGETING_TYPE_DEVICE Penargetan perangkat.
TARGETING_TYPE_GEO Penargetan geografis.
TARGETING_TYPE_INTEREST Penargetan minat.
TARGETING_TYPE_PURCHASE_INTENT Penargetan niat membeli.
TARGETING_TYPE_REMARKETING Penargetan pemasaran ulang.

TermsOfService

Persyaratan layanan yang telah disetujui/ditolak oleh 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 wajib diisi 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 penelepon telah memilih untuk menyetujui persyaratan layanan.
REJECTED Status yang menunjukkan bahwa penelepon 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. Selanjutnya, 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 mengakumulasi 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 dilisensikan.

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 daftar penggunanya.
client_account_id

int64

Tidak dapat diubah. ID pelanggan klien yang diberi lisensi untuk daftar pengguna.
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 dilisensikan.

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. Paket 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 dilisensikan.
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 untuk daftar pengguna.
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 tanggal 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 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.

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

int64

Opsional. CPM maksimum yang dapat dibebankan kepada audiens 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.

ViewType

Jenis peristiwa.

Enum
VIEW_TYPE_UNSPECIFIED Jenis tampilan tidak ditentukan.
VIEW_TYPE_MRC_VIEWED MRC dilihat.
VIEW_TYPE_MRC_RENDERED MRC ditampilkan.

ViewabilityInfo

Detail visibilitas iklan yang ditayangkan.

Kolom
view_type

ViewType

Wajib. Jenis peristiwa.
viewable_percent

int32

Opsional. Persen numerik (0-100) piksel yang terlihat.
viewable_duration

Duration

Opsional. Durasi iklan dapat dilihat.
media_skippable

bool

Opsional. Apakah media iklan dapat dilewati atau tidak.
media_quartile

MediaQuartile

Opsional. Jumlah media yang diputar sebagai kuartil terpisah.
media_duration

Duration

Opsional. Durasi media iklan.
media_volume_percent

int32

Opsional. Persen numerik (0-100) volume pemutaran media.
playback_duration

Duration

Opsional. Durasi pemutaran media iklan, terlepas dari apakah iklan tersebut dapat dilihat atau tidak.

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.