REST Resource: advertisers

Resource: Advertiser

Satu pengiklan di Display & Video 360 (DV360).

Representasi JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Kolom
name

string

Hanya output. Nama resource pengiklan.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan. Ditetapkan oleh sistem.
partnerId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik partner yang menjadi bagian pengiklan.
displayName

string

Wajib. Nama tampilan pengiklan.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.
entityStatus

enum (EntityStatus)

Wajib. Mengontrol apakah pesanan pemasangan dan item baris pengiklan dapat membelanjakan anggaran dan mengajukan bid pada inventaris atau tidak.

  • Nilai yang diterima adalah ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED, dan ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Jika disetel ke ENTITY_STATUS_SCHEDULED_FOR_DELETION, pengiklan akan dihapus 30 hari sejak pertama kali dijadwalkan untuk dihapus.
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat pengiklan terakhir diperbarui. Ditetapkan oleh sistem.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
generalConfig

object (AdvertiserGeneralConfig)

Wajib. Setelan umum pengiklan.
adServerConfig

object (AdvertiserAdServerConfig)

Wajib. Tidak dapat diubah. Setelan terkait server iklan pengiklan.
creativeConfig

object (AdvertiserCreativeConfig)

Wajib. Setelan terkait materi iklan pengiklan.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Setelan yang mengontrol cara data pengiklan dapat diakses.
integrationDetails

object (IntegrationDetails)

Detail integrasi pengiklan. Saat ini hanya integrationCode yang berlaku untuk pengiklan. Kolom IntegrationDetails lainnya tidak didukung dan akan diabaikan jika diberikan.
servingConfig

object (AdvertiserTargetingConfig)

Setelan penargetan yang terkait dengan penayangan iklan pengiklan.
prismaEnabled

boolean

Apakah integrasi dengan Mediaocean (Prisma) diaktifkan atau tidak. Dengan mengaktifkan fitur ini, Anda menyetujui hal-hal berikut:

Atas nama perusahaan saya, saya mengizinkan Mediaocean (Prisma) untuk mengirim rencana segmen anggaran ke Google, dan saya mengizinkan Google untuk mengirim laporan dan invoice yang sesuai dari DV360 ke Mediaocean untuk tujuan perencanaan anggaran, penagihan, dan rekonsiliasi untuk pengiklan ini.
billingConfig

object (AdvertiserBillingConfig)

Wajib. Setelan terkait penagihan pengiklan.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Opsional. Apakah pengiklan ini berisi item baris yang menayangkan iklan politik Uni Eropa.

Jika kolom ini ditetapkan ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, maka hal berikut akan terjadi:

  • Semua item baris baru yang dibuat di bawah pengiklan ini akan diberi DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING jika tidak ditentukan lain.
  • Semua item baris yang ada di pengiklan ini yang tidak memiliki nilai yang ditetapkan akan diperbarui menjadi DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING dalam waktu hari.

AdvertiserGeneralConfig

Setelan umum pengiklan.

Representasi JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Kolom
domainUrl

string

Wajib. URL domain situs utama pengiklan. Sistem akan mengirimkan informasi ini kepada penayang yang memerlukan URL situs untuk mengaitkan kampanye dengan pengiklan.

Berikan URL tanpa jalur atau string kueri, yang diawali dengan http: atau https:. Misalnya, http://www.example.com
timeZone

string

Hanya output. Nama database TZ standar zona waktu pengiklan. Misalnya, America/New_York.

Lihat selengkapnya di: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Untuk pengiklan hibrida CM360, zona waktunya sama dengan zona waktu akun CM360 terkait; untuk pengiklan khusus pihak ketiga, zona waktunya sama dengan zona waktu partner induk.
currencyCode

string

Wajib. Tidak dapat diubah. Mata uang pengiklan dalam format ISO 4217.

Kode yang diterima dan mata uang yang diwakilinya adalah:

Kode Mata Uang : Nama Mata Uang

  • ARS : Peso Argentina
  • AUD : Dolar Australia
  • BRL : Real Brasil
  • CAD : Dolar Kanada
  • CHF : Franc Swiss
  • CLP : Peso Cile
  • CNY : Yuan China
  • COP : Peso Kolombia
  • CZK : Koruna Ceko
  • DKK : Krone Denmark
  • EGP : Pound Mesir
  • EUR : Euro
  • GBP : Pound Sterling Inggris
  • HKD : Dolar Hong Kong
  • HUF : Forint Hungaria
  • IDR : Rupiah Indonesia
  • ILS : Shekel Israel
  • INR : Rupee India
  • JPY : Yen Jepang
  • KRW : Won Korea Selatan
  • MXN : Peso Meksiko
  • MYR : Ringgit Malaysia
  • NGN : Naira Nigeria
  • NOK : Krone Norwegia
  • NZD : Dolar Selandia Baru
  • PEN : Nuevo Sol Peru
  • PLN : Zloty Polandia
  • RON : Leu Rumania Baru
  • RUB : Rubel Rusia
  • SEK : Krona Swedia
  • TRY : Lira Turkiye
  • TWD : Dolar Taiwan Baru
  • USD : Dolar Amerika Serikat
  • ZAR : Rand Afrika Selatan

AdvertiserAdServerConfig

Setelan terkait server iklan pengiklan.

Representasi JSON 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Kolom
Kolom union ad_server_config_scheme. Wajib. ad_server_config_scheme hanya dapat berupa salah satu dari berikut:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Konfigurasi hanya untuk pengiklan yang menggunakan server iklan pihak ketiga.
cmHybridConfig

object (CmHybridConfig)

Konfigurasi untuk pengiklan yang menggunakan Campaign Manager 360 (CM360) dan server iklan pihak ketiga.

ThirdPartyOnlyConfig

Setelan untuk pengiklan yang hanya menggunakan server iklan pihak ketiga.

Representasi JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
Kolom
pixelOrderIdReportingEnabled

boolean

Apakah pelaporan ID pesanan untuk piksel diaktifkan atau tidak. Nilai ini tidak dapat diubah setelah ditetapkan ke true.

CmHybridConfig

Setelan untuk pengiklan yang menggunakan Campaign Manager 360 (CM360) dan server iklan pihak ketiga.

Representasi JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Kolom
cmAccountId

string (int64 format)

Wajib. Tidak dapat diubah. ID akun konfigurasi Floodlight CM360 yang ditautkan dengan pengiklan DV360.
cmFloodlightConfigId

string (int64 format)

Wajib. Tidak dapat diubah. ID konfigurasi Floodlight CM360 yang ditautkan dengan pengiklan DV360.
cmAdvertiserIds[]

string (int64 format)

Hanya output. Kumpulan ID Pengiklan CM360 yang berbagi konfigurasi Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

Daftar situs CM360 yang penempatannya akan disinkronkan ke DV360 sebagai materi iklan.

Jika tidak ada atau kosong dalam metode advertisers.create, sistem akan otomatis membuat situs CM360.

Menghapus situs dari daftar ini dapat menyebabkan materi iklan DV360 yang disinkronkan dari CM360 dihapus. Setidaknya satu situs harus ditentukan.
dv360ToCmDataSharingEnabled

boolean

Apakah akan menyertakan data DV360 dalam laporan transfer data CM360 atau tidak.
dv360ToCmCostReportingEnabled

boolean

Apakah akan melaporkan biaya DV360 ke CM360 atau tidak.
cmFloodlightLinkingAuthorized

boolean

Wajib. Tidak dapat diubah. Dengan menyetel kolom ini ke true, Anda, atas nama perusahaan Anda, mengizinkan berbagi informasi dari konfigurasi Floodlight yang diberikan ke pengiklan Display & Video 360 ini.

AdvertiserCreativeConfig

Setelan terkait materi iklan pengiklan.

Representasi JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Kolom
iasClientId

string (int64 format)

ID untuk mengonfigurasi pemantauan kampanye yang disediakan oleh Integral Ad Service (IAS). Sistem DV360 akan menambahkan tag "Campaign Monitor" IAS yang berisi ID ini ke tag materi iklan.
obaComplianceDisabled

boolean

Apakah akan menonaktifkan fitur Tentang Iklan ini dari Google yang menambahkan badge (untuk mengidentifikasi konten sebagai iklan) dan informasi transparansi (saat berinteraksi dengan Tentang Iklan ini) ke iklan Anda untuk Iklan Berbasis Perilaku Online (OBA) dan persyaratan peraturan. Tentang Iklan ini memberi pengguna kontrol yang lebih besar atas iklan yang mereka lihat dan membantu Anda menjelaskan alasan iklan Anda ditampilkan kepada mereka. Pelajari lebih lanjut.

Jika Anda memilih untuk menyetel kolom ini ke true, perhatikan bahwa iklan yang ditayangkan melalui Display & Video 360 harus mematuhi hal berikut:

  • Mematuhi Iklan Berbasis Perilaku Online (OBA), sesuai dengan kontrak Anda dengan Google Marketing Platform.
  • Di Wilayah Ekonomi Eropa (EEA), sertakan informasi transparansi dan mekanisme bagi pengguna untuk melaporkan konten ilegal dalam iklan. Jika menggunakan solusi alternatif untuk badge iklan, transparansi, dan pelaporan, Anda harus memastikan solusi tersebut menyertakan informasi transparansi yang diperlukan dan mekanisme penandaan konten ilegal serta Anda memberi tahu Google tentang laporan konten ilegal apa pun menggunakan formulir yang sesuai.
dynamicCreativeEnabled

boolean

Apakah pengiklan diaktifkan untuk materi iklan dinamis atau tidak.
videoCreativeDataSharingAuthorized

boolean

Dengan menyetel kolom ini ke true, Anda, atas nama perusahaan Anda, mengizinkan Google menggunakan materi iklan video yang terkait dengan pengiklan Display & Video 360 ini untuk memberikan pelaporan dan fitur yang terkait dengan kampanye televisi pengiklan.

Hanya berlaku jika pengiklan memiliki konfigurasi server iklan CM360 hybrid.

AdvertiserDataAccessConfig

Setelan yang mengontrol cara akses data terkait pengiklan.

Representasi JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Kolom
sdfConfig

object (AdvertiserSdfConfig)

Setelan File Data Terstruktur (SDF) untuk pengiklan.

Jika tidak ditentukan, setelan SDF partner induk akan digunakan.

AdvertiserSdfConfig

Setelan File Data Terstruktur (SDF) pengiklan.

Representasi JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Kolom
overridePartnerSdfConfig

boolean

Apakah pengiklan ini mengganti konfigurasi SDF partner induknya atau tidak.

Secara default, pengiklan mewarisi konfigurasi SDF dari partner induk. Untuk mengganti konfigurasi partner, setel kolom ini ke true dan berikan konfigurasi baru di sdfConfig.
sdfConfig

object (SdfConfig)

Konfigurasi SDF untuk pengiklan.

AdvertiserTargetingConfig

Setelan penargetan yang terkait dengan penayangan iklan pengiklan.

Representasi JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Kolom
exemptTvFromViewabilityTargeting

boolean

Apakah perangkat TV yang terhubung dikecualikan dari penargetan keaktifan untuk semua item baris video di bawah pengiklan.

AdvertiserBillingConfig

Setelan terkait penagihan pengiklan.

Representasi JSON 
{
  "billingProfileId": string
}
Kolom
billingProfileId

string (int64 format)

Wajib. ID profil penagihan yang ditetapkan ke pengiklan.

Metode

audit

 Mengaudit pengiklan.

create

 Membuat pengiklan baru.

delete

 Menghapus pengiklan.

editAssignedTargetingOptions

 Mengedit opsi penargetan di satu pengiklan.

get

 Mendapatkan pengiklan.

list

 Mencantumkan pengiklan yang dapat diakses oleh pengguna saat ini.

listAssignedTargetingOptions

 Mencantumkan opsi penargetan yang ditetapkan pengiklan di berbagai jenis penargetan.

patch

 Memperbarui pengiklan yang ada.