Como configurar a atribuição multi-store do Android

O nome do pacote Android determina qual dashboard conterá os dados de atribuição. No método de dashboard único, todas as lojas têm nomes de pacotes Android idênticos. Não há nenhum conceito de parâmetro de canal aqui.

A identificação do armazenamento de download é feita por meio do parâmetro AF_STORE definido no SDK, conforme descrito nessa seção.  O parâmetro AF_STORE não diferencia maiúsculas e minúsculas. Por exemplo, ABC, abc, Abc.  

Para preparar o APK:

1. Crie uma cópia da compilação do aplicativo. Observação: não altere o nome do pacote Android.
2. Para identificar o armazenamento individual, use um dos seguintes métodos:

   • Método do manifesto: adicione o seguinte na tag <application> do AndroidManifest.xml para identificar a loja. Defina o parâmetro AF_STORE para o nome da loja de aplicativos.

     <application>
        ...
        <meta-data android:name="AF_STORE" android:value="EnterStoreNameHere"/>
        ...
     </application>

     --OU--

   • Método da API: prepare um APK separado para cada loja de aplicativos alternativa. Faça a chamada para a API setOutOfStore para configurar o valor AF_STORE. Defina um valor exclusivo para cada loja.
      

     AppsFlyerLib.getInstance().setOutOfStore("EnterStoreNameHere")

O valor definido aqui aparece no campo install_app_store de dados brutos da AppsFlyer. Esse campo está disponível em:

• Dashboard de visão geral
• Dashboard de cohort
• Relatórios de dados brutos (os relatórios de dados brutos são um recurso premium da AppsFlyer)

Seja para criar links de atribuição para serem usados por uma ad network ou pelas suas mídias próprias, siga estas etapas para garantir que o engajamento de todos os seus links de atribuição apareça em um único dashboard.

1. No link de atribuição, defina o parâmetro URL fora da loja. Isso preenche a macro af_r no link de atribuição para redirecionar os usuários para a página de destino correta da loja de aplicativos. Por exemplo, &af_r=https://www.destinationurl.com 
   

   Atenção

   O redirecionamento padrão do URL de aplicativos fora da loja é definido na página Configurações do aplicativo. Se já tiver sido configurado, não há necessidade de atualizar o link de atribuição porque os links de atribuição criados para o aplicativo serão preenchidos automaticamente com esse URL. Saiba mais
2. Adicione o redirecionamento de af_r à lista de permissões de redirecionamento.
3. Preencha a macro af_r com o URL da página de destino da loja.
4. Defina parâmetros adicionais do link de atribuição.
5. Fontes de mídia fora da loja usam correspondência de ID para atribuição e a modelagem probabilística da AppsFlyer funciona como um método de fallback.
6. Adicione um ou mais espaços reservados de ID de usuário ao URL do link:
   • android_id
   • advertising_id
   • oaid
7. Copie o link de atribuição e entregue-o ao parceiro da ad network.

O nome do pacote Android combinado com o parâmetro de canal definido no manifesto determina qual dashboard de armazenamento conterá os dados de atribuição. 

Para preparar um APK/manifesto separado para cada armazenamento:

• adicione o seguinte na tag <application> do AndroidManifest.xml para identificar a loja. Defina o parâmetro CHANNEL para o nome da loja de aplicativos. 

  <application>
       ...
       <meta-data android:name="CHANNEL" android:value="EnterStoreNameHere"/>
       ...
  </application>

  Observação: Os parâmetros diferenciam maiúsculas e minúsculas. Para o nome do canal, você deve usar apenas letras maiúsculas ou minúsculas (az ou AZ). Nenhum outro caractere, como hífen (-) ou sublinhado (_), é permitido.

Adicione um dashboard (aplicativo) identificado pela combinação do nome do pacote Android e canal definido no APK/manifesto. Exemplo: o nome do pacote Android é com.myapp e o nome do canal é abcstore, então o nome exclusivo do dashboard é com.myapp — abcstore. 

Para adicionar um dashboard por loja na AppsFlyer:

1. Na AppsFlyer, no menu lateral, selecione Configurações > Meus aplicativos e clique em Adicionar aplicativo.
2. Selecione Android > Loja terceirizada.
3. Complete:
   • Nome do pacote Android: o nome do pacote exatamente como aparece no pacote do aplicativo.
   • Nome do canal: identificador exclusivo (nome da loja) para diferenciar entre dashboards com o mesmo nome de pacote. Verifique se você usa o mesmo valor no APK preparado para a loja.
     Atenção: Para o nome do canal, você deve usar apenas letras maiúsculas ou minúsculas (az ou AZ). Nenhum outro caractere, como hífen (-) ou sublinhado (_), é permitido.
   • URL do aplicativo:
     • Contém o endereço de download de URL padrão que preenche a macro af_r nos links de atribuição. Insira o URL onde o APK está hospedado ou o URL da landing page.
     • Você pode alterar isso por link de atribuição ao criá-los.
4. Clique em Próximo.
5. Siga as instruções na interface para concluir a adição do aplicativo. 

Instalações não orgânicas

Para testar instalações não orgânicas:

1. Use um dispositivo Android que não tenha seu aplicativo instalado ou registre o dispositivo.
2. Gere um link de atribuição de teste usando um OneLink. Use o teste como o Nome da fonte de mídia ("&pid=test").

3. Adicione um Advertising ID que seja GAID, OAID ou ID Android ao URL de clique.

   https://app.appsflyer.com/com.greatapp?pid=test
   &af_r=https://www.destinationurl.com&advertising_id=b5a3-78d9b5-0f12345-xxxx

   Envie o link de atribuição para você mesmo por e-mail e clique nele. Depois de ser redirecionado, não instale a partir da loja. Em vez disso, instale o aplicativo atualizado versão beta com o SDK de atribuição da AppsFlyer incorporado e inicialize-o.

Instalações orgânicas

Para testar instalações orgânicas:

1. Use um dispositivo Android que não tenha seu aplicativo instalado ou que esteja registrado.
2. Instale a versão beta do aplicativo atualizado com o SDK de atribuição da AppsFlyer incorporado e inicialize-o.
3. Verifique os resultados:

Resultados esperados

1. Configure um link de URL para o aplicativo nas configurações do aplicativo Meta, na seção Android.
2. Faça login na Meta como administrador do aplicativo, acesse https://developers.facebook.com/apps/ e escolha o aplicativo.
3. Acesse as configurações e encontre suas configurações de Android. Se você ainda não configurou o Android, adicione a plataforma.
4. Preencha as informações necessárias, incluindo o URL da loja de aplicativos da Amazon específico para seu aplicativo.
   
   
5. No dashboard da AppsFlyer, em “Integrações ativas”, selecione “Meta Ads” e insira o mesmo Facebook App ID usado para registrar anúncios de instalação de aplicativos mobile na loja da Meta com a AppsFlyer.

Além do dashboard de visão geral, você pode usar os seguintes métodos de relatório na AppsFlyer.

• Cohort:
  • Combine vários dashboards (aplicativos) em um único relatório
  • Veja a performance de cada dashboard, dividindo por install_app_store
• Pull API (para o método de aplicativo único) A Pull API instala dados brutos e não contém Instalar App Store por padrão. Para incluir a coluna, adicione o seguinte à chamada da Pull API: &additional_fields=install_app_store
• Dashboard personalizado (para o método de vários aplicativos) se você usar a abordagem de vários painéis, use o dashboard personalizado para combinar dados de performance de vários aplicativos em um só lugar. 

A atribuição de referrer de lojas terceirizadas é compatível com o SDK da seguinte forma: 

• O referrer da loja da Samsung: Suporte nativo.
• O referrer da loja da Huawei: Uma dependência deve ser adicionada pelo seu desenvolvedor. Consulte o Dev Hub.
• O referrer da loja da Xiaomi GetApps: Uma dependência deve ser adicionada pelo seu desenvolvedor. Consulte o Dev Hub.
   

Lojas de aplicativos Android de terceiros que possuem integrações de atribuição de referrer com a AppsFlyer

A atribuição por um referrer de lojas terceirizadas é refletida nos relatórios de dados brutos da seguinte forma:

• Tipo de correspondência: o nome da loja atribuída. Por exemplo: huawei_referrer.
• Colaborador: se o usuário tiver engajado com várias lojas de aplicativos antes de instalar o aplicativo, a AppsFlyer considera esses engajamentos como colaboradores. A instalação é concedida ao engajamento do último clique. Exemplo:
  • Um usuário clica em um anúncio exibido pelo Google e é redirecionado para a Play Store. O usuário não faz o download do aplicativo.
  • O usuário clica em outro anúncio e é redirecionado para a Samsung Galaxy Store. O usuário faz o download e instala o aplicativo.
  • A atribuição é concedida à ad network, fazendo com que o usuário seja redirecionado para a Samsung Galaxy Store. O Google é reconhecido como colaborador.