Makro untuk Penyisipan Iklan Dinamis

Lihat informasi selengkapnya tentang makro, termasuk cara kerjanya dengan Ad Manager dan daftar lengkap terkait rendering, pelacakan, dan makro video lainnya.

Langsung ke bagian makro tertentu dalam daftar

Makro panggilan iklan                 Framework API APP bundle Kunci aset Durasi maksimum jeda iklan Posisi jeda Cachebusting Client ID ID CMS DAI_PRE Domain FW CAID GDPR Izin GDPR	Nonce video dalam stream Google IFA Jenis IFA Batasi pelacakan iklan MIME Media Iklan yang tidak dipersonalisasi Partner OMID URL Halaman Jenis penempatan Peraturan SCTE-35 Sisi server ID streaming	TFCD TFUA Stempel waktu ID Transaksi Privasi AS Agen pengguna Alamat IP pengguna Durasi video Durasi video dalam detik ID Video Judul video
Makro pelacakan VAST                Cachebusting Kode error

Luaskan semua  Ciutkan semua

Makro panggilan iklan

Makro panggilan iklan yang ditampilkan di sini hanya dapat digunakan dalam tag iklan untuk Penyisipan Iklan Dinamis (DAI) untuk sumber konten video on-demand atau live stream. Makro permintaan iklan ini tidak berfungsi dalam konteks materi iklan VAST.

Makro kurung siku umumnya diwajibkan guna meneruskan validasi makro Ad Manager untuk pengalihan.

Framework API

 

Makro
[APIFRAMEWORKS]

 

Parameter sdk_apis.

 

APP bundle

 

Makro
[APPBUNDLE]

 

Parameter an.

Kunci aset

 

Makro
%%ASSET_KEY%%

 

Memperluas ke kode peristiwa live stream.

Posisi jeda

 

Makro
[BREAKPOSITION]

 

Makro VAST 4.1. Menampilkan nilai:

1: untuk pre-roll
2: untuk mid-roll
3: untuk post-roll
4: untuk mandiri
0: untuk tidak satu pun dari opsi di atas/lainnya

Durasi maksimum jeda iklan

 

Makro
%%BREAK_DURATION%%
[BREAKMAXDURATION]

 

Durasi jeda iklan saat ini, dalam detik.

[BREAKMAXDURATION] hanya boleh digunakan untuk pengalihan Ad Manager yang tidak mengizinkan %%BREAK_DURATION%%.

Cachebusting

 

Makro
[CACHEBUSTING]

 

Nomor acak.

Client ID

 

Makro
[CLIENTUA]

 

ID pemutar dan klien VAST yang digunakan.

ID CMS

 

Makro
%%CMS_ID%%

 

Luaskan ke ID sumber konten Ad Manager ("CMS ID") yang sedang diputar. Nilai ini tidak muncul di feed MRSS, tetapi terlihat di antarmuka Ad Manager.

DAI_PRE

 

Makro
%%DAI_PRE%%

 

Nilai defaultnya adalah 0. Tetapkan ke 1 jika panggilan iklan dibuat dalam konteks non-pemblokiran atau smearing permintaan (seperti "jeda awal" atau "pengambilan data"). Hal ini menunjukkan kepada server iklan bahwa mungkin ada lebih banyak waktu untuk memproses panggilan iklan.

Hanya berlaku untuk traffic live/linear.

Domain

 

Makro
[DOMAIN]

 

Makro VAST 4.1.  Domain URL perujuk pembuatan streaming.

FW CAID

 

Makro
%%FW_CAID%%

 

Khusus VOD—ID Aset Kustom FreeWheel dari feed MRSS

GDPR

 

Makro
%%GDPR%%

 

Parameter gdpr.

Izin GDPR

 

Makro
[GDPRCONSENT]

 

Parameter gdpr_consent.

Nonce video dalam stream Google

 

Makro
[GOOGLE_INSTREAM_VIDEO_NONCE]

 

Parameter givn.

IFA

 

Makro
[IFA]

 

ID iklan yang dapat direset yang diambil dari parameter rdid. ID iklan hanya diteruskan ke permintaan iklan utama jika diizinkan oleh tanda privasi (seperti tfcd dan is_lat).

Jenis IFA

 

Makro
[IFATYPE]

 

Parameter idtype DAI. Jenis IFA hanya diteruskan ke panggilan iklan utama jika diizinkan oleh tanda privasi (seperti tfcd dan is_lat).

Batasi pelacakan iklan

 

Makro
[LIMITADTRACKING]

 

Parameter ltd.

MIME Media

 

Makro
[MEDIAMIME]

 

Makro VAST 4.1: daftar jenis MIME media yang didukung dan dipisahkan koma.

Iklan yang tidak dipersonalisasi

 

Makro
%%NPA%%

 

Diperluas ke nilai 1 untuk memberi tag tidak dipersonalisasi pada permintaan.

Makro ini digunakan dengan permintaan iklan yang tunduk pada GDPR, dan hanya dalam tag iklan untuk Penyisipan Iklan Dinamis. Lihat makro untuk GDPR lainnya.

Partner OMID

 

Makro
[OMIDPARTNER]

 

Makro VAST 4.1: parameter omid_p.

URL Halaman

 

Makro
[PAGEURL]

 

Makro VAST 4.1: URL perujuk pembuatan streaming.

Jenis penempatan

 

Makro
[PLACEMENTTYPE]

 

Makro VAST 4.1: untuk DAI, nilainya akan selalu 1 (dalam stream).

Lihat Video Subjenis Penempatan AdCOM.

Peraturan

 

Makro
[REGULATIONS]

 

Makro VAST 4.1: daftar peraturan yang berlaku, yang dipisahkan koma, berdasarkan parameter. Kehadiran tfcd=1 akan menambahkan "coppa", gdpr=1 akan menambahkan "gdpr".

Sisi server

 

Makro
[SERVERSIDE]

  Makro VAST 4.1 - selalu 1.

SCTE-35

 

Makro
%%SPLICE_INSERT_EVENT_ID%%
%%SPLICE_INSERT_UPID%%
%%TIME_SIGNAL_EVENT_ID%%
%%TIME_SIGNAL_UPID%%
%%TIME_SIGNAL_UPID_RAW%%
%%AFMM_CBC%%

 

Memperluas ke sinyal SCTE-35.

ID streaming

 

Makro
%%STREAM_ID%%

 

Memperluas ke ID streaming sesi untuk sumber konten yang sedang diputar

TFCD

 

Makro
%%TFCD%%

 

Memperluas ke nilai parameter tfcd.

TFUA

 

Makro
%%TFUA%%

 

Parameter tfua.

Stempel waktu

 

Makro
[TIMESTAMP]

 

Makro VAST 4.0 - stempel waktu saat ini yang diformat sesuai dengan ISO 8601.

ID Transaksi

 

Makro
[TRANSACTIONID]

 

Makro VAST 4.1 - ID yang digunakan untuk mengaitkan rantai permintaan iklan dari akhir asal.

Privasi AS

 

Makro
%%US_PRIVACY%%

 

Memperluas ke nilai parameter us_privacy.

Agen pengguna

 

Makro
%%USER_AGENT%%
[PERANGKAT]

 

Agen pengguna perangkat yang merender iklan kepada pengguna akhir.

Dalam kasus pengalihan VAST, hanya makro [DEVICEUA] yang akan memberikan fungsi yang diharapkan.

Alamat IP pengguna

 

Makro
%%USER_IP%%
[DEVICEIP]
[IP_ADDRESS]

 

Memperluas ke alamat IP pengguna.

[IP_ADDRESS] sebaiknya hanya digunakan untuk pengalihan Ad Manager saat %%USER_IP%% tidak diizinkan.

Durasi video

 

Makro
%%VIDEO_DURATION%%

 

Khusus VOD - durasi video dalam milidetik, dari feed MRSS.

Durasi video, dalam detik

 

Makro
%%VIDEO_DURATION_SEC%%

 

Memperluas ke durasi video dalam detik.

ID Video

 

Makro
%%VIDEO_ID%%

 

Khusus VOD - Content ID CMS dari feed MRSS.

Judul video

 

Makro
%%VIDEO_TITLE%%

 

Khusus VOD - judul video dari feed MRSS.

Makro pelacakan VAST

Makro [CACHEBUSTING] dan [ERRORCODE] mengikuti spesifikasi VAST 4.0 (buka bagian "Makro 2.3.7").

Cachebusting

 

Makro
[CACHEBUSTING]

 

Memperluas ke angka acak 8 digit.

Kode error

 

Makro
[ERRORCODE]

 

Memperluas ke kode error VAST.

Untuk mengatasi persoalan terkait pemecahan masalah atau pemadaman DAI, hubungi dukungan penayang.

Makro dalam string berenkode URL

Jika Anda perlu menggunakan makro di bagian tag iklan yang harus berenkode URL, makro itu sendiri tidak boleh berenkode URL untuk memastikan penggantian makro berfungsi dengan benar.

Contoh

Menggunakan makro nonce video dalam-stream Google dalam parameter kueri yang harus berenkode URL:

 

Benar
http://www.some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5
 

Salah
http://www.some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5