Membuat konfigurasi untuk acara live stream

Untuk integrasi Ad Manager, Anda perlu membuat konfigurasi live untuk acara live stream tertentu. Video Stitcher API mendaftarkan konfigurasi ini ke Ad Manager.

Membuat slate

Sebelum membuat konfigurasi live, Anda harus membuat slate. Video Stitcher API menyisipkan video slate default saat iklan tidak dapat disisipkan. Anda harus mendaftarkan video slate dengan Video Stitcher API untuk menunjukkan slate yang akan digunakan saat tidak ada iklan. Video slate dapat berupa file MP4 apa pun dengan minimal satu jalur audio.

Anda memiliki dua opsi untuk membuat slate ini. Anda dapat membuat slate jaringan default di akun Ad Manager atau membuat slate menggunakan Video Stitcher API.

Membuat slate di Ad Manager

Untuk membuat slate jaringan default di akun Ad Manager, ikuti langkah-langkah di Membuat slate untuk mengisi kesenjangan konten, lalu lanjutkan ke bagian Membuat konfigurasi aktif.

Membuat slate menggunakan Video Stitcher API

Untuk membuat slate menggunakan Video Stitcher API, gunakan metode projects.locations.slates.create.

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 untuk membuat slate; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: ID yang ditentukan pengguna untuk slate. 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.
• SLATE_URL: URI publik untuk video MP4 dengan setidaknya satu trek audio (video contoh)
• NETWORK_CODE: ID numerik untuk jaringan Ad Manager Anda; Anda dapat menemukannya di Setelan global untuk akun penayang
  Penting: Anda harus menyertakan objek gamSlate untuk menggunakan slate dengan Google Ad Manager (GAM).

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_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/slates/SLATE_ID",
    "verb": "create"
  },
  "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 slate 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
  Menampilkan 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 (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

Membuat konfigurasi live

Untuk membuat konfigurasi, gunakan metode projects.locations.liveConfigs.create. Lihat dokumentasi referensi konfigurasi live 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 untuk membuat konfigurasi live; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: ID yang ditentukan pengguna untuk konfigurasi live. 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.
• SOURCE_LIVESTREAM_URI: URL sumber ke manifes video live stream. File ini harus dapat diakses oleh Video Stitcher API. URL harus dapat diakses secara publik atau, jika penandatanganan URL diaktifkan untuk CDN, kunci CDN terdaftar telah diberikan ke Video Stitcher API. Jika Anda membuat live stream pengujian menggunakan Live Stream API, ini adalah URI ke file main.m3u8 atau main.mpd di bucket Cloud Storage.
• AD_TAG_URI

  URL untuk metadata iklan yang diambil dari server iklan; untuk integrasi Ad Manager, ini harus berupa tag iklan video live Ad Manager yang valid. Untuk mendapatkan tag iklan yang valid, ikuti langkah-langkah di bagian Membuat tag iklan video dan audio dengan modifikasi berikut:
  • Untuk Traffic live, aktifkan traffic live.
  • Untuk Jenis SDK pemutar, pilih IMA SDK Google.
  • Tambahkan parameter ad_rule=0 ke tag (misalnya, tambahkan &ad_rule=0 ke bagian akhir).
• SLATE_ID: ID slate yang akan digunakan jika tidak ada iklan yang digabungkan
  Catatan: Jika Anda membuat slate jaringan default menggunakan Ad Manager, hapus kolom defaultSlate dari permintaan untuk menggunakan slate jaringan default.
• NETWORK_CODE: ID numerik untuk jaringan Ad Manager Anda; Anda dapat menemukannya di Setelan global untuk akun penayang.
• AD_TRACKING: perilaku pelacakan iklan untuk streaming Anda. Untuk integrasi IMA SDK, gunakan CLIENT. Untuk pelacakan iklan sisi server, gunakan SERVER. Anda juga dapat mengganti nilai ini berdasarkan per sesi nanti.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur untuk file kunci pribadi akun layanan Anda.

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": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur untuk file kunci pribadi akun layanan Anda.

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

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

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/liveConfigs?liveConfigId=LIVE_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/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

Video Stitcher API mendaftarkan konfigurasi secara asinkron di akun Ad Manager Anda. Proses ini mungkin memerlukan waktu beberapa menit.

Perintah ini membuat operasi yang berjalan lama (LRO) yang dapat Anda kueri untuk melacak progres. Untuk mengetahui informasi selengkapnya, lihat Memeriksa hasil.

Mendapatkan konfigurasi

Untuk mendapatkan konfigurasi, gunakan metode projects.locations.liveConfigs.get.

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 konfigurasi live; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: ID yang ditentukan pengguna untuk konfigurasi aktif

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

Temukan kolom customAssetKey dan salin CUSTOM_ASSET_KEY yang ditampilkan. Anda mengirim nilai ini ke Interactive Media Ads (IMA) SDK di langkah berikutnya.