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 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 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 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 dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

Hanya dikembalikan 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 dikembalikan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit penting.

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

string (int64 format)

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

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

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

string (int64 format)

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

string

appId cocok dengan jenis mobileDeviceId yang diupload.

Hanya berlaku untuk audienceType CUSTOMER_MATCH_DEVICE_ID
Kolom union members. Anggota awal audiens Customer Match. members hanya ada berupa salah satu diantara 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

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 (ContactInfo)
    }
  ]
}
Kolom
contactInfos[]

object (ContactInfo)

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

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 semua string menggunakan 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 panggilan 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 semua 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 semua string menggunakan huruf kecil.

Juga harus ditetapkan dengan kolom berikut:
countryCode

string

Kode negara anggota.

Juga harus ditetapkan dengan kolom berikut:

MobileDeviceIdList

Pesan wrapper untuk daftar ID perangkat seluler yang menentukan anggota audiens Customer Match.

Representasi JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
Kolom
mobileDeviceIds[]

string

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

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.