Membuat konfigurasi untuk sesi VOD

Untuk integrasi Ad Manager, Anda perlu membuat tag iklan untuk VOD sesi. 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. Tambahkan unit iklan baru.
2. Aktifkan aturan iklan.

3. Buat aturan iklan baru. Sebagai bagian dari langkah ini, temukan atribut 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 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 di akhir selama 30 menit aset VOD).
   • Ubah parameter output=vast menjadi output=xml_vmap1. Video Spesifikasi Playlist Multi-Iklan (VMAP) adalah satu-satunya output yang didukung .

Membuat konfigurasi VOD

Untuk membuat konfigurasi, gunakan projects.locations.vodConfigs.create . Lihat Dokumentasi referensi konfigurasi VOD untuk {i>field<i} opsional (seperti header kustom).

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Project number di halaman IAM Settings
• LOCATION: lokasi untuk membuat konfigurasi VOD; menggunakan salah satu wilayah yang didukung
  Tampilkan lokasi
  • 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. Ini URI harus mereferensikan file manifes MPEG-DASH (MPD) atau file manifes HLS (M3U8). Gunakan URI publik atau URI tanpa tanda tangan yang mendaftarkan kunci CDN.
• AD_TAG_URI

  URL untuk metadata iklan yang diambil dari server iklan; untuk integrasi Ad Manager, ini harus valid Tag iklan video Ad Manager. Untuk mendapatkan tag iklan yang valid, ikuti langkah-langkah pada bagian Membuat tag iklan di Ad Manager.
• NETWORK_CODE: ID numerik untuk Jaringan Ad Manager; Anda dapat menemukannya di Setelan global untuk akun penerbit

Meminta isi JSON:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

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"

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

$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 kemajuan. Salin teks yang dikembalikan OPERATION_ID, yang merupakan bagian terakhir dari kolom name, untuk digunakan di bagian berikutnya.

Memeriksa hasilnya

Menggunakan 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; ID ini berada di kolom Project number di IAM Settings halaman
• LOCATION: lokasi data; menggunakan salah satu wilayah yang didukung
  Tampilkan lokasi
  • 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:

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

$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 belum, tunggu beberapa detik dan kirim permintaan tersebut kembali.

Untuk informasi selengkapnya tentang konfigurasi VOD, lihat Buat dan kelola konfigurasi VOD.