Criar uma configuração para uma sessão VOD demanda

Para a integração com o Ad Manager, é necessário criar uma tag de anúncio para a sessão de VOD.

Talvez também seja necessário criar uma configuração de VOD, dependendo da plataforma de destino. A API Video Stitcher registra essa configuração com o Ad Manager.

Criar uma tag de anúncio no Ad Manager

Siga as seguintes etapas na sua conta do Ad Manager:

  1. Adicione um novo bloco de anúncios.
  2. Ative as regras de anúncio.

  3. Crie uma nova regra de anúncio. Como parte dessa etapa, encontre a seção Segmentação > Inventário no Ad Manager. Selecione o novo bloco de anúncios da etapa anterior.

  4. Crie uma tag de anúncio válida seguindo as etapas em Gerar tags de anúncio em vídeo e áudio com as seguintes modificações:

    • No tipo de SDK do player, selecione SDK do IMA do Google.
    • Adicione o parâmetro ad_rule=1 à tag (por exemplo, inclua &ad_rule=1 no final).
    • Adicione o parâmetro vid_d=<vod_asset_duration_in_secs> à tag. Por exemplo, inclua &vid_d=1800 no final para um recurso VOD de 30 minutos.
    • Modifique o parâmetro output=vast para ser output=xml_vmap1. A especificação de playlist de vários anúncios em vídeo (VMAP) é o único tipo de saída compatível.

Selecione a plataforma de destino

Selecione a plataforma segmentada para o usuário final:

Você precisa criar uma configuração de VOD. Siga as etapas nesta página.

Criar uma configuração de VOD

Para criar a configuração, use o método projects.locations.vodConfigs.create.

Antes de usar os dados da solicitação, faça as substituições a seguir:

  • PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
  • LOCATION: o local em que a configuração de VOD será criada. Use uma das regiões com suporte.
    Mostrar locais
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • VOD_CONFIG_ID: um identificador definido pelo usuário para a configuração de VOD. Ele só pode ter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último precisa ser uma letra ou um número, e o ID todo tem um máximo de 63 caracteres.
  • VOD_URI: o URI da mídia a ser agrupada. Esse URI precisa fazer referência a um arquivo de manifesto MPEG-DASH (MPD) ou a um arquivo de manifesto HLS (M3U8). Use um URI público ou não assinado em que você registrou uma chave de CDN.
  • AD_TAG_URI: cole esse valor no bloco de código "Solicitar JSON" abaixo. É o URL dos metadados de anúncios recuperados dos servidores de anúncios. Para integração com o Ad Manager, precisa ser uma tag de anúncio em vídeo do Ad Manager válida. Para receber uma tag de anúncio válida, siga as etapas da seção anterior Criar uma tag de anúncio no Ad Manager.
  • NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. É possível encontrá-lo nas Configurações globais da conta do editor

Solicitar corpo JSON: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

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

Esse comando cria uma operação de longa duração (LRO, na sigla em inglês) que você pode consultar para rastrear o progresso. Copie o OPERATION_ID retornado, que é a última parte do campo name, para usar na próxima seção.

Conferir o resultado

Use o método projects.locations.operations.get para verificar se a configuração de VOD foi criada. Se a resposta contiver "done: false", repita o comando até que a resposta contenha "done: true".

Antes de usar os dados da solicitação, faça as substituições a seguir:

  • PROJECT_NUMBER: o número do projeto do Google Cloud, localizado no campo Número do projeto na página Configurações do IAM
  • LOCATION: o local dos dados. Use uma das regiões com suporte.
    Mostrar locais
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • OPERATION_ID: o identificador da operação.

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

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

Verifique se o estado está definido como READY. Caso contrário, aguarde alguns segundos e envie a solicitação novamente.

Para mais informações sobre configurações de VOD, consulte Criar e gerenciar uma configuração de VOD.

Anterior
Antes de começar
Próxima
Preparar-se para o aplicativo cliente funcionar com o Google Ad Manager