Creare una configurazione per una sessione VOD

Per l'integrazione di Ad Manager, devi creare un tag annuncio per la sessione VOD. Devi anche creare una configurazione VOD. L'API Video Stitcher registra questa configurazione in Ad Manager.

Creare un tag annuncio in Ad Manager

Esegui i seguenti passaggi nel tuo account Ad Manager:

1. Aggiungi una nuova unità pubblicitaria.
2. Attiva le regole per gli annunci.

3. Crea una nuova regola per gli annunci. Nell'ambito di questo passaggio, individua la sezione Targeting > Inventario in Ad Manager. Seleziona la nuova unità pubblicitaria dal passaggio precedente.

4. Crea un tag annuncio valido seguendo i passaggi descritti in Generare tag annuncio video e audio con le seguenti modifiche:

   • Per il tipo di SDK del player, seleziona SDK IMA di Google.
   • Aggiungi il parametro ad_rule=1 al tag (ad esempio, aggiungi &ad_rule=1 alla fine).
   • Aggiungi il parametro vid_d=vod-asset-duration-in-secs al tag (ad es. aggiungi &vid_d=1800 alla fine per un asset VOD di 30 minuti).
   • Modifica il parametro output=vast in output=xml_vmap1. La specifica Video Multiple Ad Playlist (VMAP) è l'unico tipo di output supportato.

Creare una configurazione VOD

Nota: non creare una configurazione VOD se la tua piattaforma di destinazione è l'SDK IMA su Chromecast. Salta il passaggio successivo.

Per creare la configurazione, utilizza il metodo projects.locations.vodConfigs.create. Consulta la documentazione di riferimento per la configurazione VOD per i campi facoltativi (ad esempio le intestazioni personalizzate).

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 nella pagina Impostazioni IAM
• LOCATION: la posizione in cui creare la configurazione VOD. Utilizza una delle regioni supportate
  Mostra sedi
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID: un identificatore definito dall'utente per la configurazione VOD. Questo ID può contenere solo lettere minuscole, numeri e trattini. Il primo carattere deve essere una lettera, l'ultimo carattere deve essere una lettera o un numero e l'intero ID deve avere un massimo di 63 caratteri.
• VOD_URI: l'URI dei contenuti multimediali da unire. Questo URI deve fare riferimento a un file manifest MPEG-DASH (MPD) o a un file manifest HLS (M3U8). Utilizza un URI pubblico o un URI non firmato per il quale hai registrato una chiave CDN.
  Nota: puoi utilizzare l'API Transcoder per creare questi file manifest. Per saperne di più, consulta Creare file di origine VOD. Devi rendere pubblici i file manifest in modo che l'API Video Stitcher possa accedervi.
• 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 Ad Manager valido. Per ottenere un tag annuncio valido, segui i passaggi descritti nella sezione precedente Creare un tag annuncio in Ad Manager.
• NETWORK_CODE: l'identificatore numerico della rete Ad Manager. Puoi trovarlo in Impostazioni globali per l'account publisher

Corpo JSON della richiesta:

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

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'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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.

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": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

Questo comando crea un'operazione a lunga esecuzione (LRO) su cui puoi eseguire 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

Utilizza il metodo projects.locations.operations.get per verificare se la configurazione VOD è stata creata. Se la risposta contiene "done: false", ripeti il comando finché la risposta non contiene "done: true".

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 nella pagina Impostazioni IAM.
• LOCATION: la posizione dei dati. Utilizza una delle regioni supportate
  Mostra sedi
  • 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 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.

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

Verifica che lo stato sia impostato su READY. In caso contrario, attendi qualche secondo e invia nuovamente la richiesta.

Per ulteriori informazioni sulle configurazioni VOD, consulta Creare e gestire una configurazione VOD.