Creare una configurazione per una sessione VOD

Per l'integrazione di Ad Manager, devi creare un tag annuncio per la sessione VOD.

Potrebbe inoltre essere necessario creare una configurazione VOD a seconda della piattaforma di destinazione. L'API Video Stitcher registra questa configurazione con Ad Manager.

Creare un tag annuncio in Ad Manager

Nel tuo account Ad Manager, procedi nel seguente modo:

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

  3. Crea una nuova regola per gli annunci. Come parte di questo passaggio, trova la sezione Targeting > Inventario in Ad Manager. Seleziona la nuova unità pubblicitaria dal passaggio precedente.

  4. Crea un tag annuncio valido seguendo la procedura descritta in Generare tag annuncio video e audio con le seguenti modifiche:

    • Per il tipo SDK Player, seleziona SDK IMA di Google.
    • Aggiungi il parametro ad_rule=1 al tag (ad es. aggiungi &ad_rule=1 alla fine).
    • Aggiungi il parametro vid_d=<vod_asset_duration_in_secs> al tag (ad esempio, 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.

Seleziona la piattaforma di destinazione

Seleziona la piattaforma di destinazione dell'utente finale tra le seguenti:

Devi creare una configurazione VOD. Continua con i passaggi indicati in questa pagina.

Crea una configurazione VOD

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

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

  • PROJECT_NUMBER: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAM
  • LOCATION: la posizione in cui creare la configurazione VOD; utilizza una delle regioni supportate
    Mostra località
    • 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 una lettera o un numero e l'intero ID può contenere al massimo 63 caratteri.
  • VOD_URI: l'URI dell'elemento multimediale 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. 
  • 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 Creare un tag annuncio in Ad Manager precedente.
  • NETWORK_CODE: l'identificatore numerico per la tua rete Ad Manager; disponibile nelle Impostazioni globali dell'account publisher

Corpo JSON della richiesta: 

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

Per inviare la richiesta, espandi una delle seguenti opzioni:

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 una query per monitorare l'avanzamento. Copia il valore OPERATION_ID restituito, che è l'ultima parte del campo name, per utilizzarlo nella sezione successiva.

Verifica 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 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 progetto Google Cloud, che si trova nel campo Numero 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: identificatore dell'operazione

Per inviare la richiesta, espandi una delle seguenti opzioni:

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 di nuovo la richiesta.

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

Indietro
Panoramica
Avanti
Prepararsi per il funzionamento dell'applicazione client con Google Ad Manager