Configuração do parceiro WidenAd
O WidenAd é uma rede de anúncios integrada à Adjust. Nossa integração permite que o WidenAd receba dados de atribuição e eventos in-app por meio de callbacks automáticos.
Neste artigo, saiba como configurar a mensuração com o WidenAd para seu aplicativo. Isso inclui a ativação da integração, a criação de um link de campanha e a escolha dos dados que a Adjust pode compartilhar com WidenAd.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posterior para mapear os parâmetros do SDK aos parâmetros do WidenAd. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Selecione WidenAd e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > WidenAd. Selecione Avançar para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o WidenAd.
- Selecione Próximo.
Habilite o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o WidenAd. Para fazer isso:
- Deixe na opção Habilitado
Depois que você habilitar o compartilhamento de dados com o WidenAd, a Adjust enviará automaticamente os seguintes dados ao WidenAd, por padrão:
- instalação
- sessão
- reatribuição
- evento
- instalação rejeitada
Configure suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Use configurações específicas da plataforma.
- Defina as mesmas configurações de compartilhamento dos dados para múltiplas plataformas selecionando Use configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que a Adjust compartilha com o WidenAd por padrão.
- instalação
- sessão
- reatribuição
- evento
- instalação rejeitada
Envie dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o WidenAd por meio de callbacks. O WidenAd pode usar essas informações para otimizar o desempenho.
- Em Quais fontes de dados você deseja compartilhar?, escolha a fonte de atribuição dos dados que está compartilhando com o WidenAd:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao WidenAd
Receita in-app (a partir de compras in-app)
O encaminhamento de receita in-app permite que o WidenAd receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar os dados.
Receita de anúncios (de impressões de anúncios)
O compartilhamento de receita de anúncios permite que o WidenAd receba dados de receita de anúncios do usuário, que podem ser usados para otimizar a segmentação de usuários e campanhas.
Esse recurso está disponível no pacote RevWorks da Adjust. Para adquiri-lo, entre em contato com seu representante de vendas.
Para compartilhar a receita de anúncios com o WidenAd, selecione uma ou mais Fontes de receita de anúncios.
- Se deixar este campo vazio, enviaremos dados de receita de anúncios de todas as fontes integradas de mediação.
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o WidenAd receberá a atividade da sessão do seu aplicativo.
Mapear parâmetros
Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o WidenAd.
Mapeando eventos
Mapeie os eventos que você deseja compartilhar com os valores que o WidenAd pode receber. Os dados de eventos não mapeados não são compartilhados com o WidenAd.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o WidenAd. Isso possibilita:
- Definir eventos individuais para gerenciar estratégias de campanha para cada plataforma.
- Personalizar o compartilhamento de dados por plataforma.
Em Mapear eventos, siga estes passos para escolher os eventos in-app que você deseja enviar diretamente à WidenAd.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com o WidenAd.
Em Evento de parceiro, selecione o evento do WidenAd que corresponde ao evento da Adjust.
Para aplicativos de plataforma única e aplicativos multiplataforma com compartilhamento de dados habilitado apenas para uma única plataforma, mapeie eventos apenas para essa plataforma. Para aplicativos multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Selecionar Usar mapeamento específico da plataforma para mapear eventos separados no nível da plataforma ou para não mapear eventos para determinadas plataformas.
- Selecionar Usar mapeamento global para mapear os mesmos eventos para todas as plataformas.
Na lista de Eventos de parceiro, escolha ou insira um nome de evento personalizado que você gostaria de mapear ao evento da Adjust.
Selecione Aplicar.
Agora o WidenAd receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o WidenAd oferecer suporte para o mapeamento automático de todos os eventos, em Mapear eventos, selecione Mapear todos os eventos. Isso economiza tempo no mapeamento de eventos individuais.
Agora o WidenAd receberá dados de eventos in-app de todos os seus eventos vinculados.
Mapear parâmetros
Os parâmetros de parceiros (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao WidenAd. Isso permite que o WidenAd receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros de parceiros ao SDK da Adjust, confira se não há parâmetros de parceiros que já atendem seus requisitos.
Para encaminhar parâmetros de parceiros ao WidenAd, siga estes passos.
- Configure os parâmetros de parceiros dentro do SDK da Adjust: iOS, Android
- Marque a caixa de compartilhamento de dados Parâmetros.
- Mapeie seus eventos.
Se você configurar os parâmetros do parceiro no SDK da Adjust sem configurar o compartilhamento de parâmetros no painel, a Adjust encaminhará os parâmetros conforme nomeados no SDK da Adjust.
Configure seu link e suas definições
Você tem a opção de definir:
Crie seu link e compartilhe-o com o WidenAd
Na tela de Revisão de configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
- Parâmetros de estrutura de link
- Destinos do usuário
- Configurações de atribuição
Selecione Criar link para criar sua URL de clique e URL de impressão, bem como seu QR Code e seu token de link. A criação de um link também permite o compartilhamento de dados e a integração com o WidenAd.
Depois de criar o link, compartilhe-o com o WidenAd para colocá-lo nas campanhas.
Lista de todos os parâmetros encaminhados ao WidenAd
O WidenAd solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Espaço reservado | Informação |
{adid} | ID de dispositivo da Adjust (todas as plataformas) |
{city} | Cidade do dispositivo |
{click_attribution_window} | Configurações da janela de atribuição para identificação de dispositivos (horas) |
{country_subdivision} | Subdivisão do dispositivo do país, p.ex. estado |
{country} | Código do país de dois caracteres do dispositivo |
{currency} | O código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{device_name} | Número do modelo do dispositivo |
{device_type} | tipo de dispositivo |
{environment} | Configuração do ambiente do SDK da Adjust atual |
{event_name} | Nome do evento, conforme definido no painel |
{gps_adid} | Advertising ID da Google Play Store |
{idfa} | ID para anunciantes (apenas iOS) |
{idfv} | iOS ID em caixa-alta para fornecedores |
{impression_attribution_window} | Configurações da janela de atribuição para identificação de impressão (horas) |
{ip_address} | Endereço IP do dispositivo |
{is_reattributed} | 1 se o usuário foi reatribuído pelo menos uma vez de uma fonte anterior. 0 se o usuário nunca tiver sido reatribuído. |
{isp} | Provedor de serviços de internet para dispositivos |
{language} | Código do idioma de dois caracteres do dispositivo |
{match_type} | método de atribuição |
{mcc} | Mobile Country Code: código de três dígitos que identifica o país do dispositivo. Use o Mobile Network Code para identificar a operadora de um dispositivo. |
{mnc} | Mobile Network Code: código de dois dígitos. Use o Mobile Country Code para identificar a operadora de um dispositivo. |
{nonce} | String aleatória alfanumérica em caixa-baixa (única por callback) |
{os_name} | Sistema operacional do dispositivo |
{os_version} | Número da versão do sistema operacional |
{revenue_float} | Receita conforme enviada do SDK da Adjust, em unidades de moedas inteiras |
{sdk_version} | Versão do SDK da Adjust (por aplicativo) |
{timezone} | Fuso horário do dispositivo |
{tracking_limited} | 1 se o monitoramento é limitado, 0 se não |
{user_agent} | Agente do usuário bruto de entrada |
{win_adid} | Identificador de publicidade do Windows |
{activity_kind} | Tipo de atividade do usuário |
{app_id} | Store App ID ou Google Play Store |
{app_name} | Nome do aplicativo |
{app_version} | Número da versão do aplicativo (Android), número da versão para bundle (iOS) |
{click_referer} | Cabeçalho referrer do clique |
{click_time} | Marca temporal do clique atribuído |
{connection_type} | Tipo de conexão de internet |
{conversion_duration} | Tempo entre o clique e a instalação ou reatribuição em segundos |
{created_at} | Marca temporal da atividade |
{device_manufacturer} | Nome do fabricante do dispositivo |
{engagement_time} | Marca temporal do engajamento |
{impression_based} | 1 se engajamento baseado em impressão, 0 se não |
{impression_time} | Marca temporal da impressão atribuída |
{installed_at} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) |
{is_organic} | 1 se for tráfego orgânico, 0 se for não orgânico |
{network_type} | Tipo de rede |
{reattributed_at} | Marca temporal da reatribuição |
{reinstalled_at} | Marca temporal da reinstalação |
{rejection_reason} | Razão para a rejeição da atribuição |
{store} | Loja de destino do clique |
{tracker_name} | Nome atual do tracker |
{uninstalled_at} | Marca temporal da desinstalação (estimação baseada no último horário da sessão) |
{oaid} | OAID ID do Dispositivo |
{is_s2s} | 1 se for um engajamento de servidor para servidor, 0 se não |
{is_s2s_engagement_based} | 1 se atribuído a um engajamento de servidor para servidor, 0 se não |
{proxy_ip_address} | Endereço IP do proxy do usuário |