Adicionando um aplicativo à AppsFlyer

Para:
Profissionais de marketing
Última atualização:

Visão geral: 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 painel, 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 você pode 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.

 Nota

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.

onboarding page.png

Para entrar no assistente Adicione 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

add an app (1).png

Adicionando um aplicativo

Depois de entrar no assistente Adicione um aplicativo, siga estas etapas:

  1. Insira as informações do aplicativo.
  2. Insira informações adicionais.
  3. Clique em Adicionar meu aplicativo.
  4. 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).
  5. Clique em Concluído ou + Adicionar outro aplicativo para adicionar mais aplicativos.

 Observaçã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 painel. Para que instalações e eventos in-app sejam registrados e atribuídos às fontes de mídia corretas, você precisará:

  • Integre 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)
  • AndroidTV
  • Amazon Fire
  • Amazon Fire TV
  • Kindle
Status do Google Play Quando usá-lo Informações necessárias

Na store

Seu aplicativo está disponível no momento na loja do Google Play

URL do Google Play (copiada do Google Play)

  • Exemplo: https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest&hl=en&gl=GB
  • Importante!
    • Se seu aplicativo não estiver listado na Google Play Store dos EUA:
      • O URL deve incluir o código do país de qualquer loja na qual esteja listada, conforme mostrado no exemplo acima: &gl={country_code}. Se você não incluir o código do país, receberá um erro ao tentar adicionar o aplicativo.
      • O código do idioma é opcional: &hl={language_code}
    • Se sua loja estiver listada na Google Play Store dos EUA, os códigos de país e idioma são opcionais.

Aprovação pendente ou não publicada

Seu aplicativo ainda não foi publicado ou está pendente de aprovação do Google Play

Nome do pacote Android

  • Exemplo: com.appsflyer.adNetworkTest
  • Observação: o nome do pacote reconhece e diferencia maiúsculas de minúsculas
  • 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 sublinhados (a-z, A-Z, 0-9 ou _)
    • Comprimento máximo de 100 caracteres

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

Loja externa/fora da loja

Seu aplicativo está em uma loja de aplicativos Android diferente do Google Play, e/ou ele pode ser baixado de um local diferente de uma loja de aplicativos

Nome do pacote Android

Para saber mais detalhes sobre as condições, veja a linha anterior (Aprovação pendente/não publicada)

Nome do canal: um nome exclusivo que você define para cada loja/local de terceiros na APK individual preparada para essa loja/local

  • Exemplo: Amazon
  • Formato: somente letras maiúsculas ou minúsculas (a-z ou A-Z). Nenhum outro caractere, como hífen (-) ou sublinhado (_), é permitido.

URL do aplicativo (copiado da loja de aplicativos externa ou do local fora da loja)

 

Se seu aplicativo estiver disponível em mais de uma fonte (em outras palavras, qualquer combinação de Google Play, lojas externa ou locais fora da loja), é vital considerar as opções para configurar a atribuição de Android multistore. A implementação adequada desde o início garantirá que você possa acessar os dados de que precisa no formato ideal. 

ioS, tvOS, MacOS

Use essa opção para as seguintes plataformas:

  • iOS
  • tvOS
  • MacOS
Status da loja de aplicativos Quando usá-lo Informações necessárias

Na store

Seu aplicativo está atualmente disponível na loja de aplicativos

URL da app store (copiada da App Store)

  • Exemplo: https://apps.apple.com/us/app/partner-integrations/id1543229303
  • Observações:
    • Certifique-se de que a URL inclui o código de país de 2 letras da loja (por exemplo, US na URL acima)
    • Um aplicativo adicionado à App Store antes de 14 de junho de 2019 pode conter itunes.apple.com em seu URL (em vez de apps.apple.com).
Aprovação pendente ou não publicada

Seu aplicativo ainda não foi publicado ou está pendente de aprovação da loja de aplicativos

 

País da App Store para o qual o aplicativo foi enviado

 

ID do aplicativo atribuído pela App Store, sem o ID do prefixo

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

Windows

Use essa opção para as seguintes plataformas:

  • Windows Phone
  • Windows (desktop)
Status da Microsoft Store Quando usá-lo Informações necessárias

Na store

Seu aplicativo está atualmente disponível na Microsoft Store

URL do Microsoft Store (copiado do Microsoft Store)

  • Exemplo: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • Observação: o URL acima é um exemplo de aplicativo do Windows Phone. O formato de URL varia para aplicativos de área de trabalho do Windows.
Aprovação pendente ou não publicada

Seu aplicativo ainda não foi publicado ou depende da aprovação da loja

 

ID do aplicativo atribuído pela Microsoft Store

  • Exemplo: 9wzdncrfhwfg
  • Observação: o ID do aplicativo reconhece e diferencia letras maiúsculas de minúsculas

Web (PBA)

 Observação

Um aplicativo web é onde você define um website a ser incluído em um pacote de marcas para nosso recurso Atribuição Baseada em Pessoas (PBA).

  • Essa opção está disponível somente para clientes que assinaram o PBA.
  • Saiba mais sobre o PBA e como atribuir visitas na web, eventos da web e instalações assistidas pelo site para obter uma visão unificada das jornadas do cliente em todos os canais, plataformas e dispositivos.

 

URL completo: o URL completo do site para o qual você deseja medir o tráfego. Este é o site no qual você implementou (ou implementará) o PBA Web SDK.

URL_diagram

Incluir –

  • esquema
  • subdomínio [opcional]
  • Nome do domínio
  • domínio de nível superior
  • caminho [opcional] – o endereço de um diretório ou página específica em seu site

Nome do aplicativo: o nome que você escolheu para seu aplicativo 

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

 

Depois de criar um aplicativo web, você não poderá editar suas propriedades (URL e nome do aplicativo) sem excluí-lo e recriá-lo, o que significa que você também deve excluir o bundle de marca do qual ele faz parte.

Próximas etapas:

  • Adicione seu aplicativo web recém-criado a um bundle de marca PBA para vê-lo no dashboard do PBA.
    • Certifique-se de que todos os aplicativos mobile que você deseja incluir no bundle da marca foram adicionados à sua conta antes de criar o bundle.
  • Integre o PBA Web SDK 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 permitidas

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

  • Exemplo: 1234567
  • Formato:
    • Caracteres numéricos, 0-9
    • Máximo de 50 caracteres
  • Como posso encontrá-lo?
    • No dashboard do desenvolvedor Roku, clique no nome do canal que você está adicionando à AppsFlyer. Isso abre a página Visualizar e Publicar do canal.
    • O número no final da URL da página em seu navegador é o ID do canal:

      find_channel_id.png

Vizio SmartCast

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo reconhecido pela Vizio (geralmente começa com as letras vz). Se você precisar confirmar o ID do aplicativo, consulte seu representante da Vizio.

Samsung Tizen

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o Bundle ID atribuído ao seu aplicativo pela Samsung. Você pode encontrá-lo no final da URL da loja de aplicativos do seu aplicativo:

samsung_tizen_url_app_id.png

LG WebOS

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo LG WebOS

PlayStation

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do conceito do PlayStation, um identificador exclusivo atribuído a um jogo ou outros conceitos de conteúdo. Ele aparece como um número de 5 a 9 dígitos no URL da loja PlayStation:

playstation_app_id_url.png

Vidaa

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo Vidaa

Steam

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo Steam. Este é o número de 5 a 8 dígitos que aparece no URL da loja Steam:

steam_store_app_url.png

Meta Quest (Oculus)

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo Meta Quest (como aparece na loja da qual o aplicativo foi baixado)

  • Exemplo: 1903584373052986

Nintendo Switch

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo do Nintendo Switch (como aparece na loja de onde o aplicativo foi baixado)

Xbox

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo do Xbox (como aparece na loja da qual o aplicativo foi baixado)

  • Exemplo: 9wzdncrfhwfg
  • Observação: o ID do aplicativo reconhece e diferencia letras maiúsculas de minúsculas

Epic Games

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo da Epic Games (conforme aparece na loja da qual o aplicativo foi baixado)

PC nativo

Nome do aplicativo: o nome que você escolheu para seu aplicativo

ID do aplicativo: o ID do aplicativo nativo para PC (caracteres possíveis: A-Z a-z 0-9 . _ -)

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

  1. Selecionar moeda

    Selecione a moeda na qual os dados deste aplicativo serão exibidos no painel. 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 definição de moeda de um aplicativo e seu impacto.

     

    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.

  2. 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. Saiba mais sobre a configuração de fuso horário de um aplicativo e seu impacto.

  3. Selecione a indicação de um aplicativo direcionado a crianças

    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).
    Se você selecionou Sim:

    1. Abra e leia o guia sobre como implementar a conformidade com aplicativos direcionados a crianças. 
    2. Marque a caixa para confirmar que você leu o guia e implementará os controles especificados.

       Nota

      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 registro de auditoria.

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.

Soluçã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.

App não está na store

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:

  1. Adicione o aplicativo com um status de Aprovação pendente/não publicado, conforme descrito acima.
  2. Acesse a página Definições do aplicativo da AppsFlyer.
  3. Altere o país da app store para o país correto (por exemplo, Japão).

Algo deu errado. Tente novamente.

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.