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 com o 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 por 30 minutos VOD).
    • 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 compatível.

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 de configuração de VOD para 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ê quer criar a configuração de VOD. usar 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. Esse ID só pode ter 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 o ID inteiro precisa ter no máximo 63 caracteres.
  • VOD_URI: o URI da mídia a ser combinada. Isso O URI precisa referenciar um arquivo de manifesto MPEG-DASH (MPD, na sigla em inglês) 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. recuperados de servidores de anúncios, para integração com o Ad Manager, precisa ser tag de anúncio em vídeo 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 a resposta 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 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 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