- Resource: FirstPartyAndPartnerAudience
- FirstPartyAndPartnerAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Izin
- ConsentStatus
- MobileDeviceIdList
- Metode
Resource: FirstPartyAndPartnerAudience
Menjelaskan daftar audiens pihak pertama atau partner yang digunakan untuk penargetan. Audiens pihak pertama dibuat melalui penggunaan data klien. Audiens partner disediakan oleh Penyedia data pihak ketiga dan hanya dapat dilisensikan kepada pelanggan.
Representasi JSON |
---|
{ "name": string, "firstPartyAndPartnerAudienceId": string, "displayName": string, "description": string, "firstPartyAndPartnerAudienceType": enum ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource audiens pihak pertama dan partner. |
firstPartyAndPartnerAudienceId |
ID. ID unik audiens pihak pertama dan partner. Ditugaskan oleh sistem. |
displayName |
Hanya output. Nama tampilan audiens pihak pertama dan partner. |
description |
Hanya output. Deskripsi audiens yang diberikan pengguna. Hanya berlaku untuk audiens pihak pertama. |
firstPartyAndPartnerAudienceType |
Hanya output. Apakah audiens adalah audiens pihak pertama dan partner. |
audienceType |
Hanya output. Jenis audiens. |
audienceSource |
Hanya output. Sumber audiens. |
membershipDurationDays |
Hanya output. Durasi dalam hari saat entri tetap berada di audiens setelah peristiwa kualifikasi. Jika audiens tidak memiliki masa berlaku, tetapkan nilai kolom ini ke 10000. 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
|
displayAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan Display. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya ditampilkan dalam permintaan GET. |
activeDisplayAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan Display dalam sebulan terakhir. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya ditampilkan dalam permintaan GET. |
youtubeAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan YouTube. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya berlaku untuk audiens pihak pertama. Hanya ditampilkan dalam permintaan GET. |
gmailAudienceSize |
Hanya output. Estimasi ukuran audiens untuk jaringan Gmail. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya berlaku untuk audiens pihak pertama. Hanya ditampilkan dalam permintaan GET. |
displayMobileAppAudienceSize |
Hanya output. Estimasi ukuran audiens aplikasi seluler di jaringan Display. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya berlaku untuk audiens pihak pertama. Hanya ditampilkan dalam permintaan GET. |
displayMobileWebAudienceSize |
Hanya output. Estimasi ukuran audiens web seluler di jaringan Display. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya berlaku untuk audiens pihak pertama. Hanya ditampilkan dalam permintaan GET. |
displayDesktopAudienceSize |
Hanya output. Estimasi ukuran audiens desktop di jaringan Display. Jika ukurannya kurang dari 1.000, angka tersebut akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua angka penting. Hanya berlaku untuk audiens pihak pertama. Hanya ditampilkan dalam permintaan GET. |
appId |
Opsional. appId cocok dengan jenis mobileDeviceIds yang diupload. Hanya berlaku untuk |
Kolom union members . Anggota awal audiens Customer Match. members hanya dapat berupa salah satu dari 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 |
FirstPartyAndPartnerAudienceType
Kemungkinan jenis resource audiens pihak pertama dan partner.
Enum | |
---|---|
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED |
Nilai default saat jenis tidak ditentukan atau tidak diketahui. |
TYPE_FIRST_PARTY |
Audiens yang dibuat melalui penggunaan data klien. |
TYPE_PARTNER |
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 dengan mencocokkan pelanggan dengan ID Perangkat seluler yang diketahui. |
CUSTOMER_MATCH_USER_ID |
Audiens dibuat dengan mencocokkan pelanggan dengan ID Pengguna yang diketahui. |
ACTIVITY_BASED |
Audiens dibuat berdasarkan aktivitas kampanye. |
FREQUENCY_CAP |
Audiens dibuat berdasarkan pengecualian jumlah tayangan yang ditayangkan kepada mereka. |
TAG_BASED |
Audiens dibuat berdasarkan variabel kustom yang dilampirkan ke piksel. |
YOUTUBE_USERS |
Audiens dibuat berdasarkan interaksi sebelumnya dengan video, iklan YouTube, atau channel YouTube. |
THIRD_PARTY |
Audiens telah dilisensikan untuk digunakan dari pihak ketiga. |
COMMERCE |
Audiens yang disediakan oleh partner Commerce dengan biaya. |
LINEAR |
Audiens untuk konten TV Linear. |
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 contactInfos tidak boleh lebih dari 500.000. |
consent |
Hanya input. Setelan izin untuk pengguna di Jika kolom ini tidak ditetapkan, 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 string menggunakan huruf kecil. |
hashedPhoneNumbers[] |
Daftar nomor telepon anggota yang di-hash SHA256. Sebelum di-hash, semua nomor telepon harus diformat menggunakan format E.164 dan menyertakan kode telepon 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 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 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 |
Merepresentasikan 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 dalam 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 mobileDeviceIds tidak boleh lebih dari 500.000. |
consent |
Hanya input. Setelan izin untuk pengguna di Jika kolom ini tidak ditetapkan, berarti izin tidak ditentukan. Jika kolom |
Metode |
|
---|---|
|
Membuat FirstPartyAndPartnerAudience. |
|
Memperbarui daftar anggota audiens Customer Match. |
|
Mendapatkan audiens pihak pertama atau partner. |
|
Mencantumkan audiens pihak pertama dan partner. |
|
Memperbarui FirstPartyAndPartnerAudience yang ada. |