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

Para a integração com o Ad Manager, você precisa criar uma tag de anúncio para a sessão de VOD. Você também precisa criar uma configuração de VOD. A API Video Stitcher registra essa configuração no Ad Manager.

Criar uma tag de anúncio no Ad Manager

Siga estas etapas na sua conta do Ad Manager:

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

  3. Crie uma nova regra de anúncio. Como parte desta 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úncios em vídeo e áudio com as seguintes modificações:

    • Para o tipo de SDK do player, selecione SDK do IMA do Google.
    • Adicione o parâmetro ad_rule=1 à tag. Por exemplo, adicione &ad_rule=1 ao final.
    • Adicione o parâmetro vid_d=vod-asset-duration-in-secs à tag. Por exemplo, adicione &vid_d=1800 ao final de um recurso de VOD de 30 minutos.
    • Modifique o parâmetro output=vast para output=xml_vmap1. A especificação da playlist de vários anúncios em vídeo (VMAP, na sigla em inglês) é o único tipo de saída com suporte.

Criar uma configuração de VOD

Para criar a configuração, use o método projects.locations.vodConfigs.create. Consulte a documentação de referência da configuração de VOD para conferir os campos opcionais (como cabeçalhos personalizados).

Antes de usar os dados da solicitação abaixo, 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 você vai criar a configuração de VOD. 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. O ID só pode conter letras minúsculas, números e hifens. O primeiro caractere precisa ser uma letra, o último caractere precisa ser uma letra ou um número, e o ID inteiro tem no máximo 63 caracteres.
  • VOD_URI: o URI da mídia a ser costurada. Esse URI precisa referenciar um arquivo de manifesto MPEG-DASH (MPD) ou um arquivo de manifesto HLS (M3U8). Use um URI público ou um URI não assinado em que você registrou uma chave do CDN. 
  • AD_TAG_URI
    : o URL dos metadados do anúncio extraídos dos servidores de anúncios. Para a integração do Ad Manager, ele precisa ser uma tag de anúncio em vídeo válida do Ad Manager. Para receber uma tag de anúncio válida, siga as etapas na seção anterior Criar uma tag de anúncio no Ad Manager.
  • NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. Ele pode ser encontrado nas Configurações globais da conta do editor.

Corpo JSON da solicitação:

{
  "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 pode ser consultada para acompanhar o progresso. Copie o OPERATION_ID retornado, que é a última parte do campo name, para usar na próxima seção.

Verificar 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 ela contenha "done: true".

Antes de usar os dados da solicitação abaixo, 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 compatíveis.
    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 as configurações de VOD, consulte Criar e gerenciar uma configuração de VOD.

Anterior
Visão geral
Próxima
Preparar o aplicativo cliente para funcionar com o Google Ad Manager