Instalar o SDK
Saiba como baixar e instalar o SDK para Android.
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
- No Android Studio, alterne a estrutura de pastas do Android para o Project:
- Faça download do SDK do Android mais recente e cole-o em seu projeto Android, em aplicativo > libs.
- Clique com o botão direito do mouse no
jar
que você colou e selecione Adicionar como biblioteca. Quando solicitado, clique em Refatorar. Se for solicitado a confirmar o git, clique em OK.
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
Atualizado 22 dias atrás