REST Resource: firstAndThirdPartyAudiences

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 (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
Kolom
name

string

Hanya output. Nama resource audiens pihak pertama dan ketiga.

firstAndThirdPartyAudienceId

string (int64 format)

Hanya output. ID unik audiens pihak pertama dan ketiga. Ditetapkan oleh sistem.

displayName

string

Nama tampilan audiens pihak pertama dan ketiga.

description

string

Deskripsi audiens yang diberikan pengguna.

Hanya berlaku untuk audiens pihak pertama.

firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Apakah audiens tersebut adalah audiens pihak pertama atau ketiga.

audienceType

enum (AudienceType)

Jenis audiens.

audienceSource

enum (AudienceSource)

Hanya output. Sumber audiens.

membershipDurationDays

string (int64 format)

Durasi dalam hari entri tetap berada di audiens setelah peristiwa yang memenuhi syarat. Jika audiens tidak memiliki 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 ada jika salah satu dari audienceType berikut digunakan:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens untuk Jaringan Display.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya ditampilkan dalam permintaan GET.

activeDisplayAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens untuk Jaringan Display pada bulan lalu.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya ditampilkan dalam permintaan GET.

youtubeAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens untuk jaringan YouTube.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya berlaku untuk audiens pihak pertama.

Hanya ditampilkan dalam permintaan GET.

gmailAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens untuk jaringan Gmail.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya berlaku untuk audiens pihak pertama.

Hanya ditampilkan dalam permintaan GET.

displayMobileAppAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens aplikasi seluler di Jaringan Display.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya berlaku untuk audiens pihak pertama.

Hanya ditampilkan dalam permintaan GET.

displayMobileWebAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens web seluler di Jaringan Display.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya berlaku untuk audiens pihak pertama.

Hanya ditampilkan dalam permintaan GET.

displayDesktopAudienceSize

string (int64 format)

Hanya output. Estimasi ukuran audiens desktop di Jaringan Display.

Jika ukurannya kurang dari 1.000, angka akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya berlaku untuk audiens pihak pertama.

Hanya ditampilkan dalam permintaan GET.

appId

string

appId cocok dengan jenis mobileDeviceIds yang diupload.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_DEVICE_ID

Kolom union members. Anggota awal audiens Customer Match. members hanya dapat berupa salah satu dari berikut:
contactInfoList

object (ContactInfoList)

Input saja. Daftar informasi kontak untuk menentukan anggota audiens awal.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_CONTACT_INFO

mobileDeviceIdList

object (MobileDeviceIdList)

Input saja. Daftar ID perangkat seluler untuk menentukan anggota audiens awal.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_DEVICE_ID

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 melalui pencocokan 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 kustom yang disertakan ke piksel.
YOUTUBE_USERS Audiens dibuat berdasarkan interaksi terdahulu dengan video, iklan YouTube, atau channel YouTube.
LICENSED Subjenis audiens pihak ketiga.

AudienceSource

Kemungkinan sumber audiens.

Enum
AUDIENCE_SOURCE_UNSPECIFIED Nilai default jika 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 (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
Kolom
contactInfos[]

object (ContactInfo)

Daftar objek ContactInfo yang menentukan anggota audiens Customer Match. Ukuran anggota setelah memisahkan contactInfos tidak boleh lebih dari 500.000.

consent

object (Consent)

Input saja. Setelan izin untuk pengguna di contactInfos.

Jika kolom ini tidak disetel, izin tidak akan ditentukan.

Jika kolom adUserData atau adPersonalization ditetapkan ke CONSENT_STATUS_DENIED, permintaan akan menampilkan error.

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

string

Daftar email anggota yang di-hash SHA256. Sebelum hashing, hapus semua spasi kosong dan pastikan string semuanya dalam huruf kecil.

hashedPhoneNumbers[]

string

Daftar nomor telepon anggota yang di-hash SHA256. Sebelum melakukan hashing, semua nomor telepon harus diformat menggunakan format E.164 dan menyertakan kode telepon negara.

zipCodes[]

string

Daftar kode pos anggota.

Juga harus ditetapkan dengan kolom berikut:

hashedFirstName

string

SHA256 melakukan hashing pada nama depan anggota. Sebelum hashing, hapus semua spasi kosong dan pastikan string semuanya dalam huruf kecil.

Juga harus ditetapkan dengan kolom berikut:

hashedLastName

string

SHA256 yang melakukan hashing pada nama belakang anggota. Sebelum hashing, hapus semua spasi kosong dan pastikan string semuanya dalam huruf kecil.

Juga harus ditetapkan dengan kolom berikut:

countryCode

string

Kode negara pelanggan.

Juga harus ditetapkan dengan kolom berikut:

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 (Consent)
  }
}
Kolom
mobileDeviceIds[]

string

Daftar ID perangkat seluler yang menentukan anggota audiens Customer Match. Ukuran mobileDeviceIds tidak boleh lebih dari 500.000.

consent

object (Consent)

Input saja. Setelan izin untuk pengguna di mobileDeviceIds.

Jika kolom ini tidak disetel, izin tidak akan ditentukan.

Jika kolom adUserData atau adPersonalization ditetapkan ke CONSENT_STATUS_DENIED, permintaan akan menampilkan error.

Metode

create

Membuat FirstAndThirdPartyAudience.

editCustomerMatchMembers

Memperbarui daftar anggota audiens Customer Match.

get

Mendapatkan audiens pihak pertama dan ketiga.

list

Mencantumkan audiens pihak pertama dan ketiga.

patch

Memperbarui FirstAndThirdPartyAudience yang ada.