REST Resource: firstPartyAndPartnerAudiences

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 (FirstPartyAndPartnerAudienceType),
  "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 partner.
firstPartyAndPartnerAudienceId

string (int64 format)

ID. ID unik audiens pihak pertama dan partner. Ditugaskan oleh sistem.
displayName

string

Hanya output. Nama tampilan audiens pihak pertama dan partner.
description

string

Hanya output. Deskripsi audiens yang diberikan pengguna.

Hanya berlaku untuk audiens pihak pertama.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Hanya output. Apakah audiens adalah audiens pihak pertama dan partner.
audienceType

enum (AudienceType)

Hanya output. Jenis audiens.
audienceSource

enum (AudienceSource)

Hanya output. Sumber audiens.
membershipDurationDays

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

Hanya input. Daftar informasi kontak untuk menentukan anggota audiens awal.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

Hanya input. Daftar ID perangkat seluler untuk menentukan anggota audiens awal.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_DEVICE_ID

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

Hanya input. Setelan izin untuk pengguna di contactInfos.

Jika kolom ini tidak ditetapkan, berarti izin tidak 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 melakukan hashing, hapus semua spasi kosong dan pastikan string menggunakan huruf kecil.
hashedPhoneNumbers[]

string

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

string

Daftar kode pos anggota.

Juga harus ditetapkan dengan kolom berikut:
hashedFirstName

string

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

string

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

string

Kode negara anggota.

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)

Hanya input. Setelan izin untuk pengguna di mobileDeviceIds.

Jika kolom ini tidak ditetapkan, berarti izin tidak ditentukan.

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

Metode

create

 Membuat FirstPartyAndPartnerAudience.

editCustomerMatchMembers

 Memperbarui daftar anggota audiens Customer Match.

get

 Mendapatkan audiens pihak pertama atau partner.

list

 Mencantumkan audiens pihak pertama dan partner.

patch

 Memperbarui FirstPartyAndPartnerAudience yang ada.