Dados de evento de pós-instalação (PIE)

Introdução

Este endpoint permite que os anunciantes enviem dados Vungle sobre cada evento de nível de usuário, se acontecer. O objetivo desta API de dados de evento é permitir que os anunciantes ajudem a Vungle a saber quais usuários são valiosos para você. Quando você nos envia informações de evento a partir do seu aplicativo, a Vungle pode otimizar suas campanhas para ajudá-lo a conquistar os usuários que mais interessam a você.

Conteúdo

Solicitação HTTP

http://ingest.vungle.com/eventData

POST

Suportamos solicitações POST com os seguintes tipos de conteúdo de corpo:

  • application/x-www-form-urlencoded  
  • application/json  

Nota: A Vungle recomenda o uso do método POST com um corpo JSON.

curl -H "Content-Type: application/json" -d '{"data": "myData"}' "http://ingest.vungle.com/eventData"

GET

Também suportamos solicitações GET usando parâmetros de consulta.

curl "http://ingest.vungle.com/eventData?data=myData"

Parâmetros requeridos

Cada evento que você nos envia tem parâmetros obrigatórios e opcionais. Rejeitaremos as solicitações que não tiverem os parâmetros necessários e iremos avisá-lo quais estão faltando. Consulte a seção de erros para mais detalhes.

Identificador de dispositivo

Requeremos pelo menos UM identificador de dispositivo por evento, de forma que você não precisa passar todos.

Parâmetro Descrição
device_idfa Apple IDFA ou ID de anúncio do Google Play Services
device_mac Endereço MAC em formato canônico, tendo hífen ou vírgula como separador
device_other_id Algum outro identificador único, e.g. ID Android, identificadores hashed, etc.

Nota: A Vungle recomenda o uso de device_idfa sempre que possível!

Outros parâmetros requeridos

Você precisa passar todos os parâmetros requeridos remanescentes para que possamos aceitar o evento.

Parâmetro Descrição
vungle_app_id O ID do aplicativo é fornecido no painel Vungle
trk Fonte do evento de entrada. No caso de uma integração servidor-a-servidor, você deve usar um autoidentificador; deve também identificar o provedor de rastreamento, e.g. ‘tune’, 'kochava’,'adjust’,'appsflyer’,etc.
event_trk_id  Este deve ser um identificador que seja único para o evento. Usado para evitar duplicidade.
event_id O identificador de evento Vungle. Se este evento foi realizado por um usuário direcionado para seu aplicativo por campanha Vungle, este identificador foi passado a você no rastreamento de visualização ou clique.
event_name Este deve ser uma string que identifica o evento que é consistente pelos usuários, e.g. 'tutorial-complete’, 'level-3’, 'purchase' etc.

Exemplos:

Um exemplo POST corpo:

{
  "device_idfa"   : "236A005B-700F-4889-B9CE-99",
  "vungle_app_id" : "myVungleApp",
  "trk"           : "tune",
  "event_trk_id"  : "uniqueID1234",
  "event_name"    : "tutorial-complete"
}

Um exemplo de solicitação GET:

curl "http://ingest.vungle.com/eventData?device_idfa=236A005B-700F-4889-B9CE-999EAB2B605D&vungle_app_id=myVungleApp&trk=tune&event_trk_id=uniqueID1234&event_name=tutorial-complete"

As cargas de trabalho acima iriam retornar uma resposta '200 OK' e são exemplos da solicitação mínima que você pode enviar para a Vungle.

Parâmetros opcionais

Estes parâmetros são opcionais, mas são importantes para que a Vungle determine quais são os usuários de valor, de modo que você deve passar a maior quantidade possível.

Parâmetro Padrão Descrição
event_value Nenhum Algum valor numérico associado com o evento. Deve ser relativo a outros eventos que você envia à Vungle. Por exemplo, um IAP $4.99 deve ser 4.99.
event_currency 'usd'  Se event_value é um valor monetário explícito, defina a moeda aqui.
event_iap_event false Defina uma flag para declarar se o evento foi uma compra feita dentro do aplicativo.
device_limit_track false Booleano para determinar se o dispositivo tem uma definição 'limite de rastreamento de anúncio'.
event_datetime Data e hora da recepção do evento Data e hora da ocorrência do evento. Se o fuso horário não for especificado, assume-se UTC. A data e hora devem ser no formato ISO 8601.
device_ip Nenhum Endereço IP do dispositivo.
device_make Nenhum Fabricante do dispositivo.
device_model Nenhum Modelo do dispositivo.
device_carrier Nenhum Operadora de celular do dispositivo.
device_language Nenhum Código ISO 639-1 de idioma do dispositivo (2 dígitos).
device_country Nenhum Código ISO 3166 do país do IP de origem (2 dígitos).
device_user_agent  Nenhum Agente de usuário do navegador do dispositivo.
device_os Nenhum Número de versão do sistema operacional.

Nota: Certifique-se de anotar o parâmetro event_value e considerar os valores para cada evento. A Vungle é agnóstica quanto aos números reais utilizados, mas os eventos devem ter valores que tenham valor relativo uns aos outros. A Vungle procurará maximizar o valor geral dos tipos de usuários que enviamos a você.

Exemplo de parâmetros opcionais

{
  "event_currency"      : "usd",
  "event_iap_event"     : true,
  "device_limit_track"  : false,
  "event_datetime"      : "2015-03-15T13:27:36Z",
  "device_ip"           : "201.15.25.11",
  "device_make"         : "samsung",
  "device_model"        : "sm-g900v",
  "device_carrier"      : "verizon",
  "device_language"     : "es",
  "device_country"      : "us",
  "device_user_agent"   : "Mozilla/5.0 (Linux; U; Android 2.2.1; fr-fr; HTC_DesireZ_A7272 Build/FRG83D) AppleWebKit/533.1 (KHTML, like Gecko), Version/4.0 Mobile Safari/533.1",
  "device_os"           : "4.3.2",
  "event_value"         : 1.99
} 

Códigos de erro

Retornamos os seguintes códigos:

Código de erro Significado
200  OK - Obrigado!
400 Solicitação incorreta - Sua solicitação não é válida. Muito provavelmente você omitiu um ou mais parâmetros obrigatórios. Verifique o corpo da resposta para pistas.
500 Erro interno de servidor - Tivemos um problema com nosso servidor. Tente novamente mais tarde.
503 Serviço indisponível - Estamos temporariamente fora para manutenção. Tente novamente mais tarde.

Se respondermos com um '400 BAD REQUEST', verifique o corpo da resposta. Faremos o possível para diagnosticar o problema, o que muito provavelmente será um ou dois campos que estão faltando. Por exemplo,

curl "http://ingest.vungle.com/eventData?trk=tune&event_trk_id=uniqueID1234"

Retornaria uma resposta que se parece com isto:

{
  "missing_fields":
  [
    "vungle_app_id",
    "trk",
    "event_trk_id",
    "event_name",
    "device_idfa | device_mac | device_other_id"
  ]
}

 

 

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

Comentários