Configuração do parceiro Firefly
O Firefly é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Firefly 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 Firefly 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 Firefly.
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 Firefly. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciais
Firefly Account Id
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Firefly.
Selecione Firefly e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Firefly. 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 Firefly.
- Selecione Próximo.
Habilite o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Firefly. Para fazer isso:
- Insira seus Firefly Account Id.
Depois que você habilitar o compartilhamento de dados com o Firefly, a Adjust enviará automaticamente os seguintes dados ao Firefly, por padrão:
- instalação
- Desinstalação
- Reinstalação
- reatribuição
- evento
- instalação rejeitada
- Reatribuiçã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 Firefly por padrão.
- instalação
- Desinstalação
- Reinstalação
- reatribuição
- evento
- instalação rejeitada
- Reatribuição rejeitada
Envie dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o Firefly por meio de callbacks. O Firefly 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 Firefly:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Firefly
Desinstalações ou reinstalações
O compartilhamento de desinstalações ou reinstalações permite que o Firefly receba os dados de desinstalação e/ou reinstalação do seu aplicativo mensurados pela Adjust.
No caso de apps iOS, pode haver uma baixa quantia de desinstalações e/ou reinstalações. Para mais informações, confira o artigo Mensuração de desinstalações e reinstalações.
Mapeando eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Firefly pode receber. Os dados de eventos não mapeados não são compartilhados com o Firefly.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Firefly. 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 à Firefly.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com o Firefly.
Em Evento de parceiro, selecione o evento do Firefly 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 Firefly receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Firefly 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 Firefly 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 o Firefly
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 Firefly.
Depois de criar o link, compartilhe-o com o Firefly para colocá-lo nas campanhas.
Lista de todos os parâmetros encaminhados ao Firefly
O Firefly 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 |
{cost_amount} | Custo por engajamento do usuário (disponível apenas no monitoramento de custos com anúncios) |
{cost_currency} | Código de moedas da ISO 4217 dos dados de custo (disponível apenas no monitoramento de custos com anúncios) |
{cost_type} | O modelo de preço da campanha (disponível apenas no monitoramento de custos com anúncios) |
{country_subdivision} | Subdivisão do dispositivo do país, p.ex. estado |
{country} | Código do país de dois caracteres do dispositivo |
{device_name} | Número do modelo do dispositivo |
{device_type} | tipo de dispositivo |
{fire_adid} | Identificador de publicidade do Fire OS |
{gps_adid} | Advertising ID da Google Play Store |
{idfa||android_id} | IDFA ou Android ID se o IDFA estiver vazio |
{idfv} | iOS ID em caixa-alta para fornecedores |
{ip_address} | Endereço IP do dispositivo |
{language} | Código do idioma de dois caracteres do dispositivo |
{os_name} | Sistema operacional do dispositivo |
{os_version} | Número da versão do sistema operacional |
{postal_code} | Código postal do endereço IP do dispositivo |
{region} | Código da região do dispositivo |
{user_agent} | Agente do usuário bruto de entrada |
{win_udid} | ID do dispositivo único do Windows Phone |
{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) |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{created_at} | Marca temporal da atividade |
{device_manufacturer} | Nome do fabricante do dispositivo |
{installed_at} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) |
{tracker_name} | Nome atual do tracker |