Integração do SDK para Android para profissionais de marketing

É possível enviar receita com qualquer evento in-app. Certifique-se de usar o parâmetro af_revenue para incluir receita. É o único parâmetro de evento que a AppsFlyer conta como receita real nos dados brutos e no painel. Para obter mais detalhes, clique aqui.

Para obter instruções para desenvolvedor, consulte Registrar receita.

O SDK da AppsFlyer oferece verificação do servidor para compras in-app. A validação da compra in-app envia automaticamente um evento de compra in-app à AppsFlyer. Ao enviar este evento você mesmo cria relatórios de eventos duplicados.

Se seu aplicativo pertence a uma vertical, como viagens, jogos ou eCommerce consulte nossa lista de eventos in-app recomendados por vertical.

Para usuários sem o aplicativo instalado, o OneLink detecta o tipo de dispositivo e o redireciona para o destino correto (por exemplo, Google Play, Apple App Store, loja de aplicativos de terceiros ou página da web). Isso se baseia nas configurações do template do OneLink. Saiba mais

Para usuários com o aplicativo instalado, o OneLink abre o aplicativo. Além de abrir o aplicativo, você também pode fazer um deep link com usuários para uma atividade ou página específica dentro do aplicativo. Isso requer que o desenvolvedor implemente o Unified Deep Linking (UDL).

Observação:

• O UDL requer o SDK V6.1+
• Os clientes que já usam o OneLink para deep linking podem estar usando o método legado, ao invés do UDL

Consulte o nosso guia sobre configuração de links diretos com o OneLink.

Para usuários sem o aplicativo instalado, o OneLink detecta o tipo de dispositivo e os redireciona para o destino correto: Google Play, Apple App Store, loja de aplicativos de terceiros ou página da web. Depois que o usuário iniciar o aplicativo, você poderá usar deferred deep linking para redirecioná-los para uma atividade ou página específica dentro do aplicativo.

Isso requer que o desenvolvedor implemente o Unified Deep Linking (UDL).

Observação:

• O UDL requer o SDK V6.1+
• Os clientes que já usam o OneLink para deferred deep linking podem estar usando o método legado, ao invés do UDL

Consulte o nosso guia sobre ligação direta adiada para saber mais.

A AppsFlyer tem compatibilidade para a mensuração de campanhas de notificação push de todos os fornecedores e também pode oferecer suporte a desenvolvedores que usam o Google Cloud Messaging ou os serviços de notificação push da Apple diretamente. As conversões, definidas como aberturas de aplicativo originadas de mensagens de notificação push são exibidas no dashboard de Retargeting.

Você pode usar o OneLink para medir o reengajamento do usuário por meio de notificações push. Veja nosso guia sobre como medir campanhas de reengajamento por notificação por push.

Com a AppsFlyer, você pode atribuir instalações para aplicativos Android fora da loja. Isso permite que você promova seus aplicativos e alcance públicos maiores em mercados onde o Google Play não está disponível. 

Para obter mais detalhes sobre como atribuir instalações para aplicações fora da loja, leia aqui.

Nas campanhas de pré-instalação, os proprietários de aplicativos podem solicitar aos fabricantes de dispositivos que pré-instalem seus aplicativos nos dispositivos antes de saírem da fábrica.

Com a AppsFlyer, você pode atribuir facilmente instalações de aplicativos pré-instalados. Quando os usuários iniciam seu aplicativo pela primeira vez, a AppsFlyer atribui a instalação ao fabricante como uma fonte de mídia.

Para mais detalhes, clique aqui.

Para saber como configurar a métrica de desinstalação, leia aqui.

Se você deseja receber uma confirmação de que a solicitação foi recebida com sucesso pelos servidores da AppsFlyer, implemente o listener AppsFlyerRequestListener.

O método de retorno de chamada onRequestSuccess() é executado para cada resposta 200 a uma solicitação de atribuição feita pelo SDK.

O método de retorno de chamada onRequestFailure(String error) é executado para qualquer outra resposta e retorna a resposta como a sequência de caracteres de erro.

Exemplo de implementação

AppsFlyerLib.getInstance().start(getApplicationContext(), "devKey", new AppsFlyerRequestListener() {
            @Override
            public void onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully, got 200 response code from server");
            }
            @Override
            public void onError(int i, @NonNull String s) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
            }
        });

AppsFlyerLib.getInstance().start(this, "devKey", object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

Se ocorrer um erro durante o ouvinte de solicitação, um código de erro e uma descrição de string são fornecidos, conforme indicado na tabela a seguir.

A API setAdditionalData permite adicionar dados personalizados a eventos enviados pelo SDK. Normalmente, ela é usada para integrar no nível do SDK com várias plataformas externas de parceiros, como Segment, Adobe e Airship.

Exemplo de código setAdditionalData:

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

val customDataMap = HashMap<String, Any>()
customDataMap.put("custom_param_1","value_of_param_1")
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

Os proprietários de aplicativos que usam links de aplicativos para links diretos (sem OneLink) e têm um domínio associado ao aplicativo podem atribuir sessões iniciadas por meio desse domínio usando o método appendParametersToDeepLinkingUrl.

Por exemplo, um usuário faz uma pesquisa no Google e clica no seu domínio, www.exemplo.com:

• Se o usuário não tiver o aplicativo instalado, ele será direcionado para o site (www.example.com).
• Se o usuário tiver o aplicativo instalado no seu dispositivo, haverá um link direto para o aplicativo associado com www.exemplo.com. A sessão é atribuída à fonte de mídia (parâmetro pid ) especificada em appendParametersToDeeplinkingUrl.

Consulte a referência do SDK do Android para obter informações adicionais.

Observação: Smart Banners ajudam os proprietários de aplicativos a converter visitantes do site em usuários do aplicativo.

Por padrão, deve haver um intervalo mínimo de 5 segundos entre duas inicializações de aplicativos para que essas duas sessões sejam contabilizadas separadamente (saiba mais sobre contabilização de sessões).

Use a seguinte API para definir o tempo mínimo entre sessões:

AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

Definir um valor alto para o tempo personalizado entre inicializações pode gerar um impacto negativo nas APIs que dependem dos dados das sessões, como links diretos.

Você pode relatar sobre novas sessões de usuário usando esse método de SDK. Por exemplo, isso pode ser útil para aplicativos utilitários executados em segundo plano.

Use esta API no onCreate() da sua atividade:

public void logSession(Context context);

Exemplo de uso:

AppsFlyerLib.getInstance().logSession(context);

Alguns serviços de terceiros, como provedores de serviços de e-mail, envolvem links em e-mails com seus próprios domínios de gravação de links. Alguns até permitem que você defina seus próprios domínios de gravação de links. Se o OneLink estiver agrupado nesses domínios, poderá limitar sua funcionalidade.

Para superar esse problema, você pode usar a API setResolveDeepLinkURLs. Use esta API para obter o OneLink de domínios de clique que iniciam o aplicativo.  Certifique-se de chamar essa API antes da inicialização do SDK.

Por exemplo, você tem 3 domínios de clique que redirecionam para o seu OneLink, que é https://mysubdomain.onelink.me/abCD. Use essa API para obter o OneLink ao qual seus domínios de clique redirecionam.  Este método de API recebe uma lista de domínios que o SDK resolve. Adicione o seguinte código antes da inicialização do SDK.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

O código acima permite usar seu domínio de clique, preservando a funcionalidade do OneLink. Os domínios de clique são responsáveis pela inicialização do aplicativo. A API, por sua vez, recebe o OneLink desses domínios de clique e, depois, é possível usar os dados desse OneLink para aplicar deep link e personalizar o conteúdo do usuário.

Com a AppsFlyer, você pode medir as notificações push como parte de campanhas de redirecionamento. Para mais informações sobre medição de notificações por push, leia aqui.

Permitir que os usuários existentes convidem seus amigos e contatos como novos usuários para seu aplicativo pode ser um fator de crescimento importante para seu aplicativo. Com a AppsFlyer, você pode atribuir e registrar instalações originadas de convites do usuário em seu aplicativo.

Para obter detalhes, consulte o artigo de atribuição de convite do usuário.

Um ID da AppsFlyer é criado para cada nova instalação de um aplicativo. Você pode usar o ID da AppsFlyer para vários fins:

• Enviar eventos in-app de servidor para servidor.
• Combine o ID da AppsFlyer com os registros do usuário em seus sistemas de back-end.
• Mapear entradas ao mesclar dados das APIs pull e push.

Use a seguinte API para obter o ID da AppsFlyer:

public String getAppsFlyerUID(Context context);

Exemplo de uso:

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

Para definir sua ID de usuário cliente:

public void setCustomerUserId(String id);

Exemplo de uso:

AppsFlyerLib.getInstance().setCustomerUserId("myId");

Recomendamos definir o ID de usuário cliente no início do fluxo do aplicativo, pois ele está associado apenas aos eventos relatados após sua configuração:

• Se setCustomerUserID for chamado antes de chamar start, a ID de usuário cliente aparecerá nos relatórios de dados brutos para instalações e eventos.
• Se for definida depois, a ID de usuário cliente será associada apenas a eventos registrados após a configuração da ID de usuário cliente.

Para evitar definir o valor do ID de usuário cliente novamente após a primeira inicialização e reduzir as chamadas para o servidor a fim de obter o ID de usuário cliente, você pode verificar se o valor está vazio ou não, usando:

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

Para mais informações sobre ID de usuário cliente, clique aqui .

É possível atrasar a inicialização do SDK até que o customerUserID esteja definido.

Para indicar que o SDK deve atrasar a inicialização para a chamada do ID de usuário cliente:

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

imediatamente antes do método init(). O resto da inicialização do SDK deve permanecer inalterado.

Uma vez que o customerUserID foi fornecido, chame

AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);

para fornecer o SDK com o ID de usuário do cliente relevante e iniciar o SDK.

O código deve aparecer da seguinte maneira:

public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
  @Override
  public void onCreate() {
    super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
    new AppsFlyerConversionListener() {
      ...
    };
    AppsFlyerLib.getInstance().waitForCustomerUserId(true);
    //WARNING! Removing above line doesn't cancel its effect.
    // Replace with this to stop waiting for CUID:
    // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().start(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);
  }
}

class AFApplication: Application() {
 private val afDevKey = ""

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  //WARNING! Removing above line doesn't cancel its effect.
  // Replace with this to stop waiting for CUID:
  // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().start(this)
  // Do your magic to get the customerUserID
  // ...
  // any AppsFlyer SDK code invoked here will be discarded
  // Call the following API once the customerUserID is available:
  AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this)
 }
}

Para saber mais sobre como adiar a inicialização do SDK até que o ID de usuário cliente esteja disponível, acesse aqui.

A partir da versão 4.8.0 do SDK, a AppsFlyer coleta automaticamente a google_advertising_id.

O requisito para coletar esse código de publicidade do Google é relevante apenas para as versões 4.7.X ou inferiores do SDK.

O SDK não coleta automaticamente IMEI ou ID do Android. No entanto, se houver necessidade de coletar esses identificadores, o desenvolvedor poderá implementar uma dessas APIs:

• Coleta manual: o aplicativo passa o IMEI ou a ID do Android para o SDK (usando a API setIMEI ou setAndroidID). O SDK envia os dados para servidores da AppsFlyer. 

  Para enviar esses IDs para a AppsFlyer:

  1. No aplicativo, abra Coletar IMEI do dispositivo ou ID do Android.
  2. Chame as seguintes APIs ANTES de chamar o método start:

     AppsFlyerLib.getInstance().setImeiData("IMEI_HERE");
     AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_HERE");

• Aceitar coleta de ID do dispositivo: força o SDK a coletar o IMEI ou a ID do Android. Modifique o código da seguinte forma:

  AppsFlyerLib.getInstance().setCollectIMEI(true);
  AppsFlyerLib.getInstance().setCollectAndroidID(true);

Colete a OAID do Android usando o SDK da AppsFlyer para atribuir instalações de lojas de aplicativos Android de terceiros. Para obter mais informações, consulte o Guia para implementar a OAID.

Em alguns casos extremos, talvez seja necessário encerrar todos os registros do SDK devido à conformidade legal e de privacidade. Isso pode ser obtido com a API stop. Depois que essa API é chamada, o SDK para de funcionar e não se comunica mais com os servidores da AppsFlyer.

AppsFlyerLib.getInstance().stop(true, getApplicationContext());

AppsFlyerLib.getInstance().stop(true, applicationContext);

Há vários cenários diferentes para a exclusão (opt-out) de usuários. É altamente recomendado seguir as instruções exatas do cenário relevante para seu aplicativo.

O SDK pode ser reativado chamando:

AppsFlyerLib.getInstance().stop(false, getApplicationContext());
AppsFlyerLib.getInstance().start(getApplicationContext(), <AF_DEV_KEY>);

AppsFlyerLib.getInstance().stop(false, applicationContext);
AppsFlyerLib.getInstance().start(applicationContext, <AF_DEV_KEY>);

Não chame start se stop estiver definido como true. Você pode verificar o estado atual do SDK chamando:

AppsFlyerLib.getInstance().isStopped() // returns true if SDK is stopped, false otherwise

AppsFlyerLib.getInstance().isStopped // returns true if SDK is stopped, false otherwise

Use esta API durante a inicialização do SDK para anonimizar explicitamente as instalações, eventos e sessões de um usuário:

public void anonymizeUser(boolean isDisabled);

Exemplo de uso:

AppsFlyerLib.getInstance().anonymizeUser(true);

O registro pode ser reiniciado chamando AnonymizeUser definido como false.

Em alguns casos, talvez os anunciantes queiram parar de compartilhar dados no nível do usuário com ad networks/parceiros para determinados usuários. Os motivos para isso incluem: 

• Políticas de privacidade como CCPA ou GDPR
• Mecanismos para o usuário optar por não participar
• Concorrência com alguns parceiros (ad networks, terceiros)

O compartilhamento de dados com parceiros é controlado por meio do método setSharingFilterForPartners.