Adicionar uma app à AppsFlyer

Resumo: Saiba como adicionar a sua app à AppsFlyer para obter dados de atribuição sobre instalações e eventos na app e analisar os dados utilizando as diferentes ferramentas da AppsFlyer.

Visão geral

Se ainda não adicionou uma app ao seu painel, a página inicial para integração de apps será apresentada quando fizer login na AppsFlyer. A página de integração guia-o em todas as etapas para adicionar a sua app e também prepará-la para atribuição. 

Entrar no assistente para adicionar uma app

Pode entrar no assistente para adicionar apps a partir da plataforma ou adicionar a sua app através da página de integração (apenas para apps Android e iOS).

Para aceder ao assistente a partir da página de integração de apps:

  • No passo Adicionar a sua app, clique em Adicionar app e siga as instruções para adicionar uma app.

Nota

Se a página de integração não estiver aberta, na barra de menu superior > menu suspenso do endereço de e-mail, clique em Integração de apps.

página de integração.png

Para aceder ao assistente Adicionar uma app a partir da plataforma:

  • Na barra de menu superior > As minhas apps, clique em + Adicionar app
  • Na homepage da AppsFlyer, clique em + Adicionar app 
  • Na barra superior, abra o menu da conta (menu suspenso do endereço de e-mail) > Integração de apps, clique em + Integrar outra app

adicionar uma app (1).png

Adicionar uma app

Depois de aceder ao assistente para Adicionar uma app, siga estes passos:

  1. Introduza os detalhes da app.
  2. Introduza informações adicionais.
  3. Clique em Adicionar a minha app.
  4. Copie a chave de Dev, para ser utilizada na integração do SDK (pode recuperá-la mais tarde na página Definições da App).
  5. Clique em Concluído ou + Adicionar outra app para adicionar mais apps. Repita o processo para adicionar mais apps.

 Nota

Após registar a aplicação, esta surgirá no painel de controlo. Para que as instalações e eventos na aplicação sejam registados e atribuídos corretamente às fontes de mídia, é necessário:

  • Integrar o SDK
  • Conectar a aplicação a parceiros no Partner Marketplace

Consulte todos os passos para concluir o processo de onboarding.

Introduza os detalhes da aplicação

Selecione a plataforma da aplicação e introduza os detalhes necessários, conforme listados abaixo:

Android, AndroidTV, Fire

Utilize esta opção para as seguintes plataformas:

  • Android (móvel)
  • Android TV
  • Fire da Amazon
  • Amazon Fire TV
  • Kindle
Estado do Google Play Quando utilizar Detalhes obrigatórios

Na loja

A sua aplicação está atualmente disponível na Google Play Store

URL do Google Play (copiado de Google Play)

  • Exemplo: https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest&hl=en&gl=GB
  • Importante!
    • Se a sua aplicação não estiver listada na Google Play Store dos EUA:
      • A URL deve incluir o código do país de qualquer loja em que esteja listada, como mostrado no exemplo acima: &gl={código_do_país}. Se não incluir o código do país, irá receber um erro ao tentar adicionar a aplicação.
      • O código do idioma é opcional: &hl={código_do_idioma}
    • Se a sua loja está listada na loja Google Play dos EUA, os códigos do país e do idioma são opcionais.

Aprovação pendente/não publicada

A sua aplicação ainda não foi publicada ou está com aprovação pendente do Google Play

Nome do pacote Android

  • Exemplo: com.appsflyer.adNetworkTest
  • Nota: O nome do pacote distingue maiúsculas de minúsculas sensível
  • Formato:
    • Pelo menos dois segmentos (um ou mais pontos)
    • Cada segmento deve começar com uma letra
    • Todos os caracteres devem ser alfanuméricos ou sublinhado (a-z, A-Z, 0-9 ou _)
    • Comprimento máximo de 100 caracteres

Para mais informações, consulte a Documentação do programador Android

Loja de terceiros/fora da loja

A sua aplicação está numa loja de aplicações Android diferente da Google Play e/ou pode ser descarregada de um local que não seja uma loja de aplicações

Nome do pacote Android

Para requisitos detalhados, veja a linha anterior (Pendente aprovação/não publicado)

Nome do canal: um nome exclusivo que definiu 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 etiqueta application.

<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 inseriu no campo Nome do canal quando adicionou a aplicação. Para mais informações, consulte a aqui.

URL da Aplicação (copiado da loja de aplicativos de terceiros ou localização fora da loja)

 Importante!

Se a sua aplicação estiver disponível em mais de uma fonte (ou seja, qualquer combinação de Google Play, lojas de terceiros ou locais fora da loja), é fundamental considerar as opções para configurar a atribuição multiplataforma do Android. Uma implementação adequada desde o início garantirá que possa aceder aos dados de que necessita no formato desejado. . 

iOS, tvOS, MacOS

Utilize esta opção para as seguintes plataformas:

  • iOS
  • tvOS
  • MacOS
Estado da App Store Quando utilizar Detalhes obrigatórios

Na loja

A sua aplicação está atualmente disponível na App Store

URL da App Store (copiado da App Store)

  • Exemplo: https://apps.apple.com/us/app/partner-integrations/id1543229303
  • Notas:
    • Certifique-se de que o URL inclui o código de país de duas letras da loja (por exemplo, us no URL acima)
    • Uma aplicação adicionada à App Store antes de 14 de junho de 2019, pode conter itunes.apple.com no seu URL (em vez de apps.apple.com).
Aprovação pendente/não publicada

A sua aplicação ainda não foi publicada ou está com aprovação pendente da App Store

País da App Store para o qual a aplicação foi submetida

 

ID da Aplicação atribuído pela App Store, sem o prefixo id

  • Exemplo: 1543229303
  • Formato: 9 ou 10 caracteres numéricos caracteres, 0-9

Windows

Utilize esta opção para as seguintes plataformas:

  • Windows Phone
  • Windows (desktop)
Estado da Microsoft Store Quando utilizar Detalhes obrigatórios

Na loja

A sua aplicação está atualmente disponível na Microsoft Store

URL da Microsoft Store (copiado da Microsoft Store)

  • Exemplo: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • Nota: O URL acima é um exemplo para uma aplicação do Windows Phone. O formato do URL varia para aplicações de desktop do Windows.

ID da Aplicação: Comprimento máximo de 150 caracteres.

Aprovação pendente/não publicada

A sua aplicação ainda não foi publicada ou está com aprovação pendente da loja

ID da aplicação atribuído pela Microsoft Loja

  • Comprimento máximo: 150 caracteres
  • Exemplo: 9wzdncrfhwfg
  • Nota: O ID da aplicação é sensível a maiúsculas sensível

Web (PBA)

 Nota

Uma aplicação web é onde define um site para incluir num pacote de marca para a nossa funcionalidade People-Based Attribution (PBA).

  • Esta opção está disponível apenas para clientes que subscreveram 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 completo: O URL completo do website para o qual deseja medir o tráfego. Este é o website no qual aplicou (ou irá aplicar) o SDK Web do PBA.

altDiagrama_URLalt

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 da aplicação: O nome que escolheu para a sua aplicação 

  • Comprimento máximo: 100 caracteres
  • Tags XSS não são permitidas

 Importante!

Após criar uma aplicação web, não poderá editar as suas propriedades (URL e nome da aplicação) sem a eliminar e recriar o que significa que também deve apagar o pacote da marca a que pertence.

Próximos passos:

  • Adicione a sua nova aplicação web a um Pacote de Marca do PBA para visualizá-la no painel do PBA.
    • Assegure-se de que todas as aplicações móveis que deseja incluir foram adicionadas à sua conta no pacote da marca antes de criar o pacote.
  • Integre o SDK Web do PBA ao site especificado na aplicação web para obter a medição dos dados em fluxo.

Roku

Nome da aplicação: Nome do canal copiado do Painel do Programador Roku.

  • Exemplo: O meu canal Roku
  • Formato:
    • Comprimento máximo de 100 caracteres
    • Tags XSS não são permitidas

ID do canal: ID numérico atribuído ao canal pelo Roku.

  • Formato:
    • Caracteres numéricos (0-9)
    • Comprimento máximo: 50 caracteres
  • Como posso encontrá-lo?
    • No Painel do Programador Roku, clique no nome do canal que está a 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 ID do Canal: ID do Canal:

Vizio SmartCast

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da aplicação: O ID da aplicação, reconhecido pela Vizio. Começa com as letras vz, seguido de 2 a 10 caracteres de: . - 0-9. -. Se precisar de confirmar o ID da aplicação, consulte o seu representante Vizio. 

Samsung Tizen

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID do pacote atribuído à sua aplicação pela Samsung. Começa com a letra G, seguida de 8 a 15 dígitos. Pode encontrá-lo no final do URL da loja de apps da sua aplicação:

LG WebOS

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação LG WebOS.

  • Formato:
    • Comprimento máximo de 50 caracteres
    • Caracteres de A-Z a-z. _ em formato de pacote formatado. Deve começar com letras.
  • Exemplo: com.a-minha-empresa.app 

Se precisar de confirmar o ID da aplicação, consulte o seu representante LG WebOS.  

PlayStation

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: 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 no URL da loja PlayStation. Pode encontrá-lo no final do URL da loja de apps da sua aplicação:

playstation_app_id_url.png

Vidaa

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Vidaa. Comprimento máximo de 50 caracteres.

Steam

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Steam. Este é o número composto por 5 a 8 dígitos que aparece no URL da loja Steam:

steam_store_app_url.png

Meta Quest (Oculus)

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da aplicação: A ID da aplicação Meta Quest, conforme aparece no final do URL da loja Meta, de onde a aplicação é descarregada. Inclui entre 3 a 50 caracteres de: 0-9 a-z0-9 . _ -

Nintendo Switch

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Nintendo Switch, conforme aparece no final do URL da loja de onde a aplicação é descarregada. Inclui 14 dígitos.

  • Exemplo: 70010000012345

Xbox

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Xbox, conforme aparece no final do URL da loja Xbox, de onde a aplicação é descarregada. Inclui apenas 12 letras e dígitos (0-9 0-90-9). 

Nota: O ID da aplicação diferencia letras maiúsculas de minúsculas.

Epic Games

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Epic Games, conforme aparece na loja de onde a aplicação é descarregada. Inclui entre 3 a 50 caracteres de: 0-9 0-90-9 . _ -

PC Nativo

Nome da aplicação: O nome que escolheu para a sua aplicação.

ID da Aplicação: O ID da aplicação Nativa para PC. Inclui entre 3 a 50 caracteres de: 0-9 0-90-9 . _ -

Insira informações adicionais (não aplicáveis a aplicações web):

Selecione a moeda

Escolha a moeda na qual os dados desta aplicação serão exibidos no painel. Os eventos de receitas e despesas são convertidos para esta moeda com base na taxa de câmbio vigente no momento do evento. Saiba mais sobre a configuração de moeda de uma aplicação e o seu impacto.

 Importante!

Tenha cuidado ao escolher a moeda que pretende usar para a aplicação. Não será possível alterá-la depois de o custo e a receita terem sido registados.

Selecione o fuso horário

Alinhe o fuso horário selecionado aqui com o fuso horário definido com outros parceiros de atribuição (como Meta Ads e Google Ads). Isto assegura a melhor correspondência entre os dados reportados no painel da AppsFlyer e os dados que recebe desses parceiros.

Nota

  • Assim que o fuso horário for definido, ficará bloqueado e não poderá ser alterado até ao dia seguinte.
  • Saiba mais sobre como configurar o fuso horário da aplicação e o impacto disto.

Defina o público da aplicação

Escolha Sim ou Não para indicar se a sua aplicação é direcionada a crianças ou a um público misto (crianças e adultos).
Caso tenha selecionado Sim:

  1. Abra e consulte o guia sobre como assegurar a conformidade com as aplicações direcionadas a crianças. 
  2. Assinale a opção para confirmar que leu o guia e implementará os controlos indicados.

Nota

  • Duas semanas após adicionar a aplicação, receberá uma notificação para confirmar que implementou os controlos de privacidade nas suas aplicações para crianças. Após confirmar, receberá uma mensagem de confirmação. Poderá sempre aceder à mensagem de confirmação no Centro de Notificações ou verificar os detalhes da confirmação no Registo de Auditoria.
  • Veja as perguntas frequentes sobre apps dirigidas a crianças.

Gerencie suas aplicações em massa através da API

Os administradores de conta podem gerir múltiplas aplicações em massa utilizando uma API dedicada que suporta as principais funcionalidades da UI. Isso inclui adicionar e remover aplicações, assim como atualizar as definições das mesmas. A API também possui os mesmos mecanismos de verificação de erros.

Nota

Nesta fase, adicionar aplicações e atualizar as definições das aplicações via API é possível somente para aplicações móveis. A eliminação de aplicações é possível para todas as plataformas.

Sobre aplicações pendentes

Trabalhar com uma aplicação em estado pendente pode ser útil durante o processo de depuração para testar o SDK da AppsFlyer.

O estado de pendente no painel não afeta a recolha e medição de dados. Quer a aplicação esteja pendente ou ativa na loja de apps, se os utilizadores a instalarem e interagirem com ela, os dados de instalação e eventos na app serão registados no painel.

Assim que a sua aplicação pendente for lançada, a AppsFlyer irá detetar e atualizar automaticamente o estado, não sendo necessário adicioná-la de novo. Saiba mais sobre as aplicações pendentes e sobre o procedimento opcional para atualizar manualmente o seu estado.

Resolução de problemas

Encontre soluções para algumas questões comuns:

A aplicação não foi adicionada

Se esse erro ocorrer, entre em contato com o seu CSM ou envie um e-mail para hello@appsflyer.com.

Aplicação não está disponível na loja

Confirme que copiou corretamente o URL da loja, utilizando o nome/ID da aplicação adequado.

Não é possível aceder ao marketplace

Este erro pode ocorrer ao adicionar uma aplicação Android de uma loja fora dos EUA. Siga os passos abaixo para o resolver:

  1. Adicione a aplicação com o estado de Aprovação pendente/não publicada, conforme descrito anteriormente.
  2. Vá à página de Definições da Aplicação da AppsFlyer.
  3. Mude o país da App Store para o correto (por exemplo, Japão).

Ocorreu um erro. Por favor, tente outra vez.

Um motivo possível para este erro é tentar adicionar uma aplicação Android sem um código de país (para aplicações não listadas na Google Play Store dos EUA). Veja os detalhes completos para resolver este problema acima.