Guia de integração do Vungle VAST 2.0

Este artigo descreve o processo e as especificações do Vungle para auxiliar um novo parceiro VAST a integrar sua tecnologia em nossa plataforma de anúncios programável.

Conteúdo

Especificações de resposta VAST

A resposta da proposta deve obedecer às seguintes especificações:

  • Duração máxima do vídeo de 30 segundos
  • Taxa mínima de bits de 250 kbps
  • O XML deve conter:
        • um arquivo .mp4
        • informações da taxa de bits
        • informações da duração do vídeo
  • Qualquer redirecionamento só pode redirecionar uma vez
  • Tempo de resposta:
        • para streaming: de até 250 ms
        • para armazenado em cache: de até 750 ms
  • Deve levar o clique à página de destino
  • Deve suportar SSL e resposta com ativos protegidos
  • Responda com ‘no-ad’ ou ‘403’ no evento de não ser anúncio
  • As extensões VAST são opcionais, mas são indicadas

O Vungle retorna um erro se qualquer um dos requisitos acima não for atendido.

Protocolo de integração do parceiro da Vungle

Quando o Vungle auxilia um novo parceiro VAST a integrar sua tecnologia em nossa plataforma de anúncios programável, o processo tem duas fases. A primeira fase pode ser descrita como uma validação geral: o Vungle analisa a tag, garantindo que as chamadas do servidor sejam enviadas corretamente e que os valores sejam preenchidos adequadamente. A segunda fase envolve testes rigorosos, nos quais se busca discrepâncias entre um conjunto estatisticamente significativa de impressões para garantir que os números da Vungle se alinhem com os número do parceiro.

Fase 1

  1. O parceiro envia à Vungle os documentos técnicos (se disponíveis).

  2. O parceiro envia à Vungle um ponto de extremidade (endpoint) VAST de teste. 
    Nota: durante a fase de teste, o parceiro deve responder a 100% das solicitações de proposta da Vungle para gerar resultados de teste significativos.

  3. A Vungle cria um ambiente de teste para chamar o ponto de extremidade do parceiro por demanda.
    Isso é usado para validar valores de variável e rastrear avisos (beacons).

Fase 2

  1. A Vungle trabalha junto ao parceiro para montar campanhas de teste.
  • O parceiro envia pontos de extremidade de teste simulando uma demanda real.
  • A Vungle monta uma campanha de teste para executar um número predeterminado de impressões.

  • O parceiro e a Vungle reconciliam as entregas e buscam por discrepâncias.

  • Se houver problemas de rastreamento, alvo ou discrepância, a Vungle e o parceiro trabalham juntos para depurá-los até resolver cada um deles.
  • Exemplos de solicitação VAST

    Um URL de exemplo de solicitação VAST (tag VAST) com os parâmetros vazios

    https://partner.com/vast2/6524rgww153hifw/?duration=15&app_name={{{pub_app_name}}}&app_id={{{market_id}}}&rtb_type=instream_mobile_vast_inter&user_id={{{device_id}}}&ua={{{browser_user_agent}}}&random={{{timestamp}}}&ip_address={{{ip}}} 

    Um URL de exemplo de solicitação VAST (tag VAST) com os parâmetros preenchidos

    https://partner.com/vast2/124765432/?duration=15&app_name=My%20Talking%20Tom%20Free%20for%20Android&app_id=com.outfit7.mytalkingtomfree&rtb_type=instream_mobile_vast_inter&user_id=6df43c89-9e3d-43fb-a1e9-bacd51932d41&ua=Mozilla%2F5.0%20(Linux%3B%20Android%204.4.2%3B%20SPH-L720%20Build%2FKOT49H)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Chrome%2F30.0.0.0%20Mobile%20Safari%2F537.36&random=2015-01-27T21%3A30%3A34%2B00%3A00&ip_address=66.87.114.254 

    Parâmetros VAST requeridos

    Nome do parâmetro Macro Valor Notas: Exemplo
    Categoria do aplicativo {{{pub_app_store_category}}} String Lista de categorias Jogos
    Nome do aplicativo {{{pub_app_name}}} String Do iTunes ou Play store Family Farm Seaside
    URL da loja de aplicativos {{{pub_app_store_url}}} String URL da loja de aplicativos ou conteúdo. Codificado. https://play.google.com/store/apps/details?id=com.funplus.familyfarm&hl=en
    ID do pacote {{{pub_market_app_id}}} String/Int Do iTunes ou Play store com.funplus.familyfarm&hl=en (Android)
    539920547 (iOS)
    Cidade {{{city}}} String Codificado New York
    Tipo de conexão {{{connection_type}}} String Wi-Fi, WWAN, móvel Wi-Fi, WWAN, móvel
    País {{{country}}} String Código do país com duas letras US
    DNT do dispositivo {{{ad_tracking_disabled}}} String 'True' indica que o usuário não permite rastreamento pelo anúncio Verdadeiro/Falso
    DNT do dispositivo {{{ad_tracking_enabled}}} String 'True' indica que o usuário permite rastreamento pelo anúncio Verdadeiro/Falso
    DNT do dispositivo {{{boolean_number ad_tracking_disabled}}} Int Não rastrear, em forma binária 0 – Falso
    1 - Verdadeiro
    IP do dispositivo {{{device_id}}} String Limpo ou com verificação hash ab4d6cc4-f57f-4309-9d29-b7fb5e35dd74
    Modelo do dispositivo {{{device_model}}} String Codificado Amazon,KFFOWI
    Samsung,SM-J700T
    IP {{{ip}}} String Endereço do Protocolo IP 95.118.153.77
    Idioma {{{language}}} String Idioma em dois caracteres, dos cabeçalhos 10.2.1
    Versão do SO {{{os_version}}} String Versão do SO (como iOS 7.2) 2014-12-05T00%3A44%3A19%2B00%3A00
    Plataforma {{{device_platform}}} String iOS ou Android iOS/Android
    Altura da tela {{{screen_height}}} Inteiro Altura da tela (pixels) 768
    Orientação da tela {{{screen_orientation}}} String Retrato ou Paisagem Retrato/Paisagem
    Largura da tela {{{screen_width}}} Inteiro Largura da tela (pixels) 1024
    Marca de hora {{{timestamp}}} String/Int Codificado 2014-12-05T00:44:19+00:00
    Agente do usuário {{{browser_user_agent}}} String UA dos cabeçalhos. Codificado. Mozilla/5.0 (Linux; Android 5.1.1; VF-1397 Build/LMY47V; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/55.0.2883.91 Safari/537.36
    ID Vungle {{{vungle_id}}} String ID do editor Vungle para desempenho do associado 5497c989a3b61ba3660001b1

     

    Tem mais dúvidas? Envie uma solicitação

    Comentários