Crie uma configuração para uma sessão de VOD

Para a integração do Ad Manager, tem de criar uma etiqueta do anúncio para a sessão de VOD. Também tem de criar uma configuração de VOD. A API Video Stitcher regista esta configuração no Ad Manager.

Crie uma etiqueta do anúncio no Ad Manager

Execute os seguintes passos 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úncios. Como parte deste passo, encontre a secção Segmentação > Inventário no Ad Manager. Selecione o novo bloco de anúncios do passo anterior.

  4. Crie uma etiqueta do anúncio válida seguindo os passos em Gere etiquetas de anúncios de vídeo e áudio com as seguintes modificações:

    • Para o tipo de SDK do leitor, selecione SDK para IMA da Google.
    • Adicione o parâmetro ad_rule=1 à etiqueta (por exemplo, adicione &ad_rule=1 no final).
    • Adicione o parâmetro vid_d=vod-asset-duration-in-secs à etiqueta (por exemplo, adicione &vid_d=1800 no final para um recurso de VOD de 30 minutos).
    • Modifique o parâmetro output=vast para output=xml_vmap1. A especificação Video Multiple Ad Playlist (VMAP) é o único tipo de saída suportado.

Crie 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 campos opcionais (como cabeçalhos personalizados).

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_NUMBER: o seu Google Cloud número do projeto; este encontra-se no campo Número do projeto na página Definições de IAM
  • LOCATION: a localização na qual criar a configuração de VOD; use uma das regiões suportadas
    Mostrar localizações
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • VOD_CONFIG_ID: um identificador definido pelo utilizador para a configuração de VOD. Este ID só pode conter letras minúsculas, números e hífenes. O primeiro caráter tem de ser uma letra, o último caráter tem de ser uma letra ou um número, e o ID completo tem um máximo de 63 carateres.
  • VOD_URI: o URI do conteúdo multimédia a unir. Este URI tem de fazer referência a um ficheiro de manifesto MPEG-DASH (MPD) ou a um ficheiro de manifesto HLS (M3U8). Use um URI público ou um URI não assinado para o qual registou uma chave de RFC. 
  • AD_TAG_URI
     o URL dos metadados dos anúncios obtidos a partir de servidores de anúncios; para a integração do Ad Manager, tem de ser uma etiqueta do anúncio de vídeo do Ad Manager válida. Para obter uma etiqueta do anúncio válida, siga os passos na secção anterior Crie uma etiqueta do anúncio no Ad Manager.
  • NETWORK_CODE: o identificador numérico da sua rede do Ad Manager. Pode encontrá-lo nas Definições globais da conta de publicador

Corpo JSON do pedido: 

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

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

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

Este comando cria uma operação de longa duração (LRO) que pode consultar para acompanhar o progresso. Copie o valor devolvido OPERATION_ID, que é a última parte do campo name, para usar na secção seguinte.

Verifique 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 qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_NUMBER: o número do seu Google Cloud projeto; encontra-se no campo Número do projeto na página Definições de IAM
  • LOCATION: a localização dos dados; use uma das regiões suportadas
    Mostrar localizações
    • 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 o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 o pedido novamente.

Para mais informações sobre as configurações de VOD, consulte o artigo Crie e faça a gestão de uma configuração de VOD.

Anterior
Vista geral
Avançar
Prepare a sua aplicação cliente para funcionar com o Google Ad Manager