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
- Protocolo de integração do parceiro da Vungle
- Exemplos de solicitação VAST
- Parâmetros VAST requeridos
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
- O parceiro envia à Vungle os documentos técnicos (se disponíveis).
- 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.
- 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
- 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.
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 |