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
}
Kolom
name

string

Hanya output. Nama resource audiens pihak pertama dan partner.
firstPartyAndPartnerAudienceId

string (int64 format)

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

string

Opsional. Nama tampilan audiens pihak pertama dan partner.
description

string

Opsional. Deskripsi audiens yang diberikan pengguna.

Hanya berlaku untuk audiens pihak pertama.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

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

enum (AudienceType)

Tidak dapat diubah. Jenis audiens.
audienceSource

enum (AudienceSource)

Hanya output. Sumber audiens.
membershipDurationDays

string (int64 format)

Opsional. Durasi dalam hari saat entri tetap berada di audiens setelah peristiwa yang memenuhi syarat. 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 akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit signifikan.

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 akan disembunyikan dan 0 akan ditampilkan karena alasan privasi. Jika tidak, angka akan dibulatkan menjadi dua digit signifikan.

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

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

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

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

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

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

FirstPartyAndPartnerAudienceType

Kemungkinan jenis resource audiens pihak pertama dan partner.

Enum
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Nilai default jika 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 jika 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 melalui pencocokan pelanggan dengan ID Pengguna yang diketahui.
ACTIVITY_BASED

Tidak digunakan lagi: Audiens dibuat berdasarkan aktivitas kampanye.
FREQUENCY_CAP

Tidak digunakan lagi: Audiens dibuat berdasarkan pengecualian jumlah tayangan yang ditayangkan kepada mereka.
TAG_BASED Audiens dibuat berdasarkan variabel kustom yang disertakan 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 tertentu.
LINEAR Audiens untuk konten TV Linear.
AGENCY Audiens yang disediakan oleh agensi.

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.

Metode

get

 Mendapatkan audiens pihak pertama atau partner.

list

 Mencantumkan audiens pihak pertama dan partner.