Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a versão em inglês.

para profissionais de mkt

Guia de migração da Adjust

Migrar de outro parceiro de mensuração mobile para a Adjust é um processo simples. Oferecemos suporte e orientação em cada passo do caminho e uma série de recursos para você consultar.

Infográfico exibindo os passos a seguir ao migrar para a Adjust a partir de outra MMP.

Siga as instruções neste guia para completar os seguintes passos na migração:

Observação:

Se seu plano incluir suporte dedicado, você vai receber workshops que cobrem a integraçāo de SDK, configuração da aquisição de usuários, exportação de dados/Business Intelligence, Datascape/análise de dados e configuração de campanhas de iOS.

Como funciona a importação de dispositivos?

O SDK da Adjust trata usuários anteriores à implementação do SDK como novos. Isso ocorre assim que eles abrem o aplicativo pela primeira vez. Dessa forma, os usuários já existentes são relatados como novas instalações. Então, se estiver usando outras ferramentas de análise ou de relatório, ou ainda, se estiver comparando os números da App Store com os do Google Play, você verá uma incompatibilidade no total de instalações registrado.

Para evitar esse problema, você pode importar usuários para a Adjust para que eles não sejam registrados como novas instalações. A Adjust registrará essas instalações como novas sessões, e elas não contarão mais no total de instalações. Ainda será possível ver a atividade e o desempenho desses usuários, por exemplo, a retenção e os eventos completados, se executar campanhas de reengajamento, já que esses usuários podem ser reatribuídos como uma nova fonte de tráfego.

1. Configure seu app na Adjust

Antes de importar seus dados históricos, é necessário configurar seu app no AppView. Todos os dados históricos são importados com o seu token de aplicativos da Adjust.

Siga as instruções em nosso Guia de configurações do app.
Depois de configurar seu app, copie o token do app .

2. Integre e teste o SDK da Adjust

Aviso:

Não submeta seu(s) aplicativo(s) a uma loja de apps antes de completar a importação dos dados. Do contrário, a Adjust contará sua base de usuários existente como novos usuários.

A documentação do SDK está disponível na seção para desenvolvedores da central de ajuda. Enquanto estiver configurando seu app para trabalhar com o SDK da Adjust, certifique-se de que você colocou o SDK no modo sandbox e que ativou o log detalhado para captar o máximo possível de informações. Em caso de dúvidas sobre a integração do SDK, entre em contato com seu representante da Adjust ou escreva para support@adjust.com.

A Adjust oferece um console de teste e uma API de dispositivo para facilitar o processo de testes. Use essas ferramentas para analisar os dados que o SDK envia aos servidores da Adjust.

3. Exporte seus dados históricos

Ao configurar seu app no AppView, é preciso criar um arquivo de importação contendo todos os dados históricos. Exporte suas informações do parceiro de mensuração mobile anterior ou de seu sistema de Business Intelligence e formate os arquivos conforme as descrições abaixo.

Formato do arquivo

Seu arquivo deve estar no formato CSV que seja:

Codificado UTF-8.
Delimitado por vírgulas
Qualificado com aspas duplas (").

Nome do arquivo

O nome do arquivo CSV precisa conter as seguintes informações em letras minúsculas :

O token de app que você salvou no passo 1.
O nome do sistema operacional de destino (ex. ios ou android).
O tipo de ID de dispositivo que o arquivo contém.

Você precisa inserir um arquivo para cada tipo de ID de dispositivo.

<app_token>_<os_name>_<device_id_type>.csv

Tipos de ID de dispositivo

Os seguintes tipos de ID de dispositivo estão disponíveis:

Para iOS :

idfa
idfv

Para dispositivos Android com foco na Google Play Store :

gps_adid
android_id

Para dispositivos Android com foco na Amazon app store :

fire_adid
android_id

Exemplo

Este exemplo apresenta o nome do arquivo que você deveria usar para os dados com as seguintes propriedades:

Relacionado a um app com o token de app da Adjust de abc123.
Para dispositivos Android .
Identificado pelo tipo de ID do dispositivo gps_adid.

abc123_android_gps_adid.csv

Campos

Importante:

Quaisquer aspas duplas ( ") em seu CSV devem ser evitadas. Para adicioná-las, inclua valores entre aspas em outro grupo de aspas duplas, como: ""High spenders"".

Seu arquivo CSV precisa conter os seguintes campos, nesta ordem:

Campo	Obrigatório ou opcional	Exemplo de valor	Observações
`device_id`	Obrigatório	`B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8`	Traços são opcionais. Tipos de ID de dispositivo ou `device_id` aceitos: `android_id` (não diferencia maiúsculas de minúsculas) `external_device_id` (diferencia maiúsculas de minúsculas) `gps_adid` (ID de publicidade do Google, não diferencia maiúsculas de minúsculas) `fire_adid` (não diferencia maiúsculas de minúsculas) `idfa` (não diferencia maiúsculas de minúsculas) `idfv` (não diferencia maiúsculas de minúsculas)
`created_at`	Opcional	`1586391845`	Marca temporal de instalação do Unix como número inteiro, especificado em segundos. Se o campo não for preenchido no arquivo de importação, o valor será preenchido automaticamente com a marca temporal da importação.
`network`	Obrigatório	`Dispositivos importados`	Dados importados devem ser colocados em uma rede separada a fim de evitar confusões com conjuntos de dados ativos da Adjust. Veja a tabela de mapeamento de redes para mais informações sobre como estruturar essa informação.
`campaign`	Opcional	`ironSource`
`adgroup`	Opcional	`ironsource_ios_us`
`creative`	Opcional	Grupo de anúncios 1

Se você não tiver informações sobre um ou mais campos opcionais, insira um campo vazio. Cada coluna deve ter o mesmo número de campos que o cabeçalho.

Mapeamento de redes

É preciso importar seus dados históricos com uma rede usada como placeholder chamada "Dispositivos importados", conforme exibido na tabela abaixo. Todos os usuários recorrentes são colocados sob esse placeholder, e seus dados permanecem limpos. Esse placeholder hardcoded implica que a Adjust pode diferenciar o tráfego vindo de usuários existentes, isto é, usuários anteriores à implementação do SDK da Adjust, e usuários novos, que devem ser atribuídos a uma campanha ativa.

Se você importar usuários sob o mesmo parceiro de rede padrão, poderá encontrar erros ao analisar certos indicadores-chave de desempenho, e isso poderia atrapalhar a análise de suas campanhas e do desempenho do app.

Se quiser fazer uma busca detalhada nos seus dados da campanha atual em até três subníveis, use a estrutura completa abaixo:

Valor do sistema anterior	Valor da importação CSV na Adjust	Observações
—	`network`	Faça hardcode desse valor como `Imported Devices`.
Nome de rede	`campaign`
Nome da campanha	`adgroup`
Nome do Ad Group ou grupo de anúncios	`creative`

A granularidade (rede, campanha e grupo de anúncios) dos dispositivos importados não é obrigatória. Ela existe caso você queira manter esses dados.

Exemplo

Aqui está um template com uma linha de cabeçalho e valores:

device_id,created_at,network,campaign,adgroup,creative
<device_id>,<created_at>,Imported Devices,<network>,<campaign>,<adgroup>

Insira valores do seu sistema anterior em <device_id>, <created_at>, <network>, <campaign>, e <adgroup>. Por exemplo:

device_id,created_at,network,campaign,adgroup,creative
B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8,1586391845,Imported Devices,ironsource,ironsource_ios_us,Ad Group 1

4. Importe seus dados na Adjust

Depois de exportar seus dados e verificar se os arquivos cumprem os critérios descritos acima, faça o upload dos arquivos em um local seguro e envio-os ao seu representante na Adjust. A equipe técnica da Adjust importa seus arquivos CSV e confere os dados para garantir que tudo esteja correto. Seu representante na Adjust entrará em contato quando a importação estiver concluída.

Observação:

Os usuários importados não aparecem automaticamente nos relatórios do Datascape. Eles aparecerão quando começarem uma sessão no app depois que você lançar uma atualização com o SDK da Adjust.

5. Lance seu app

Assim que seus desenvolvedores confirmarem que integraram o SDK e seu representante na Adjust confirmar que importou seus dados, você pode enviar uma nova versão do seu app para as lojas. Confira as estatísticas do seu app para ver se os usuários existentes e as novas instalações estão sendo registradas conforme o esperado.

6. Configure suas campanhas

Siga os guias de configuração de campanhas para configurá-las com seus parceiros de rede e redes autoatribuídas. Se você precisa de suporte nessa configuração, faça uma lista de parceiros e envie ao seu representante da Adjust.

Se seu plano incluir suporte dedicado, seu representante na Adjust vai providenciar um workshop para tratar dos seguintes temas:

Os tipos de campanha que você pode registrar
Os níveis de informação que você pode receber
Como criar um link de campanhas
A metodologia de atribuição da Adjust
Como configurar uma campanha no iOS 14 e em versões superiores

Após esse workshop, você poderá contatar seus parceiros de rede para a configuração de campanhas.

7. Atualize seus links de campanhas

Observação:

As redes não podem começar a testar antes da versão do seu aplicativo com o SDK da Adjust integrado estar disponível na loja de aplicativos.

Depois de configurar suas campanhas, envie os links de campanhas da Adjust aos seus parceiros de rede para que eles possam testar os novos links e atualizar suas configurações.

8. Explore o novo Adjust suite

É isso! É hora de começar a usar o novo Adjust suite. Confira os guias na Central de ajuda sobre:

Como analisar seus dados no Datascape.
Como configurar suas campanhas no iOS com o Conversion Hub da Adjust.
Como extrair relatórios com a API do Report Service.
Como receber os dados de exportação pelos callbacks de servidor e upload para o armazenamento em nuvem.

Se precisar de mais ajuda ou de alguma informação, entre em contato com seu Account Manager ou escreva para support@adjust.com.