Resumo: saiba como adicionar seu aplicativo à AppsFlyer para obter dados de atribuição sobre instalações e eventos in-app e analisar os dados usando as diferentes ferramentas da AppsFlyer.
Visão geral
Se você ainda não adicionou um aplicativo ao seu dashboard, a página Integração do aplicativo será exibida quando você fizer login na AppsFlyer. A integração do aplicativo orienta você em todas as etapas para adicionar seu aplicativo e também prepará-lo para atribuição.
Entrar no assistente para adicionar um aplicativo
Você pode adicionar todos os seus aplicativos por meio da página de integração do aplicativo ou entrar no assistente para adicionar aplicativos na plataforma.
Para entrar no assistente na página de integração do aplicativo:
- Na etapa Adicione um aplicativo, clique em Adicionar aplicativo e siga as instruções para adicionar um aplicativo.
Atenção
Se a página de integração ainda não estiver aberta, na barra de menu superior > menu suspenso de endereço de e-mail, clique em Integração do aplicativo.
Para entrar no assistente e adicionar um aplicativo da plataforma:
- Na barra de menu superior > Meus aplicativos, clique em + Adicionar aplicativo
- Na página inicial da AppsFlyer, clique em + Adicionar aplicativo
- Na barra de menu superior > menu suspenso de endereço de e-mail > Integração do aplicativo, clique em + Integrar outro aplicativo
Adicionando um aplicativo
Depois de entrar no assistente, siga essas etapas:
- Insira as informações do aplicativo.
- Insira informações adicionais.
- Clique em Adicionar meu aplicativo.
- Copie a chave do desenvolvedor, para ser usada na integração do SDK (você pode recuperá-la posteriormente na página Configurações do aplicativo).
- Clique em Concluído ou + Adicionar outro aplicativo para adicionar mais aplicativos. Repita o processo para adicionar mais apps.
Atenção
- Somente administradores e usuários da conta com as permissões necessárias podem adicionar aplicativos.
- Conforme você segue as etapas para adicionar um aplicativo (abaixo), as opções disponíveis variam de acordo com as opções anteriores selecionadas.
Após registrar o aplicativo, ele aparecerá no dashboard. Para que instalações e eventos in-app sejam registrados e atribuídos às fontes de mídia corretas, você precisará:
- Integrar o SDK
- Conectar o aplicativo a parceiros no Partner Marketplace
Veja todas as etapas para concluir o processo de integração.
Insira detalhes do aplicativo
Selecione a plataforma do aplicativo e digite as informações necessárias, conforme listado abaixo:
Android, AndroidTV, Fire
Use essa opção para as seguintes plataformas:
- Android (mobile)
- Android TV
- Fire da Amazon
- Amazon Fire TV
- Kindle
Status do Google Play | Quando utilizar | Informações obrigatórias |
---|---|---|
In store |
Seu aplicativo está disponível no momento na loja do Google Play |
URL do Google Play (copiado do Google Play)
|
Pending approval/not published |
Seu aplicativo ainda não foi publicado ou depende da aprovação do Google Play |
Nome do pacote Android
Para mais informações, consulte a Documentação para desenvolvedores do Android |
3rd-party store/out-of-store |
Seu aplicativo está em uma app store Android diferente do do Google Play e/ou pode ser baixado do um local que não seja uma loja de aplicativos |
Nome do pacote Android Para requisitos detalhados, veja a linha anterior (Pending approval/not published)
Nome do canal: um nome exclusivo
que você define no AndroidManifest.xml do
APK individual preparado para essa loja/local. Por
exemplo,
para um APK da loja da Amazon, adicione o seguinte
dentro
da tag <application> ... <meta-data android:name="CHANNEL" android:value="Amazon"/> ... </application> O nome deve respeitar maiúsculas e minúsculas e ser idêntico ao nome que você inseriu no campo nome do canal quando adicionou o aplicativo. Para mais informações, consulte aqui. App URL (copiada da app store externa ou local externo) Importante!Se o seu aplicativo estiver disponível em mais de uma fonte (ou seja, qualquer combinação de Google Play, lojas de terceiros ou locais externos), é fundamental considerar opções para configurar a atribuição multiplataforma do Android. Uma implementação adequada desde o início garantirá o acesso aos dados necessários no formato que você precisa. |
iOS, tvOS, MacOS
Use essa opção para as seguintes plataformas:
- iOS
- tvOS
- MacOS
Status da App Store | Quando utilizar | Informações obrigatórias |
---|---|---|
In store |
Seu aplicativo está atualmente disponível na App Store |
URL da App Store (copiada da App Store)
|
Pending approval/not published |
Seu aplicativo ainda não foi publicado ou depende da aprovação da App Store
|
País da App Store para o qual o aplicativo foi submetido
App ID atribuído da App Store, sem o prefixo id
|
Windows
Use essa opção para as seguintes plataformas:
- Windows Phone
- Windows (desktop)
Status da Microsoft Store | Quando utilizar | Informações obrigatórias |
---|---|---|
In store |
Seu aplicativo está atualmente disponível na Microsoft Store |
URL da Microsoft Store (copiada da Microsoft Store)
App ID: Comprimento máximo de 50 caracteres. |
Pending approval/not published |
Seu aplicativo ainda não foi publicado ou depende da aprovação da loja
|
App ID atribuído pela Microsoft Store
|
Web (PBA)
Atenção
Um aplicativo web é onde você define um site que será incluso em um brand bundle a nossa funcionalidade People-Based Attribution (PBA).
- Esta opção está disponível apenas para clientes que assinam o PBA.
- Saiba mais sobre o PBA e a atribuição de visitas web, eventos web e instalações assistidas por site para obter uma visão unificada das jornadas dos clientes em canais, plataformas e dispositivos.
URL completa: A URL completa do site para o qual você deseja mensurar o tráfego. Este é o site no qual você implementou (ou irá implementar) o SDK Web do PBA.
Incluir –
- esquema
- subdomínio [opcional]
- nome de domínio
- domínio de nível superior
- caminho [opcional] – o endereço de um diretório ou página específica no seu website
Nome do aplicativo: O nome que você escolheu para o seu aplicativo
- Comprimento máximo: 100 caracteres
- Tags XSS não são permitidas
Importante!
Após criar um aplicativo web, você não poderá editar as suas propriedades (URL e nome do aplicativo) sem precisar deletá-lo e recriá-lo, o que significa que você também deve apagar o brand bundle ao qual ele pertence.
Próximos passos:
-
Adicione seu novo aplicativo web a um
Brand Bundle do PBA
para visualizá-lo no dashboard do PBA.
- Assegure-se de que todos os aplicativos mobile que você deseja incluir foram adicionados à sua conta no brand bundle antes de criar o bundle.
- Integre o Web SDK do PBA ao site especificado no aplicativo web para fazer com que os dados de mensuração sejam transmitidos.
Roku
Nome do aplicativo: Nome do canal copiado do Roku Developer Dashboard.
- Exemplo: Meu canal Roku
-
Formato:
- Comprimento máximo de 100 caracteres
- Tags XSS não são permitidas
Channel ID: ID numérico atribuído ao canal pela Roku.
-
Formato:
- Caracteres numéricos (0-9)
- Comprimento máximo: 50 caracteres
-
Como posso encontrá-lo?
- No Roku Developer Dashboard, clique no nome do canal que você quer adicionar à AppsFlyer. Isto abrirá a página do Roku Preview & Publish para o canal.
-
O número no final da URL da página é o Channel ID:
ID:
Vizio SmartCast
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID, reconhecido pela
Vizio. Começa com as letras vz
, seguido de 2 a 10
caracteres de: .
-
0-9
.
-
.
Se precisar confirmar o
App ID, fale com o seu representante da Vizio.
Samsung Tizen
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O Bundle ID atribuído ao seu app pela
Samsung. Começa com a letra G
, seguida de 8 a 15
dígitos. Você pode encontrá-lo no final da URL da loja de aplicativos do seu
app:
LG WebOS
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID da LG WebOS.
-
Formato:
- Comprimento máximo de 50 caracteres
-
Caracteres de
A-Z
a-z
.
_
em um formato bundle-like . Deve começar com letras.
- Exemplo: com.a-minha-empresa.app
Se precisar de confirmar o App ID, fale com o seu representante LG WebOS.
PlayStation
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O conceito de ID da PlayStation, um identificador único atribuído a um jogo ou a outros conceitos de conteúdo. Aparece como um número de 5 a 9 dígitos na URL da PlayStation store. Pode encontrá-lo no final da URL:
Vidaa
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID da Vidaa. Comprimento máximo de 50 caracteres.
Steam
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID da Steam. Este é o número composto por 5 a 8 dígitos que aparece na URL da loja Steam:
Meta Quest (Oculus)
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID do Meta Quest, conforme aparece
no final da URL da Meta app store, de onde o aplicativo é baixado.
Inclui entre 3 a 50 caracteres de: A-Z
a-z
0-9
.
_
-
.
Nintendo Switch
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID do Nintendo Switch, conforme aparece no final do URL da loja de onde o aplicativo é baixado. Inclui 14 dígitos.
- Exemplo: 70010000012345
Xbox
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID do Xbox, conforme aparece no
final da URL da loja do Xbox, de onde o aplicativo é baixado. Inclui
apenas 12 letras e dígitos (0-9
0-9
0-9
).
Atenção: O App ID diferencia letras maiúsculas de minúsculas.
Epic Games
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App ID da Epic Games, conforme aparece
na loja de onde o aplicativo é baixado. Inclui entre 3 a 50
caracteres de: A-Z
a-z
0-9
.
_
-
.
Native PC
Nome do aplicativo: O nome que você escolheu para o seu aplicativo.
App ID: O App Ide do Native PC. Inclui entre 3 a 50
caracteres de: A-Z
a-z
0-9
.
_
-
.
Insira informações adicionais (não aplicáveis a aplicativos da web):
Selecione a moeda
Selecione a moeda na qual os dados deste aplicativo serão exibidos no dashboard. Os eventos de receita e gasto são convertidos para essa moeda usando a taxa de câmbio em vigor no momento do evento. Saiba mais sobre a configuração de moeda de um aplicativo e seu impacto.
Importante!
Tome cuidado ao selecionar a moeda que deseja usar para esse aplicativo. Você não poderá alterá-la depois que o custo e a receita tiverem sido registrados.
Selecione o fuso horário
Alinhe o fuso horário que você selecionar aqui com o fuso horário que você definir com outros parceiros de atribuição (como Meta ads e do Google). Isso garante a correspondência mais próxima entre os dados reportados no dashboard da AppsFlyer e os dados que você recebe desses parceiros.
Atenção
- Depois que o fuso horário for definido, ele permanecerá bloqueado e não poderá ser alterado até o dia seguinte.
- Saiba mais sobre a configuração de fuso horário de um aplicativo e seu impacto.
Configure a audiência do aplicativo
Selecione Sim ou Não para indicar se seu aplicativo é direcionado ou não para crianças ou para um público misto (crianças e adultos).
Caso tenha selecionado Sim:
- Abra e leia o guia sobre como implementar a compliance em aplicativos direcionados a crianças.
- Marque a caixa para confirmar que você leu o guia e implementará os controles especificados.
Atenção
- Duas semanas após adicionar o aplicativo, você receberá uma notificação solicitando a confirmação de que implementou controles de privacidade para seus aplicativos direcionados a crianças. Após a confirmação, você receberá uma mensagem de confirmação. Você sempre pode acessar a mensagem de confirmação na Central de notificações ou ver os detalhes da confirmação no log de auditoria.
- Veja as perguntas frequentes sobre aplicativos para crianças.
Gerencie seus aplicativos em massa através da API
Os administradores de conta podem gerenciar múltiplos aplicativos em massa utilizando uma API dedicada que oferece suporte para as principais funcionalidades. Isso inclui adicionar e remover aplicativos, assim como atualizar suas configurações. A API também possui os mesmos mecanismos de verificação de erros.
Atenção
Nessa fase, adicionar aplicativo e atualizar as configurações via API só é possível para aplicativos mobile. Você pode deletar aplicativos para todas as plataformas.
Sobre aplicativos pendentes
Trabalhar com um aplicativo em estado pendente pode ser útil quando você estiver depurando-o para testar o SDK do AppsFlyer.
O status do aplicativo como "pendente" no painel não tem efeito na coleta e medição de dados. Se um aplicativo está pendente ou online em uma loja de aplicativos, se os usuários instalam e interagem com ele, os dados de instalação e de eventos no painel de controle são gravados exatamente da mesma forma.
Quando seu aplicativo pendente for ativado, a AppsFlyer detectará e atualizará automaticamente seu status, para que você não precise adicioná-lo novamente. Saiba mais sobre aplicativos pendentes e o procedimento opcional para atualização manual do status.
Resolução de problemas
Encontre soluções para algumas questões comuns:
O aplicativo não foi adicionado
Se esse erro ocorrer, entre em contato com seu CSM ou envie um e-mail para hello@appsflyer.com.
Aplicativo não está disponível na loja
Verifique se você copiou a URL da store corretamente, usando o nome/ID apropriados do aplicativo.
Não é possível acessar o marketplace
Esse erro às vezes ocorre quando se adiciona um aplicativo Android de uma store que não seja dos EUA. Para resolver esse problema, siga as etapas abaixo:
- Adicione o aplicativo com um status de Pending approval/not published, conforme descrito acima.
- Acesse a página Configurações do aplicativo da AppsFlyer.
- Altere o país da app store para o país correto (por exemplo, Japão).
Ocorreu um erro. Por favor, tente outra vez.
Um possível motivo para esse erro é tentar adicionar um aplicativo Android sem um código de país (para aplicativos não listados na Google Play Store dos EUA). Veja os detalhes completos para resolver esse problema acima.
Meu aplicativo iOS foi removido da App Store. Por que ainda estou vendo instalações?
Isso acontece porque os usuários podem reinstalar um aplicativo pelo sistema operacional se ele já existia em seu dispositivo. Mesmo que o aplicativo não esteja mais disponível na App Store, os usuários ainda podem instalá-lo, e essas instalações serão contabilizadas na AppsFlyer.