Untuk integrasi Ad Manager, Anda perlu membuat tag iklan untuk sesi VOD.
Anda mungkin juga perlu membuat konfigurasi VOD bergantung pada platform target. Video Stitcher API mendaftarkan konfigurasi ini ke Ad Manager.
Membuat tag iklan di Ad Manager
Lakukan langkah-langkah berikut di akun Ad Manager Anda:
- Tambahkan unit iklan baru.
- Aktifkan aturan iklan.
Buat aturan iklan baru. Sebagai bagian dari langkah ini, temukan bagian Penargetan > Inventaris di Ad Manager. Pilih unit iklan baru dari langkah sebelumnya.
Buat tag iklan yang valid dengan mengikuti langkah-langkah pada Membuat tag iklan video dan audio dengan modifikasi berikut:
- Untuk jenis Player SDK, pilih IMA SDK Google.
- Tambahkan parameter
ad_rule=1
ke tag (misalnya, tambahkan&ad_rule=1
ke bagian akhir). - Tambahkan parameter
vid_d=<vod_asset_duration_in_secs>
ke tag (misalnya, tambahkan&vid_d=1800
ke bagian akhir untuk aset VOD 30 menit). - Ubah parameter
output=vast
menjadioutput=xml_vmap1
. Spesifikasi Video Multiple Ad Playlist (VMAP) adalah satu-satunya jenis output yang didukung.
Pilih platform target
Pilih platform target pengguna akhir dari opsi berikut:
Membuat konfigurasi VOD
Untuk membuat konfigurasi, gunakan
metode
projects.locations.vodConfigs.create
. Lihat dokumentasi referensi konfigurasi VOD untuk kolom opsional (seperti header kustom).
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_NUMBER
: nomor project Google Cloud Anda; nomor ini ada di kolom Project number di halaman IAM SettingsLOCATION
: lokasi untuk membuat konfigurasi VOD; gunakan salah satu region yang didukungTampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: ID yang ditentukan pengguna untuk konfigurasi VOD. ID ini hanya boleh berisi huruf kecil, angka, dan tanda hubung. Karakter pertama harus berupa huruf, karakter terakhir harus berupa huruf atau angka, dan seluruh ID memiliki maksimal 63 karakter.VOD_URI
: URI media yang akan digabungkan. URI ini harus merujuk pada file manifes MPEG-DASH (MPD) atau file manifes HLS (M3U8). Gunakan URI publik atau URI yang tidak ditandatangani, tempat Anda mendaftarkan kunci CDN.AD_TAG_URI
URL untuk metadata iklan yang diambil dari server iklan; untuk integrasi Ad Manager, URL ini harus berupa tag iklan video Ad Manager yang valid. Untuk mendapatkan tag iklan yang valid, ikuti langkah-langkah di bagian sebelumnya, Membuat tag iklan di Ad Manager.NETWORK_CODE
: ID numerik untuk jaringan Ad Manager; Anda dapat menemukannya di Setelan global untuk akun penayang
Meminta isi JSON:
{ "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "gamVodConfig": { "networkCode": "NETWORK_CODE" } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create", "cancelRequested": false, "apiVersion": "v1" }, "done": false }
Perintah ini membuat operasi yang berjalan lama (LRO) yang dapat Anda kueri untuk melacak progres. Salin OPERATION_ID yang ditampilkan, yang merupakan bagian terakhir dari kolom name
, untuk digunakan di bagian berikutnya.
Memeriksa hasilnya
Gunakan metode projects.locations.operations.get
untuk memeriksa apakah konfigurasi VOD telah dibuat. Jika respons berisi
"done: false"
, ulangi perintah hingga respons berisi "done: true"
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_NUMBER
: nomor project Google Cloud Anda; nomor ini ada di kolom Project number di halaman IAM SettingsLOCATION
: lokasi data; gunakan salah satu region yang didukungTampilkan lokasius-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
OPERATION_ID
: ID untuk operasi
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.common.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "verb": "create" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig", "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "gamVodConfig": { "networkCode": "NETWORK_CODE" }, "state": "READY" } }
Pastikan status disetel ke READY
. Jika belum, tunggu beberapa detik dan kirim permintaan lagi.
Untuk informasi selengkapnya tentang konfigurasi VOD, lihat Membuat dan mengelola konfigurasi VOD.