How can we help?

Pesquisa

Adicionar um aplicativo à AppsFlyer

  • Atualizado

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.

 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 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

add an app (1).png

Adicionando um aplicativo

Depois de entrar no assistente, siga essas 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. 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)

  • Exemplo: https://play.google.com/store/apps/details?id=com.appsflyer.adNetworkTest&hl=en&gl=GB
  • Importante!
    • Se o seu aplicativo não estiver listado na Google Play Store dos EUA:
      • A URL deve incluir o código do país de qualquer loja em que ele esteja listado, como como mostrado no exemplo acima: &gl={country_code}. Se você não incluir o código do país, você vai receber um erro ao tentar adicionar o aplicativo.
      • O código de idioma é opcional: &hl={language_code}
    • Se a sua loja está listada na Google Play store dos EUA, os códigos do país e do idioma são opcionais.
Aprovação pendente ou não publicada Seu aplicativo ainda não foi publicado ou depende da aprovação do Google Play

Nome do pacote Android

  • Exemplo: com.appsflyer.adNetworkTest
  • Atenção: O nome do pacote é sensível a maiúsculas/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 sublinhado (a-z, A-Z, 0-9 ou _)
    • Comprimento máximo de 100 caracteres

Para mais informações, consulte a Documentação para desenvolvedores do Android
Loja de terceiros/fora da loja 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.
  • App URL (copiada da app store externa ou local externo)
  • Nome do canal: um nome exclusivo que você define no AndroidManifest.xml do APK individual preparado para essa loja/local. O nome deve ser: 
    • diferencia maiúsculas de minúsculas
    • Nome do pacote Android 
<application>
     ...
     <meta-data android:name="CHANNEL" android:value="Amazon"/>
     ...
Etapa 1</application>:

 Nota

Não é recomendável usar o parâmetro canal para atribuição multiloja. Para uma implementação mais simples e padronizada, use o parâmetro af_store.

 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.  

iOS, tvOS, MacOS

Use essa opção para as seguintes plataformas:

  • https://support.appsflyer.com/hc/en-us/articles/4404083608849
  • 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)

  • Exemplo: https://apps.apple.com/us/app/partner-integrations/id1543229303
  • Atenção:
    • Certifique-se de que a URL inclui da código de país de duas 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 na sua URL (em vez de apps.apple.com).
Aprovação pendente ou não publicada

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

  • 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 utilizar Informações obrigatórias
In store Seu aplicativo está atualmente disponível na Microsoft Store

URL da Microsoft Store (copiada da Microsoft Store)

  • Exemplo: https://www.microsoft.com/en-us/p/wordament/9wzdncrfhwfg
  • Atenção: A URL acima é um exemplo para um app do Windows Phone. URL - formato: O formato de URL varia para aplicativos de desktop do Windows.

App ID: Comprimento máximo de 50 caracteres.
Aprovação pendente ou não publicada

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

 

App ID atribuído pela Microsoft Store

  • Comprimento máximo: 150 caracteres
  • Exemplo: 9wzdncrfhwfg
  • Atenção: O App ID é sensível a maiúsculas/minúsculas

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.

URL_diagram

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.

Web

Use a plataforma web para criar um novo aplicativo web e mensurar visitas ao site e conversões usando a mensuração de performance web.

Antes de começar

  • Aplicativos web legados de People-Based Attribution (PBA) aparecem em “web (PBA)”, marcados como Legacy.
  • Se você estiver migrando de um aplicativo web PBA legado, poderá usar sua chave de desenvolvimento web do PBA existente.

Atenção

  1. Para requisitos detalhados, veja a linha anterior (Pending approval/not published)
  2. Atenção
  3. Insira o seguinte:

 

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

  • Tamanho: 1-100 caracteres
  • Caracteres permitidos: Letras (qualquer idioma), números, espaços (não no início nem no fim) e caracteres especiais: . - _ :
  • Caracteres bloqueados: ; { } $ < > ` \

Exemplo: Minha Loja Online, Site Corporativo 2024, E-Commerce_Production

 

Domínio principal (URL completa): O domínio principal do seu site. Isso é definido durante a criação do aplicativo web e não pode ser alterado depois.

  • Formato: Somente nome de domínio válido (sem protocolo, caminho ou porta)
  • Tamanho: Máximo de 500 caracteres
  • Processamento: o AppsFlyer automaticamente
    • Remove http:// ou https://
    • Remove as barras finais
    • converte o domínio para letras minúsculas
  • Imutabilidade: Não pode ser editado após a criação do aplicativo

Importante: Para alterar o domínio principal, é necessário excluir e recriar o aplicativo web, o que resulta em perda da continuidade histórica dos dados.

Exemplos:

  • https://shop.example.com/checkout → Armazenado como shop.example.com → ID do Aplicativo: website-shop.example.com
  • example.com/ → Armazenado como example.com → ID do Aplicativo: website-example.com

 

ID do Aplicativo: O ID exclusivo que a AppsFlyer cria para o aplicativo web, com base no domínio principal.

  • Gerado automaticamente usando o formato: website-<primary_domain>
  • Por exemplo: website-shop.example.com

 

ID do SDK web: O identificador usado pelo SDK web para atribuição (anteriormente chamado de web_dev_key).

Duas opções durante a criação do aplicativo:

Opção 1: Gerar novo (padrão)

  • Cria automaticamente um novo ID do SDK web
  • Formato: website-{yourdomain.com}
  • Por exemplo: website-shop.example.com
  • Caso de uso: Novas implementações de atribuição web

Opção 2: Reutilizar chave de desenvolvimento PBA existente

  • Selecione na lista suspensa as chaves de desenvolvimento de aplicativos web PBA (People-Based Attribution) existentes
  • Permite uma migração sem interrupções sem alterar o código do site
  • Caso de uso: Migrar do PBA legado para a nova solução de atribuição web

Observação: Reutilizar a chave de desenvolvimento PBA permite migrar do PBA para o novo aplicativo web sem fazer nenhuma alteração na implementação do seu site. Etapa 1:

Cada chave de desenvolvimento PBA pode ser atribuída a apenas UM aplicativo web. Depois que uma chave de desenvolvimento PBA é usada em um aplicativo web, ela não fica mais disponível para outros aplicativos web.

  • Tamanho: 1-550 caracteres
  • Imutabilidade: Não pode ser alterado após a criação do aplicativo
  • Migração de PBA: Somente as chaves de desenvolvimento dos aplicativos web PBA da sua conta aparecem na lista suspensa

 

Moeda: A moeda usada nos relatórios do aplicativo.

  • Código de moeda padrão ISO 4217 (por exemplo, USD, EUR, GBP, ILS)
  • Selecionado no menu suspenso
  • Campo obrigatório

 

Fuso horário: o fuso horário usado para os relatórios do aplicativo.

  • Formato de fuso horário IANA (por exemplo, America/New_York, Europe/London, Asia/Tokyo)
  • Selecionado no menu suspenso
  • Campo obrigatório

 

  1. Clique em Criar aplicativo.

 

Limitações

  • O domínio principal não pode ser alterado depois que o aplicativo é criado.
  • O domínio principal é adicionado automaticamente a Domínios excluídos como tipo PRIMARY.

Cada chave legada do Web Dev só pode ser reutilizada para um novo aplicativo web.

 

Atenção

Para informações completas sobre as configurações de atribuição web, veja aqui.

 

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:

Amazon Vega OS

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

App ID: O ID do aplicativo. Encontrado usando a notação DNS reversa:  <tld>.<company_name>.<app_name>
Deve conter no mínimo 2 segmentos. Cada segmento deve começar com uma letra, seguida de caracteres entre: A-Z a-z 0-9. _ -.


Para mais informações, consulte o campo “id” na documentação do Amazon Vega OS.

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: 

  1. Faça login no Samsung TV Seller Office usando este link.
    1. Insira a URL de desenvolvedor
  2. Seu Bundle ID é gerado e exibido automaticamente. Isso pode ser usado para acessar a URL da loja de aplicativos.
  3. Em caso de problemas, abra um ticket no quadro de issues no Seller Office.
Observação: para acessar sua página web exclusiva da loja de aplicativos, adicione o Bundle ID à URL "https://www.samsung.com/us/appstore/app/". 
Por exemplo, se o seu Bundle ID for "G15147002586", a URL da sua página será "https://www.samsung.com/us/appstore/app/G15147002586/ ". A URL do desenvolvedor, o Bundle ID e o ID da loja de aplicativos são exibidos nos metadados dessa página.

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:

playstation_app_id_url.png

RIDA

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:

steam_store_app_url.png

Meta Quest (Oculus)

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 . 

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 (A-Z a-z0-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 Ide do Native PC. Inclui entre 3 a 50 caracteres de: A-Z a-z 0-9 . 

PC nativo

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-90-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.

 Nota

  • 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:

  1. Abra e leia o guia sobre como implementar a compliance em 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 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.

 Nota

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.

Adicionar um aplicativo de depuração ou teste

Se o desenvolvedor criar um aplicativo de depuração, sandbox ou aplicativo de teste, você deverá adicionar o aplicativo ao dashboard. Depois que o desenvolvedor começar a testar o aplicativo, os dados serão exibidos no dashboard do aplicativo.

Atenção

Para aplicativos iOS que ainda não foram publicados na App Store e ainda não têm um ID válido da App Store, você ainda pode prosseguir com o teste do SDK adicionando o aplicativo com um ID fictício da App Store para iOS. Isso permite a integração e o teste do SDK sem precisar de uma listagem real na App Store.

Para ver instruções para desenvolvedores sobre como criar um aplicativo de depuração e adicioná-lo ao dashboard, consulte:

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:

  1. Adicione o aplicativo com um status de Pending approval/not published, conforme descrito acima.
  2. Acesse a página Configurações do aplicativo da AppsFlyer.
  3. 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.

Outras informações

Linha de produto

Você pode adicionar ou remover aplicativos de uma linha de produto. Para mais informações sobre linhas de produto e o que elas oferecem, clique aqui.

Relacionado com

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: