- Referensi: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Izin
- ConsentStatus
- MobileDeviceIdList
- Metode
Referensi: FirstAndThirdPartyAudience
Menjelaskan daftar audiens pihak pertama atau ketiga yang digunakan untuk penargetan. Audiens pihak pertama dibuat melalui penggunaan data klien. Audiens pihak ketiga disediakan oleh penyedia data Pihak Ketiga dan hanya dapat dilisensikan kepada pelanggan.
Representasi JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource audiens pihak pertama dan ketiga. |
firstAndThirdPartyAudienceId |
Hanya output. ID unik audiens pihak pertama dan ketiga. Ditetapkan oleh sistem. |
displayName |
Nama tampilan audiens pihak pertama dan ketiga. |
description |
Deskripsi audiens yang diberikan pengguna. Hanya berlaku untuk audiens pihak pertama. |
firstAndThirdPartyAudienceType |
Apakah audiens adalah audiens pihak pertama atau ketiga. |
audienceType |
Jenis audiens. |
audienceSource |
Hanya output. Sumber audiens. |
membershipDurationDays |
Durasi dalam hari saat entri tetap berada di audiens setelah acara kualifikasi. Jika audiens belum memiliki tanggal habis masa berlaku, tetapkan nilai kolom ini ke 10.000. Jika tidak, nilai yang ditetapkan harus lebih besar dari 0 dan kurang dari atau sama dengan 540. Hanya berlaku untuk audiens pihak pertama. Kolom ini wajib diisi jika salah satu dari
|
displayAudienceSize |
Hanya output. Estimasi ukuran audiens untuk Jaringan Display. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya dikembalikan dalam permintaan GET. |
activeDisplayAudienceSize |
Hanya output. Estimasi ukuran audiens untuk Jaringan Display pada bulan lalu. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya dikembalikan dalam permintaan GET. |
youtubeAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan YouTube. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya berlaku untuk audiens pihak pertama. Hanya dikembalikan dalam permintaan GET. |
gmailAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan Gmail. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya berlaku untuk audiens pihak pertama. Hanya dikembalikan dalam permintaan GET. |
displayMobileAppAudienceSize |
Hanya output. Estimasi ukuran audiens aplikasi seluler di Jaringan Display. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya berlaku untuk audiens pihak pertama. Hanya dikembalikan dalam permintaan GET. |
displayMobileWebAudienceSize |
Hanya output. Estimasi ukuran audiens web seluler di Jaringan Display. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya berlaku untuk audiens pihak pertama. Hanya dikembalikan dalam permintaan GET. |
displayDesktopAudienceSize |
Hanya output. Estimasi ukuran audiens desktop di Jaringan Display. Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting. Hanya berlaku untuk audiens pihak pertama. Hanya dikembalikan dalam permintaan GET. |
appId |
appId cocok dengan jenis mobileDeviceId yang diupload. Hanya berlaku untuk |
Kolom union members . Anggota awal audiens Customer Match. members hanya ada berupa salah satu diantara berikut: |
|
contactInfoList |
Hanya input. Daftar informasi kontak untuk menentukan anggota audiens awal. Hanya berlaku untuk |
mobileDeviceIdList |
Hanya input. Daftar ID perangkat seluler untuk menentukan anggota audiens awal. Hanya berlaku untuk |
FirstAndThirdPartyAudienceType
Kemungkinan jenis resource audiens pihak pertama dan ketiga.
Enum | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
Nilai default saat jenis tidak ditentukan atau tidak diketahui. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Audiens yang dibuat melalui penggunaan data klien. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Audiens yang disediakan oleh penyedia data Pihak Ketiga. |
AudienceType
Kemungkinan jenis audiens.
Enum | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
Nilai default saat jenis tidak ditentukan atau tidak diketahui. |
CUSTOMER_MATCH_CONTACT_INFO |
Audiens dibuat dengan mencocokkan pelanggan dengan informasi kontak yang diketahui. |
CUSTOMER_MATCH_DEVICE_ID |
Audiens dibuat melalui pencocokan pelanggan dengan ID perangkat seluler yang diketahui. |
CUSTOMER_MATCH_USER_ID |
Audiens dibuat melalui pencocokan pelanggan dengan ID Pengguna yang diketahui. |
ACTIVITY_BASED |
Audiens dibuat berdasarkan aktivitas kampanye. |
FREQUENCY_CAP |
Audiens dibuat berdasarkan pengecualian jumlah tayangan yang ditayangkan. |
TAG_BASED |
Audiens dibuat berdasarkan variabel khusus yang dilampirkan pada piksel. |
YOUTUBE_USERS |
Audiens dibuat berdasarkan interaksi sebelumnya dengan video, iklan YouTube, atau channel YouTube. |
LICENSED |
Subjenis jenis audiens pihak ketiga. |
AudienceSource
Kemungkinan sumber audiens.
Enum | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Nilai default saat sumber audiens tidak ditentukan atau tidak diketahui. |
DISPLAY_VIDEO_360 |
Berasal dari Display & Video 360. |
CAMPAIGN_MANAGER |
Berasal dari Campaign Manager 360. |
AD_MANAGER |
Berasal dari Google Ad Manager. |
SEARCH_ADS_360 |
Berasal dari Search Ads 360. |
YOUTUBE |
Berasal dari YouTube. |
ADS_DATA_HUB |
Berasal dari Ads Data Hub. |
ContactInfoList
Pesan wrapper untuk daftar informasi kontak yang menentukan anggota audiens Customer Match.
Representasi JSON |
---|
{ "contactInfos": [ { object ( |
Kolom | |
---|---|
contactInfos[] |
Daftar objek ContactInfo yang menentukan anggota audiens Customer Match. Ukuran anggota setelah memisahkan contactInfo tidak boleh lebih dari 500.000. |
consent |
Hanya input. Setelan izin untuk pengguna di Jika kolom ini tidak disetel, berarti izin tidak ditentukan. Jika kolom |
ContactInfo
Informasi kontak yang menentukan anggota audiens Customer Match.
Representasi JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Kolom | |
---|---|
hashedEmails[] |
Daftar email anggota yang di-hash SHA256. Sebelum melakukan hashing, hapus semua spasi kosong dan pastikan semua string menggunakan huruf kecil. |
hashedPhoneNumbers[] |
Daftar nomor telepon anggota yang di-hash SHA256. Sebelum melakukan hashing, semua nomor telepon harus diformat menggunakan format E.164 dan menyertakan kode panggilan negara. |
zipCodes[] |
Daftar kode pos anggota. Juga harus ditetapkan dengan kolom berikut: |
hashedFirstName |
Nama depan anggota yang di-hash SHA256. Sebelum melakukan hashing, hapus semua spasi kosong dan pastikan semua string menggunakan huruf kecil. Juga harus ditetapkan dengan kolom berikut: |
hashedLastName |
Nama belakang anggota yang di-hash SHA256. Sebelum melakukan hashing, hapus semua spasi kosong dan pastikan semua string menggunakan huruf kecil. Juga harus ditetapkan dengan kolom berikut: |
countryCode |
Kode negara anggota. Juga harus ditetapkan dengan kolom berikut: |
Izin
Status izin pengguna.
Representasi JSON |
---|
{ "adUserData": enum ( |
Kolom | |
---|---|
adUserData |
Menunjukkan izin untuk data pengguna iklan. |
adPersonalization |
Mewakili izin untuk personalisasi iklan. |
ConsentStatus
Status izin.
Enum | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Nilai jenis tidak ditentukan atau tidak diketahui pada versi ini. |
CONSENT_STATUS_GRANTED |
Izin diberikan. |
CONSENT_STATUS_DENIED |
Izin ditolak. |
MobileDeviceIdList
Pesan wrapper untuk daftar ID perangkat seluler yang menentukan anggota audiens Customer Match.
Representasi JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Kolom | |
---|---|
mobileDeviceIds[] |
Daftar ID perangkat seluler yang menentukan anggota audiens Customer Match. Ukuran mobileDeviceId tidak boleh lebih dari 500.000. |
consent |
Hanya input. Setelan izin untuk pengguna di Jika kolom ini tidak disetel, berarti izin tidak ditentukan. Jika kolom |
Metode |
|
---|---|
|
Membuat FirstAndThirdPartyAudience. |
|
Memperbarui daftar anggota audiens Customer Match. |
|
Mendapatkan audiens pihak pertama dan ketiga. |
|
Mencantumkan audiens pihak pertama dan ketiga. |
|
Memperbarui FirstAndThirdPartyAudience yang ada. |