Creare una configurazione per un evento in live streaming

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

Creare una scheda

Prima di creare la configurazione live, devi creare una slate. La L'API Video Stitcher inserisce un video slate predefinito quando non è possibile inserire gli annunci. Tu 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 uno traccia audio.

Hai due opzioni per creare questa scheda. Puoi creare una scheda della rete predefinita nel tuo account Ad Manager o utilizzare l'API Video Stitcher per creare schede.

Creare uno slate in Ad Manager

Per creare uno slate della rete predefinito nel tuo account Ad Manager, segui i passaggi descritti in Crea uno slate per colmare la carenza di contenuti e poi vai alla sezione Creare la configurazione in tempo reale.

Creare uno slate utilizzando l'API Video Stitcher

Per creare una scheda utilizzando l'API Video Stitcher, utilizza il metodo projects.locations.slates.create.

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

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud; che si trova nel campo Numero progetto della pagina Impostazioni IAM
• LOCATION: la posizione in cui creare la scheda. 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 definito dall'utente per lo slate. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo una lettera o un numero e l'intero ID ha una lunghezza massima 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 del tuo sulla rete Ad Manager. puoi trovarlo nel Impostazioni globali per l'account editore
  Importante: devi includere i campi gamSlate 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 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 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 corrente:

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

Quindi, esegui il seguente 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 comando seguente presuppone che tu abbia eseguito l'accesso alla CLI 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 corrente:

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

Quindi, esegui il seguente 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'istanza operazione a lunga esecuzione (LRO) su cui puoi eseguire query per monitorarne l'avanzamento. Copia il valore restituito OPERATION_ID, che è l'ultima parte del campo name, da usare nella sezione successiva.

Verifica il risultato

Utilizza la projects.locations.operations.get per verificare se lo slate è stato creato. Se la risposta contiene "done: false", ripeti il comando fino a quando 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, che si trova nel campo Numero progetto nella pagina Impostazioni IAM.
• LOCATION: posizione dei dati; utilizza una delle regioni supportate
  Sedi dei negozi
  • 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 a l'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 di Google. 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 comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login di Google. 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 in tempo reale

Per creare la configurazione, utilizza il metodo projects.locations.liveConfigs.create. Consulta la documentazione di riferimento della configurazione live per i campi facoltativi (come le intestazioni personalizzate).

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

• PROJECT_NUMBER: il numero del tuo progetto Google Cloud; che si trova nel campo Numero progetto della pagina Impostazioni IAM
• LOCATION: la posizione in cui creare la configurazione in tempo reale. Utilizza una delle regioni supportate
  Sedi dei negozi
  • 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 live. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo una lettera o un numero e l'intero ID ha una lunghezza massima di 63 caratteri.
• SOURCE_LIVESTREAM_URI: l'URL di origine per il manifest del video in live streaming. Deve essere accessibile all'API Video Stitcher. L'URL deve accessibili pubblicamente oppure, se la firma URL è abilitata per la CDN, una rete CDN registrata sia stata fornita all'API Video Stitcher. Se ha creato un testare il live streaming utilizzando l'API Live Stream, questo è l'URI della main.m3u8 o main.mpd nel bucket Cloud Storage.
• AD_TAG_URI

  l'URL per i metadati degli annunci recuperati dagli ad server. Per l'integrazione di Ad Manager, deve essere un tag annuncio video in live streaming di Ad Manager valido. Per ottenere un tag annuncio valido, segui la procedura indicata Generare tag annuncio video e audio con queste modifiche:
  • Per Traffico in tempo reale, attiva il traffico in tempo reale.
  • Per la sezione Tipo di SDK del player, seleziona SDK IMA di Google.
  • Aggiungi il parametro ad_rule=0 al tag (ad es. aggiungi &ad_rule=0) alla fine).
• SLATE_ID: l'ID dello slate da utilizzare nella assenza di annunci uniti
  Nota: se hai creato uno slate di rete predefinito utilizzando Ad Manager, rimuovi il campo defaultSlate dalla richiesta di utilizzare lo slate di rete predefinito.
• NETWORK_CODE: l'identificatore numerico della rete Ad Manager. Puoi trovarlo in Impostazioni globali per l'account publisher.
• AD_TRACKING: il comportamento del monitoraggio degli annunci per il tuo stream. Per le integrazioni dell'SDK IMA, utilizza CLIENT. Per il monitoraggio degli annunci lato server, usa SERVER. Puoi anche eseguire l'override di questo valore per singola 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 della chiave privata dell'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 corrente:

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 il seguente 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 GOOGLE_APPLICATION_CREDENTIALS di variabile di ambiente al percorso del file della chiave privata dell'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 corrente:

@'
{
  "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 il seguente 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'istanza operazione a lunga esecuzione (LRO) su cui puoi eseguire query per monitorarne l'avanzamento. Per ulteriori informazioni, vedi Controlla il risultato.

Ottieni la configurazione

Per recuperare 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, che si trova nel campo Numero progetto nella pagina Impostazioni IAM
• LOCATION: la posizione della 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: l'identificatore definito dall'utente per la configurazione attiva

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 a l'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 di Google. 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 comando seguente presuppone che tu abbia eseguito l'accesso alla CLI 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 restituito CUSTOM_ASSET_KEY. Hai inviato questi valori all'SDK IMA (Interactive Media Ads) in un passaggio successivo.