Membuat konfigurasi untuk sesi VOD

Untuk integrasi Ad Manager, Anda perlu membuat tag iklan untuk sesi VOD. Anda juga perlu membuat konfigurasi VOD. Video Stitcher API mendaftarkan konfigurasi ini ke Ad Manager.

Membuat tag iklan di Ad Manager

Lakukan langkah-langkah berikut di akun Ad Manager Anda:

  1. Menambahkan unit iklan baru.
  2. Aktifkan aturan iklan.
  3. Buat aturan iklan baru. Sebagai bagian dari langkah ini, temukan bagian Penargetan > Inventaris di Ad Manager. Pilih unit iklan baru dari langkah sebelumnya.

  4. Buat tag iklan yang valid dengan mengikuti langkah-langkah di Membuat tag iklan video dan audio dengan modifikasi berikut:

    • Untuk jenis SDK Pemutar, pilih IMA SDK Google.
    • Tambahkan parameter ad_rule=1 ke tag (misalnya, tambahkan &ad_rule=1 di bagian akhir).
    • Tambahkan parameter vid_d=vod-asset-duration-in-secs ke tag (misalnya, tambahkan &vid_d=1800 ke akhir untuk aset VOD selama 30 menit).
    • Ubah parameter output=vast menjadi output=xml_vmap1. Spesifikasi Playlist Video Multiple Ads (VMAP) adalah satu-satunya jenis output yang didukung.

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: Google Cloud project number; kolom ini terletak di kolom Project number di halaman IAM Settings
  • LOCATION: lokasi tempat membuat konfigurasi VOD; gunakan salah satu wilayah yang didukung
    • us-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 maksimum 63 karakter.
  • VOD_URI: URI media yang akan digabungkan. URI ini harus mereferensikan file manifes MPEG-DASH (MPD) atau file manifes HLS (M3U8). Gunakan URI publik atau URI yang tidak ditandatangani yang telah Anda daftarkan kunci CDN.
  • AD_TAG_URI
    URL untuk metadata iklan yang diambil dari server iklan; untuk integrasi Ad Manager, 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; 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:

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID"

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID" | Select-Object -Expand Content

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: Google Cloud project number; kolom ini terletak di kolom Project number di halaman IAM Settings
  • LOCATION: lokasi data; gunakan salah satu wilayah yang didukung
    • us-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:

Jalankan perintah berikut:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

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 tidak, tunggu beberapa detik dan kirim permintaan lagi.

Untuk mengetahui informasi selengkapnya tentang konfigurasi VOD, lihat Membuat dan mengelola konfigurasi VOD.