Creare una configurazione per un evento in live streaming

Per l'integrazione di Ad Manager, devi creare una configurazione dal vivo per un determinato evento di live streaming. L'API Video Stitcher registra questa configurazione con Ad Manager.

Requisiti del file manifest dell'origine

L'API Video Stitcher registra la configurazione con Ad Manager analizzando il manifest di origine. Il manifest di origine deve avere determinate caratteristiche a seconda del formato.

HLS

• Il formato del container può essere:
  • audio MPEG-TS
  • MPEG-TS non audio
  • FMP4 non Mux
• Almeno una versione nel manifest con i seguenti campi (correttamente compilati):
  • codec
  • larghezza di banda

MPEG-DASH

• MPD@type impostato su dinamico (@type="dynamic")
• MPD@profiles include il profilo ISO Live urn:mpeg:dash:profile:isoff-live:2011
• Uno o più periodi contenenti ciascuno uno o più insiemi di adattamento
• Ogni set di adattamento contiene una o più rappresentazioni
• Le rappresentazioni contengono o ereditano un valore SegmentTemplate con l'identificatore $Number$ o $Time$
• @segmentAlignment impostato su true per tutti gli insiemi di adattamento
• Le rappresentazioni non devono essere vuote

Crea uno slate

Prima di creare la configurazione attiva, devi creare uno slate. L'API Video Stitcher inserisce un video slate predefinito quando non è possibile inserire gli annunci. Devi registrare il video slate con l'API Video Stitcher per indicare lo slate da utilizzare in assenza di annunci. Il video slate può essere qualsiasi file MP4 con almeno una traccia audio.

Per creare lo slate sono disponibili due opzioni. Puoi creare uno slate di rete predefinito nel tuo account Ad Manager oppure utilizzare l'API Video Stitcher.

Creare uno slate in Ad Manager

Per creare uno slate di rete predefinito nel tuo account Ad Manager, segui i passaggi descritti in Creare uno slate di contenuti per colmare le lacune di contenuti, quindi vai alla sezione Creare una configurazione di live streaming.

Creare uno slate utilizzando l'API Video Stitcher

Per creare uno slate con l'API Video Stitcher, usa il metodo projects.locations.slates.create.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAM
• LOCATION: la posizione in cui creare lo slate; utilizza una delle regioni supportate
  Mostra località
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: un identificatore dello slate definito dall'utente. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo deve essere una lettera o un numero e l'intero ID ha un massimo di 63 caratteri.
• SLATE_URL: l'URI pubblico di un video MP4 con almeno una traccia audio (video di esempio)
• NETWORK_CODE: l'identificatore numerico della tua rete Ad Manager, disponibile nelle Impostazioni globali dell'account publisher
  Importante: devi includere l'oggetto gamSlate per utilizzare lo slate con Google Ad Manager (GAM).

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

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)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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
}

Questo comando crea un'operazione a lunga esecuzione (LRO) su cui puoi eseguire una query per monitorare l'avanzamento. Copia il valore OPERATION_ID restituito, che è l'ultima parte del campo name, da utilizzare nella sezione successiva.

Controlla il risultato

Usa il metodo projects.locations.operations.get per verificare se lo slate è stato creato. Se la risposta contiene "done: false", ripeti il comando finché la risposta non contiene "done: true".

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud. Si trova nel campo Numero di progetto della pagina Impostazioni IAM.
• LOCATION: la località dei dati; utilizza una delle regioni supportate
  Mostra località
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID: l'identificatore dell'operazione

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
    }
  }
}

Crea la configurazione pubblicata

Per creare la configurazione, utilizza il metodo projects.locations.liveConfigs.create.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAM
• LOCATION: la località in cui creare la configurazione in tempo reale; utilizza una delle regioni supportate
  Mostra località
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: un identificatore definito dall'utente per la configurazione pubblicata. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo deve essere una lettera o un numero e l'intero ID ha un massimo di 63 caratteri.
• SOURCE_LIVESTREAM_URI: l'URL di origine del manifest del video in live streaming. Deve essere accessibile all'API Video Stitcher. L'URL deve essere pubblicamente accessibile oppure, se la firma dell'URL è abilitata per la rete CDN, deve essere stata fornita una chiave CDN registrata all'API Video Stitcher. Se hai creato un live streaming di prova utilizzando l'API Live Stream, questo sarà l'URI del file main.m3u8 o main.mpd nel bucket Cloud Storage.
• AD_TAG_URI: incolla questo valore nel blocco di codice JSON Richiedi di seguito. L'URL per i metadati degli annunci recuperato dagli ad server. Per l'integrazione di Ad Manager, deve essere un tag annuncio video dal vivo Ad Manager valido. Per ottenere un tag annuncio valido, segui i passaggi per generare tag annuncio video e audio con queste modifiche:
  • Per Traffico in tempo reale, attiva il traffico in tempo reale.
  • Per Tipo di SDK del player, seleziona SDK IMA di Google.
  • Aggiungi il parametro ad_rule=0 al tag (ad esempio, aggiungi &ad_rule=0 alla fine).
• SLATE_ID: l'ID dello slate da utilizzare in assenza di annunci uniti.
  Nota: se hai creato uno slate di rete predefinito utilizzando Ad Manager, rimuovi il campo defaultSlate dalla richiesta per utilizzare lo slate di rete predefinito.
• NETWORK_CODE: l'identificatore numerico della tua rete Ad Manager, disponibile nelle Impostazioni globali dell'account del publisher.
• AD_TRACKING: il comportamento di monitoraggio degli annunci per il tuo stream. Per le integrazioni con l'SDK IMA, utilizza CLIENT. Puoi anche sostituire questo valore in base alla sessione in un secondo momento.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: assicurati di aver impostato la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file di chiave privata del tuo account di servizio.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

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

Quindi esegui questo comando per inviare la richiesta REST:

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)

Nota: assicurati di aver impostato la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file di chiave privata del tuo account di servizio.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

@'
{
  "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

Quindi esegui questo comando per inviare la richiesta REST:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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
}

L'API Video Stitcher registra in modo asincrono la configurazione nel tuo account Ad Manager. L'operazione potrebbe richiedere alcuni minuti.

Questo comando crea un'operazione a lunga esecuzione (LRO) su cui puoi eseguire una query per monitorare l'avanzamento. Per maggiori informazioni, consulta Controllare i risultati.

Recupera la configurazione

Per ottenere la configurazione, utilizza il metodo projects.locations.liveConfigs.get.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud; si trova nel campo Numero di progetto della pagina Impostazioni IAM
• LOCATION: la località della configurazione attiva; utilizza una delle regioni supportate
  Mostra località
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: identificatore definito dall'utente per la configurazione live

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Trova il campo customAssetKey e copia il valore CUSTOM_ASSET_KEY restituito. Dovrai inviare questi valori all'SDK IMA (Interactive Media Ads) in un passaggio successivo.