Configuração do parceiro Surgex
O Surgex é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Surgex 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 Surgex 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 Surgex.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de Surgex. 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 Surgex e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Surgex. Selecione Próximo 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 Surgex.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Surgex. Para habilitá-lo:
- Deixe na opção Habilitado
Depois que você habilitar o compartilhamento de dados com o Surgex, a Adjust enviará automaticamente os seguintes dados ao Surgex, por padrão:
- instalação
- evento
- receita de anúncios
Configurar 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 Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que a Adjust compartilha com o Surgex por padrão.
- instalação
- evento
- receita de anúncios
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Surgex por meio de callbacks. O Surgex 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 você está compartilhando com o Surgex:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Surgex
Receita de anúncios (de ad views)
O compartilhamento de receita de anúncios permite que o Surgex receba dados de receita de anúncios do usuário para otimizar a segmentação de usuários e campanhas.
Esse recurso está disponível no pacote de Receita de anúncios da Adjust. Para adquiri-lo, contate seu representante de vendas.
Para compartilhar a receita de anúncios com o Surgex, 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.
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que o Surgex receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar esses dados.
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Surgex pode receber. Os dados de eventos não mapeados não são compartilhados com o Surgex.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Surgex. 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ê quer enviar diretamente à Surgex.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Surgex.
Em Evento de parceiro, selecione o evento do Surgex 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 Surgex receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Surgex 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 Surgex receberá dados de eventos in-app de todos os seus eventos vinculados.
Configure seu link e suas definições
Você tem a opção de definir:
Crie seu link e compartilhe-o com Surgex
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 Surgex.
Depois de criar o link, compartilhe-o com o Surgex para colocá-lo nas campanhas.
Lista de todos os parâmetros encaminhados a Surgex
Surgex solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Placeholder | Informação |
{city} | Cidade do dispositivo |
{country} | Código do país do dispositivo de dois caracteres |
{currency} | O código ISO 4217 da moeda original enviado pelo SDK da Adjust |
{device_name} | Número do modelo do dispositivo |
{device_type} | tipo de dispositivo |
{event_name} | Nome do evento, conforme definido no painel |
{gps_adid} | Advertising ID da Google Play Store |
{idfa} | ID para anunciantes (apenas iOS) |
{ip_address} | Endereço IP do dispositivo |
{match_type} | método de atribuição |
{os_name} | Sistema operacional do dispositivo |
{os_version} | Número da versão do sistema operacional |
{region} | Código da região do dispositivo |
{revenue_usd} | Receita, em dólares americanos |
{click_time} | Marca temporal do clique atribuído |
{created_at} | Marca temporal da atividade |
{engagement_time} | Marca temporal do engajamento |
{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_name} | Nome da rede, conforme retirado do tracker |
{ad_revenue_network} | Rede de anúncios que exibiu o anúncio |