Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Skema dan properti pelacakan iklan sisi klien
Dengan fitur pelacakan iklan MediaTailor sisi klien, Anda dapat mengintegrasikan data pelacakan iklan sisi klien yang mendetail ke dalam lingkungan pemutar Anda. Bagian berikut mencakup skema pelacakan iklan secara keseluruhan, serta properti dan nilai spesifik yang membentuk skema.
Skema
Tabel berikut menjelaskan skema pelacakan iklan MediaTailor sisi klien. Jika berlaku, tabel memetakan skema ke VAST data.
| Kunci | Tipe data | Kunci anak | Pemetaan dari 2.0/3.0 VAST | Pemetaan dari 4.0 VAST | Deskripsi |
|---|---|---|---|---|---|
| Respon JSON | |||||
| - | Objek | avails, nonLinearAvails | |||
/avails
|
Array |
||||
| MediaTailor membuat satu objek untuk setiap avail (ad break) di dalam jendela manifes. | ads, adType, availID, duration, durationInSeconds, startTime, startTimeInSeconds, dateTime | ||||
/ads
|
Array | ||||
| MediaTailor membuat satu objek untuk setiap iklan di dalam periode avail. | Objek | adID,adType,adParameters,adVerifications,companionAds,duration, durationInSeconds,,extensions, ikon,mediaFile,startTime,startTimeInSeconds,dateTime, adBreakTrackingEvents | |||
/adId
|
String |
|
|||
/adParameters
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/AdParameters
|
String parameter iklan dari VAST VPAID yang MediaTailor diteruskan ke pemain |
||
/adVerifications
|
Array |
VAST/Ad/InLine/AdVerifications
|
Berisi sumber daya dan metadata yang diperlukan untuk mengeksekusi kode pengukuran pihak ketiga untuk memverifikasi pemutaran kreatif |
||
| MediaTailor membuat objek untuk setiap elemen verifikasi iklan. | Objek | executableResource, javaScriptResource, vendor, verificationParameters | |||
/executableResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource
|
|||
MediaTailor menciptakan objek untuk setiap executableResource elemen. |
Objek | apiFramework,adType, uri, bahasa | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@apiFramework
|
|||
/type
|
String | ||||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/#CDATA
|
|||
/language
|
String |
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
VAST/Ad/InLine/AdVerifications/Verification/ExecutableResource/@language
|
||
/javaScriptResource
|
Array |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource
|
|||
MediaTailor menciptakan objek untuk setiap javaScriptResource elemen. |
Objek | apiFramework,browserOptional, uri | |||
/apiFramework
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@apiFramework
|
|||
/browserOptional
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/@browserOptional
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/JavaScriptResource/#CDATA
|
|||
/trackingEvents
|
Array |
||||
| MediaTailor membuat objek untuk setiap elemen verifikasi iklan jenis pelacakan-peristiwa. | Objek | acara, uri | |||
/event
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/@event
|
|||
/uri
|
String |
VAST/Ad/InLine/AdVerifications/Verification/TrackingEvents/Tracking/#CDATA
|
|||
/vendor
|
String |
VAST/Ad/InLine/AdVerifications/Verification/@vendor
|
|||
/verificationParameters
|
String |
VAST/Ad/InLine/AdVerifications/Verification/VerificationParameters
|
|||
/companionAds
|
Array |
Iklan pendamping, yang menyertai iklan yang tersedia, menyediakan konten seperti bingkai di sekitar iklan atau spanduk untuk ditampilkan di dekat video. |
|||
| MediaTailor membuat objek untuk setiap elemen iklan pendamping. | Objek | adParameters, altText, attributes, companionClickThrough, companionClickTracking, htmlResource, sequence, staticResource, trackingEvents |
VAST/Ad/InLine/Creatives/Creative/CompanionAds
|
||
/adParameters
|
String | ||||
/altText
|
String | ||||
/attributes
|
Objek |
adSlotId,apiFramework,assetHeight,,assetWidth,expandedHeight,expandedWidth, idheight, pxratio,, renderingMode width | |||
/adSlotId
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@adSlotId
|
|||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@apiFramework
|
|||
/assetHeight
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetHeight
|
|||
/assetWidth
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@assetWidth
|
|||
/expandedHeight
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedHeight
|
|||
/expandedWidth
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@expandedWidth
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@height
|
|||
/id
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@id |
|||
/pxratio
|
String |
||||
/renderingMode
|
String |
||||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/@width |
|||
/companionClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickThrough |
|||
/companionClickTracking
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/CompanionClickTracking |
|||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/HTMLResource |
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/iFrameResource |
|||
/sequence
|
String |
||||
/staticResource
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/StaticResource |
|||
/trackingEvents
|
Array |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents |
|||
|
MediaTailor membuat objek untuk setiap jenis peristiwa pelacakan elemen iklan pendamping. |
|||||
/tracking
|
Objek |
>acara, uri | |||
/event
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/@event
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/CompanionAds/Companion/TrackingEvents/Tracking/#CDATA
|
|||
/duration
|
String |
Panjangnya, dalam ISO format 8601 detik |
|||
/durationInSeconds
|
Jumlah |
Panjang, dalam format detik |
|||
/extensions
|
Array |
Server iklan dapat menggunakan VAST ekstensi khusus |
|||
|
MediaTailor menciptakan objek untuk setiap ekstensi anak dari |
VAST/Ad/InLine/Extensions
|
||||
/extension
|
Objek | jenis, konten |
VAST/Ad/InLine/Extensions/Extension
|
||
/type
|
String |
VAST/Ad/InLine/Extensions/Extension/@type
|
|||
/content
|
String | ||||
/icons
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons
|
|||
|
MediaTailor menciptakan objek untuk setiap |
Objek | attributes, dateTime, duration, durationInSeconds, htmlResource, iconClicks, iconViewTracking, iFrameResource, staticResource, startTime, startTimeInSeconds |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon
|
||
/attributes
|
Objek | apiFramework,duration,height, offset, program, pxratio,,, width xPosition yPosition | |||
/apiFramework
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@apiFramework
|
|||
/duration
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@duration
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@height
|
|||
/offset
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@offset
|
|||
/program
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@program
|
|||
/pxratio
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@pxratio
|
|||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@width
|
|||
/xPosition
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@xPosition
|
|||
/yPosition
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/@yPosition
|
|||
/dateTime
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Number | ||||
/htmlResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/HTMLResource
|
|||
/iconClicks
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks
|
|||
/iconClickThrough
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickThrough
|
|||
/iconClickTracking
|
Objek | id |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickTracking
|
||
/id
|
String | ||||
/iconClickFallbackImages
|
Array |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages
|
|||
|
MediaTailor membuat objek untuk setiap simpul gambar fallback ikon-klik. |
|||||
/altText
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/AltText
|
|||
/height
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@height
|
|||
/width
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/@width
|
|||
/staticResource
|
Objek | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/@creativeType
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconClicks/IconClickFallbackImages/IconClickFallbackImage/StaticResource/#CDATA
|
|||
/iconViewTracking
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/IconViewTracking
|
|||
/iFrameResource
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/iFrameResource
|
|||
/statidResource
|
Objek | creativeType, uri |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource
|
||
/creativeType
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/@type
|
|||
/uri
|
String |
VAST/Ad/InLine/Creatives/Creative/Linear/Icons/Icon/StaticResource/#CDATA
|
|||
/startTime
|
String | ||||
/startTimeInSeconds
|
Number | ||||
/mediaFiles
|
Objek | adParameters, duration, durationInSeconds, mediaFilesList, mezzanine, startTime, startTimeInSeconds, trackingEvents |
Video dan aset lain yang dibutuhkan pemain untuk iklan tersedia |
||
/adParameters
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Number | ||||
/mediaFilesList
|
Array | ||||
|
MediaTailor membuat objek untuk setiap jenis acara pelacakan elemen iklan pendamping |
apiFramework, delivery, height, maintainAspectRatio, mediaFileUri, mediaType, scalable, width | ||||
/apiFramework
|
String | ||||
/delivery
|
String | ||||
/height
|
String | ||||
/maintainAspectRatio
|
String | ||||
/mediaFileUri
|
String | ||||
/mediaType
|
String | ||||
/scalable
|
String | ||||
/width
|
String | ||||
/mezzanine
|
String | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
String | ||||
/trackingEvents
|
Array | ||||
|
MediaTailor membuat objek untuk setiap acara pelacakan untuk kreatif |
beaconUrls, duration, durationInSeconds, dateTime, eventId, eventType, startTime, startTimeInSeconds | ||||
/beaconUrls
|
Array | ||||
|
Daftar semua pelacakan yang dipisahkan koma URLs untuk acara ini |
|||||
/duration
|
String | ||||
/durationInSeconds
|
Number | ||||
/dateTime
|
String | ||||
/eventId
|
String | ||||
/eventType
|
String | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Number | ||||
/startTime
|
String |
Posisi waktu, dalam format ISO 8601 detik, relatif terhadap awal sesi pemutaran |
|||
/startTimeInSeconds
|
Jumlah |
Posisi waktu, dalam format detik, relatif terhadap awal sesi pemutaran |
|||
/dateTime
|
String |
Waktu tanggal program, dalam format ISO 8601 detik, untuk memulai iklan yang tersedia |
|||
/trackingEvents
|
Array |
Berisi semua data acara pelacakan yang diterima dalam VAST respons, bersama dengan informasi waktu |
|||
/adType
|
String | ||||
/availId
|
String | ||||
/dateTime
|
String | ||||
/duration
|
String | ||||
/durationInSeconds
|
Number | ||||
/startTime
|
String | ||||
/startTimeInSeconds
|
Number | ||||
Properti
Tabel berikut mencantumkan properti dalam pelacakan sisi klienAPI, definisi, jenis nilai, dan contohnya.
| Properti | Definisi | Tipe nilai | Contoh |
|---|---|---|---|
adID
|
|
String | 10 |
adBreakTrackingEvents
|
Array yang membawa peristiwa VMAP pelacakan dari VAST respons. Untuk informasi lebih lanjut, lihat bagian 2.3.3 dari spesifikasi VMAP 1.0 |
String |
[]
|
adMarkerDuration
|
Durasi avail yang diamati dari penanda iklan dalam manifes. |
String |
30
|
adParameters
|
Serangkaian parameter iklan, dari VASTVPAID, yang MediaTailor diteruskan ke pemain. |
String | |
adProgramDateTime
|
|
String | |
ads
|
Array yang berisi objek iklan yang membentuk avail. Iklan tercantum dalam urutan mereka muncul dalam manifes. |
Array |
[]
|
adSystem
|
Nama sistem yang melayani iklan. pentingPastikan untuk memberikan nilai. Jika Anda tidak memberikan nilai, masalah dapat muncul. |
String |
myADS
|
adTitle
|
Judul iklan. |
String |
ad1
|
adVerifications
|
Berisi sumber daya dan metadata yang diperlukan untuk mengeksekusi kode pengukuran pihak ketiga untuk memverifikasi pemutaran kreatif. Untuk informasi lebih lanjut tentang properti ini, lihat bagian 3.16 dari spesifikasi VAST 4.2 MediaTailor mendukung |
Array |
[]
|
altText
|
Teks alternatif untuk gambar iklan pendamping. Teks ini memungkinkan pemain dengan dukungan deskriptif-audio untuk tunanetra untuk membaca kembali deskripsi gambar. |
String |
video sequence advertising sneakers
|
attributes
|
Menyertakan kunci yang ditentukan dalam VAST spesifikasi untuk iklan pendamping |
Objek |
{}
|
apiFramework
|
Setel |
String |
VPAID
|
availID
|
|
String |
|
avails
|
Array yang berisi objek pemecah iklan, atau avails, yang disajikan di jendela manifes aktif. Keuntungannya tercantum dalam urutan kemunculannya dalam manifes. |
Array |
[]
|
beaconUrls
|
URLTempat MediaTailor mengirim suar iklan. |
String | |
bitrate
|
Bitrate dari aset video. Properti ini biasanya tidak termasuk untuk aset yang dapat dieksekusi. |
String |
2048
|
companionAds
|
Satu atau beberapa spesifikasi konten iklan pendamping, yang masing-masing menentukan file sumber daya yang akan digunakan. Iklan pendamping menyertai iklan yang tersedia dan menyediakan konten, seperti bingkai di sekitar iklan atau spanduk, untuk ditampilkan di dekat video. |
Array |
[]
|
companionClickThrough
|
A URL ke halaman pengiklan yang dibuka pemutar media saat pemirsa mengklik iklan pendamping. |
String |
https://aws.amazon.com/
|
companionClickTracking
|
Pelacakan URL untuk |
String |
https://myads.com/beaconing/event=clicktracking
|
creativeId
|
Nilai |
String |
creative-1
|
creativeSequence
|
Urutan di mana iklan harus diputar, sesuai dengan |
String |
1
|
dashAvailabilityStartTime
|
Untuk live/dynamicDASH, manifes |
String |
2022-10-05T19:38:39.263Z
|
delivery
|
Menunjukkan apakah |
String |
progressive
|
duration
|
Panjangnya, dalam ISO format 8601 detik. Respons mencakup durasi untuk seluruh iklan yang tersedia dan untuk setiap iklan dan suar, meskipun durasi suar selalu nol. |
Jumlah |
15.015
|
eventId
|
|
String |
23
|
eventType
|
Jenis suar. |
String |
impression
|
extensions
|
Ekstensi khusus VAST yang digunakan server iklan tersebut. Untuk informasi selengkapnya tentang ekstensi, lihat bagian 3.18 dari spesifikasi VAST 4.2 |
Array |
[]
|
height
|
Ketinggian, dalam piksel, dari aset video. |
String |
360
|
hlsAnchorMediaSequenceNumber
|
Nomor urutan media dari urutan media pertama/tertua yang terlihat pada manifes asal. HLS |
String |
77
|
htmlResource
|
CDATA-Encoded HTML yang dimasukkan langsung ke dalam halaman penyedia streaming. HTML |
String |
<![CDATA[<!doctype html><html><head><meta
name=\"viewport\" content=\"width=1,
initial-scale=1.0, minimum-scale=1.0,...]]>
|
iFrameResource
|
File URL ke HTML sumber daya yang dimuat penyedia streaming ke dalam iframe. |
String | |
maintainAspectRatio
|
Menunjukkan apakah akan mempertahankan rasio aspek video saat melakukan penskalaan. |
Boolean |
true
|
mediaFilesList
|
Menentukan video dan aset lain yang dibutuhkan pemain untuk iklan yang tersedia. |
Array |
[]
|
mediaFileUri
|
URIyang menunjuk ke aset yang dapat dieksekusi atau aset video. |
String |
https://myad.com/ad/ad134/vpaid.js
|
mediaType
|
MIMEJenis aset kreatif atau pendamping. |
String |
video/mp4
|
meta
|
|||
mezzanine
|
URLMP4Aset mezzanine, ditentukan jika VPAID iklan menyertakan satu. |
String |
https://gcdn.2mdn.net/videoplayback/id/itag/ck2/file/file.mp4
|
nextToken
|
Nilai token yang menunjuk ke halaman hasil berikutnya, ketika nilai seperti itu ada. |
String |
UFQzOS44NzNTXzIwMjMtMDctMzFUMTY6NTA6MDYuMzUwNjI2ODQ1Wl8x
|
nonLinearAds
|
Array |
[]
|
|
nonLinearAdsList
|
Array |
[]
|
|
nonLinearAvails
|
Array | ||
scalable
|
Menunjukkan apakah akan menskalakan video ke dimensi lain. |
Boolean |
true
|
sequence
|
Nilai urutan yang ditentukan untuk kreatif dalam VAST respons. |
String |
1
|
skipOffset
|
Nilai waktu yang mengidentifikasi kapan pemain membuat kontrol lewati tersedia bagi pengguna. |
String |
00:00:05
|
startTime
|
Posisi waktu, dalam format ISO 8601 detik, relatif terhadap awal sesi pemutaran. Responsnya mencakup waktu mulai untuk seluruh iklan yang tersedia dan untuk setiap iklan dan suar. |
String |
PT9.943S
|
startTimeInSeconds
|
Posisi waktu, dalam format detik, relatif terhadap awal sesi pemutaran. Responsnya mencakup waktu mulai untuk seluruh iklan yang tersedia dan untuk setiap iklan dan suar. |
Jumlah |
9.943
|
staticResource
|
URLKe file kreatif statis yang digunakan untuk komponen iklan. |
String |
https://very-interactive-ads.com/campaign1/file.json?c=1019113602
|
vastAdId
|
Nilai |
String |
ad1
|
width
|
Lebar, dalam piksel, dari aset video. |
String |
640
|
