Instalar o SDK

Antes de começar

É necessário que o Android Studio acompanhe esses guias.

Instalando o SDK do Android

Instale o SDK do Android usando seu método preferido: via Gradle ou manualmente.

Install using Gradle

Etapa 1: declare repositórios
No arquivo Project build.gradle, declare o repositório mavenCentral:

// ...
repositories {
   mavenCentral()
}
/// ...

Etapa 2: adicionar dependências
No arquivo do aplicativo build.gradle, adicione o pacote SDK do Android mais recente:

dependencies {
    // Get the latest version from https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk
    implementation 'com.appsflyer:af-android-sdk:6.3.2' 
}

Manual install

Configurando permissões necessárias

Adicione as seguintes permissões ao AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Os aplicativos direcionados ao Android 13 devem adicionar a seguinte permissão a AndroidManifest.xml para acessar o Android Advertising Identifier:

<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

📘

Observação

• Se seu aplicativo participa do programa Designed for Families, você não deve adicionar essa permissão.
• Para aplicativos que direcionam para API de nível 32 (Android 12L) ou superior, esta permissão não é necessária.

Para obter mais informações, consulte a documentação do Google Play Services.

Adicionando o referenciador da instalação do Google Play

OPCIONAL Recomendado
Para melhorar a precisão da atribuição, é recomendável instalar o referenciador da instalação do Google Play.

📘

Observação

• Você só precisa adicionar a dependência do referenciador da instalação do Google Play, o SDK cuida do resto.
• Make sure to add the relevant ProGuard rules.

Regras do ProGuard

OPCIONALSe você estiver usando o ProGuard e encontrar um aviso sobre nossa classe AFKeystoreWrapper, adicione o seguinte código ao seu arquivo proguard-rules.pro:

AppsFlyer SDK ProGuard rules

-keep class com.appsflyer.** { *; }

Google Play Install Referrer ProGuard rules

-keep public class com.android.installreferrer.** { *; }

Problemas conhecidos

Backup rules

Se você adicionar android:fullBackupContent="true" dentro da tag no AndroidManifest.xml, você pode receber o seguinte erro:

Manifest merger failed : Attribute [email protected] value=(true)

Para corrigir esse erro, adicione tools:replace="android:fullBackupContent" na tag <application> no arquivo AndroidManifest.xml.

Se você tiver suas próprias regras de backup especificadas (android:fullBackupContent="@xml/my_rules"), além das instruções acima, mescle-as com as regras da AppsFlyer manualmente adicionando a seguinte regra:

<full-backup-content>
    ...//your custom rules
    <exclude domain="sharedpref" path="appsflyer-data"/>
</full-backup-content>

Missing resource files

SDK V5
Se você estiver usando o SDK do Android V5 e superior, certifique-se de que no arquivo APK, além dos arquivos e recursos classes.dex, você também tem uma pasta com > appsflyer > internal com arquivos a- e b- dentro.
Nota: antes do SDK 5.3.0, nomes de arquivos são a. e b.

Verifique se você tem os arquivos necessários abrindo o APK no Android Studio:

Se esses arquivos estiverem ausentes, o SDK não poderá fazer solicitações de rede ao nosso servidor e você precisará entrar em contato com o CSM ou o suporte.

[raw data reports]: https://support.appsflyer.com/hc/en-us/articles/207034506[Probabilistic modeling attribution]: https://support.appsflyer.com/hc/en-us/articles/207447053-Attribution-model-explained#probabilistic-modeling[Download the latest Android SDK]: https://s3-eu-west-1.amazonaws.com/download.appsflyer.com/Android/AF-Android-SDK.jar[latest Android SDK]: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk[Google Play Install Referrer]: https://developer.android.com/google/play/installreferrer