Untuk mengaktifkan Video Stitcher API untuk project Anda, hubungi Perwakilan Akun atau hubungi Penjualan untuk mempelajari lebih lanjut.

Membuat konfigurasi untuk acara live stream

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

Persyaratan manifes sumber

Video Stitcher API mendaftarkan konfigurasi ke Ad Manager dengan menguraikan manifes sumber. Manifes sumber harus memiliki karakteristik tertentu, bergantung pada formatnya.

HLS

Format penampung dapat berupa:
- MPEG-TS gabungan
- MPEG-TS tidak dimux
- FMP4 tidak dimux
Setidaknya satu rendisi dalam manifes dengan kolom berikut (diisi dengan benar):
- codec
- {i>bandwidth<i}

MPEG-DASH

MPD@type ditetapkan ke dinamis (@type="dynamic")
MPD@profiles menyertakan profil ISO Live urn:mpeg:dash:profile:isoff-live:2011
Satu atau beberapa Periode yang masing-masing berisi satu atau beberapa Kumpulan Adaptasi
Setiap Kumpulan Adaptasi berisi satu atau beberapa Representasi
Representasi berisi atau mewarisi SegmentTemplate dengan ID $Number$ atau $Time$
@segmentAlignment ditetapkan ke true untuk semua Kumpulan Adaptasi
Pernyataan tidak boleh kosong

Membuat slate

Sebelum membuat konfigurasi live, Anda perlu membuat slate. Video Stitcher API menyisipkan video slate default saat iklan tidak dapat disisipkan. Anda harus mendaftarkan video slate ke Video Stitcher API untuk menunjukkan slate yang akan digunakan jika tidak ada iklan. Video slate dapat berupa file MP4 apa pun dengan minimal satu trek 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 Anda, ikuti langkah-langkah di Membuat slate untuk mengisi kesenjangan konten, lalu langsung ke bagian Membuat konfigurasi langsung.

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: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project di halaman Setelan IAM
LOCATION: lokasi tempat membuat slate; gunakan salah satu wilayah yang didukung
Tampilkan 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 keseluruhan ID memiliki maksimal 63 karakter.
SLATE_URL: URI publik untuk video MP4 dengan minimal satu trek audio (video contoh)
NETWORK_CODE: ID numerik untuk jaringan Ad Manager; 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 menghasilkan operasi yang berjalan lama (LRO) yang dapat Anda kueri untuk melacak progresnya. 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: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project di halaman Setelan IAM
LOCATION: lokasi data; gunakan salah satu region 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 (Linux, macOS, atau Cloud Shell)

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)

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.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project di halaman Setelan IAM
LOCATION: lokasi tempat untuk membuat konfigurasi langsung; gunakan salah satu region yang didukung
Tampilkan 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 langsung. ID ini hanya boleh berisi huruf kecil, angka, dan tanda hubung. Karakter pertama harus berupa huruf, karakter terakhir harus berupa huruf atau angka, dan keseluruhan ID memiliki maksimal 63 karakter.
SOURCE_LIVESTREAM_URI: URL sumber ke manifes video live stream. URL 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, maka ini adalah URI ke file main.m3u8 atau main.mpd di bucket Cloud Storage.
AD_TAG_URI: (Tempelkan nilai ini ke blok kode JSON Permintaan di bawah.) URL untuk metadata iklan yang diambil dari server iklan; untuk integrasi Ad Manager, URL ini harus berupa tag iklan video live Ad Manager yang valid. Untuk mendapatkan tag iklan yang valid, ikuti langkah-langkah di artikel Membuat tag iklan video dan audio dengan modifikasi berikut:
- Untuk Lalu lintas langsung, aktifkan lalu lintas langsung.
- Untuk Player SDK type, pilih Google IMA SDK.
- Tambahkan parameter ad_rule=0 ke tag (misalnya, tambahkan &ad_rule=0 ke bagian akhir).
SLATE_ID: ID slate yang akan digunakan tanpa adanya 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. Anda juga dapat mengganti nilai ini per sesi nanti.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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)

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 secara asinkron mendaftarkan konfigurasi di akun Ad Manager Anda. Proses ini mungkin memerlukan waktu beberapa menit.

Perintah ini menghasilkan operasi yang berjalan lama (LRO) yang dapat Anda kueri untuk melacak progresnya. Untuk mengetahui informasi selengkapnya, lihat Memeriksa hasilnya.

Mendapatkan konfigurasi

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_NUMBER: nomor project Google Cloud Anda; nomor ini berada di kolom Nomor project di halaman Setelan IAM
LOCATION: lokasi konfigurasi langsung; gunakan salah satu region yang didukung
Tampilkan 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 langsung

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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)

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 mengirimkan nilai ini ke Interactive Media Ads (IMA) SDK pada langkah berikutnya.

Sebelumnya

Ringkasan

Berikutnya

Menyiapkan aplikasi klien Anda untuk bekerja dengan Google Ad Manager