Configuração do SpinApp
O SpinApp é um parceiro de analytics integrado à Adjust. Nossa integração permite que o SpinApp receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.
Neste artigo, saiba como configurar a mensuração com o SpinApp para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o SpinApp.
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 SpinApp. 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
SPINAPP APP ID, SECURITY TOKEN e ENDPOINT DOMAIN
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do SpinApp.
Selecione SpinApp e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > SpinApp. 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 SpinApp.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o SpinApp. Para fazer isso:
- Insira seus SPINAPP APP ID, SECURITY TOKEN e ENDPOINT DOMAIN.
Depois que você habilitar o compartilhamento de dados com o SpinApp, a Adjust enviará automaticamente os seguintes dados ao SpinApp, por padrão:
- instalação
- sessão
- Desinstalação
- Reinstalação
- reinstalação de reatribuição
- reatribuição
- evento
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 o Adjust compartilha com o SpinApp por padrão:
- instalação
- sessão
- Desinstalação
- Reinstalação
- reinstalação de reatribuição
- reatribuição
- evento
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o SpinApp por meio de retornos de chamada. O SpinApp pode usar essas informações para otimizar o desempenho.
Para enviar dados adicionais, você pode revisar e personalizar o seguinte:
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o SpinApp receberá a atividade das sessões do seu aplicativo.
Desinstalações ou reinstalações
O compartilhamento de desinstalações ou reinstalações permite que o SpinApp 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.
Receita in-app (a partir de compras in-app)
O compartilhamento de receita in-app permite que o SpinApp 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 SpinApp pode receber. Os dados de eventos não mapeados não são compartilhados com o SpinApp.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o SpinApp. 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 à SpinApp.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com SpinApp.
Em Evento do parceiro, selecione o evento do SpinApp 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 Evento do parceiro, escolha ou insira um nome de evento personalizado que você deseja mapear ao evento da Adjust.
Selecione Aplicar.
Agora o SpinApp receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o SpinApp 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 SpinApp receberá dados de eventos in-app de todos os seus eventos vinculados.
Mapear parâmetros
Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o SpinApp.
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 SpinApp. Isso permite que o SpinApp receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros do parceiro ao SDK da Adjust, confira se não há parâmetros pré-existentes que já atendem seus requisitos.
Para encaminhar parâmetros de parceiros ao SpinApp, siga estes passos.
Configure os parâmetros do parceiro no SDK da Adjust.
- Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.
Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.
Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:
- Selecione Mapear parâmetro.
- No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
- No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.
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.
Habilitar o SpinApp para seu aplicativo
Na tela Revisão da configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
Selecione Habilitar parceiro para habilitar o SpinApp para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.
Lista de todos os parâmetros encaminhados a SpinApp
O SpinApp 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 |
{deeplink} | URL do deeplink adicionada à URL do clique |
{device_name} | Número do modelo do dispositivo |
{environment} | Configuração do ambiente do SDK da Adjust atual |
{gps_adid} | Advertising ID da Google Play Store |
{iad_conversion_type} | Status de download: primeiro ou subsequente download do aplicativo |
{iad_creative_set_id} | ID do conjunto de criatividade do Apple Search Ads |
{iad_creative_set_name} | Nome do conjunto de criatividade da Apple Search Ads |
{iad_keyword_matchtype} | Apple Search keyword matchtype |
{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) |
{inactive_user_definition} | Período de inatividade necessário para a reatribuiçã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. |
{label} | Valor do parâmetro "label" da Adjust enviado no clique |
{language} | Código do idioma de dois caracteres do dispositivo |
{last_time_spent} | Duração da última sessão do usuário, em segundos |
{lifetime_session_count} | Número de sessões registradas durante o lifetime inteiro do usuário |
{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. |
{os_name} | Sistema operacional do dispositivo |
{os_version} | Número da versão do sistema operacional |
{partner_parameters} | Parâmetros dos parceiros personalizados coletados pelo SDK da Adjust ou solicitação S2S e transmitidos a fornecedores de terceira parte via postbacks |
{postal_code} | Código postal do endereço IP do dispositivo |
{reattribution_attribution_window} | Configurações da janela de atribuição para reatribuição (horas) |
{referrer} | Google Play Store Referrer (somente Android) |
{reftag} | Tag aleatória de referência do dispositivo |
{revenue_float} | Receita conforme enviada do SDK da Adjust, em unidades de moedas inteiras |
{sdk_version} | Versão do SDK da Adjust (por aplicativo) |
{session_count} | Número de sessões registradas pelo atual SDK da Adjust |
{time_spent} | Duração da última sessão do usuário, em segundos |
{timezone} | Fuso horário do dispositivo |
{tracking_enabled} | 1 se o monitoramento está ativado, 0 se não |
{user_agent} | Agente do usuário bruto de entrada |
{activity_kind} | Tipo de atividade do usuário |
{adgroup_name} | Nome do grupo de anúncios, conforme retirado do tracker |
{app_id} | Store App ID ou Google Play Store |
{app_version} | Número da versão do aplicativo (Android), número da versão para bundle (iOS) |
{attribution_updated_at} | Marca temporal de atribuição atualizada |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{click_time} | Marca temporal do clique atribuído |
{connection_type} | Tipo de conexão de internet |
{created_at} | Marca temporal da atividade |
{engagement_time} | Marca temporal do engajamento |
{first_tracker} | Tracker token de 6 caracteres da Adjust para uma fonte de atribuição do usuário |
{impression_based} | 1 se engajamento baseado em impressão, 0 se não |
{impression_time} | Marca temporal da impressão atribuída |
{install_begin_time} | Marca temporal do início do download do aplicativo (somente Android e Google Play Store) |
{install_finish_time} | Marca temporal da conclusão do download do aplicativo |
{installed_at} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) |
{last_session_time} | Marca temporal da última sessão |
{last_tracker_name} | O nome anterior do tracker de um usuário reatribuído |
{last_tracker} | Tracker token de 6 caracteres da Adjust do tracker anterior de um usuário reatribuído |
{network_name} | Nome da rede, conforme retirado do tracker |
{outdated_tracker} | Tracker token de 6 caracteres da Adjust para trackers desatualizados em atribuições atualizadas |
{reattributed_at} | Marca temporal da reatribuição |
{referral_time} | Marca temporal do momento em que o usuário chegou à página do aplicativo no Play Store (somente Android e Google Play Store) |
{reinstalled_at} | Marca temporal da reinstalação |
{rejection_reason} | Razão para a rejeição da atribuição |
{time_to_reinstall} | Tempo entre a última desinstalação do aplicativo e a reinstalação subsequente em segundos |
{time_to_uninstall} | Tempo entre a instalação do aplicativo (ou última reinstalação) e a desinstalação subsequente em segundos |
{tracker} | Tracker token da Adjust de 6 caracteres |
{uninstalled_at} | Marca temporal da desinstalação (estimação baseada no último horário da sessão) |