Integração do SDK da AppsFlyer - Unity

Configurando permissões o receptor AF no AndroidManifest.xml:

<!-- receiver should be inside the <application> tag -->
<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
        <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
        </intent-filter>
</receiver>
<!-- Mandatory permission: -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

Definindo as permissões necessárias

O AndroidManifest.xml inclui a seguinte permissão:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Optional : -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Configurando o BroadcastReceiver no AndroidManifest.xml

As duas opções a seguir estão disponíveis para implementar o receptor de broadcast da referência de instalação:

<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
    <intent-filter>
         <action android:name="com.android.vending.INSTALL_REFERRER" />
     </intent-filter>
</receiver>

<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
  <intent-filter>
     <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

Após criar o projeto no Unity para o xCode, você deve adicionar Security.Framework às Estruturas e bibliotecas vinculadas do xCode se a estrutura não tiver sido adicionada anteriormente.

Anúncios do Apple Search do iOS

Adicione o seguinte:

AdSupport.framework

A AppsFlyer coleta o IDFA somente se você incluir essa estrutura. Se essa estrutura não for adicionada, você não consegue acompanhar o Facebook, o Twitter e a maioria das outras redes de anúncios.

iAd.framework

É altamente recomendável adicionar essa estrutura ao seu projeto de aplicativo, já que ela é obrigatória para acompanhar os anúncios do Apple Search.

A identificação de dispositivo única da AppsFlyer é criada para cada nova instalação de um aplicativo. Use a seguinte API para obter a identificação única da AppsFlyer:

public String getAppsFlyerId();

Exemplo de uso:

string AppsFlyerUID = AppsFlyer.getAppsFlyerId();

Defina a identificação do usuário conforme usada pelo aplicativo. 

Para definir a identificação do usuário, chame o método a seguir:

AppsFlyer.setCustomerUserID("someId");

Para mais informações sobre ID de usuário cliente, clique 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.

Por padrão, o IMEI e o Android ID não são coletados pelo SDK se a versão do SO for superior à KitKat (4.4) e se o dispositivo tiver o Google Play Services (nas versões 4.16.4 ou anterior do SDK do Unity o aplicativo específico exigia GPS). 

Para explicitamente enviar essas IDs à AppsFlyer, os desenvolvedores podem usar as seguintes APIs:

AppsFlyer.setAndroidIdData(string)
AppsFlyer.setImeiData(string)

Se o aplicativo NÃO tiver o Google Play Services, o SDK coleta o IMEI e o Android ID. Contudo, aplicativos com Google Play Services devem evitar a coleta de IMEI, pois isso é uma violação da política do Google Play.

Os desenvolvedores podem cancelar a colera de IMEI e Android ID usando estas APIs:

AppsFlyer.setCollectAndroidID(bool) 
AppsFlyer.setCollectIMEI(bool)

A AppsFlyer coleta automaticamente o IDFA (identificador para anunciantes) e o IDFV (identificador para fornecedores) se o AdSupport.framework estiver incluído no aplicativo.

Para Desinstalação, siga as instruções conforme seu sistema operacional.

using Firebase.Messaging;
using Firebase.Unity;

Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;

public void OnTokenReceived
    (object sender, Firebase.Messaging.TokenReceivedEventArgs token) { 
        AppsFlyer.updateServerUninstallToken (token.Token);
    }

 <uses-permission android:name="android.permission.WAKE_LOCK" />
   <permission android:name="android.appsflyer.sampleapp.permission.C2D_MESSAGE"
       android:protectionLevel="signature" />
   <uses-permission android:name="android.appsflyer.sampleapp.permission.C2D_MESSAGE" />
   <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

<receiver
           android:name="com.google.android.gms.gcm.GcmReceiver"
           android:exported="true">
           <intent-filter>
               <action android:name="com.google.android.c2dm.intent.RECEIVE" />
           </intent-filter>
       </receiver>

AppsFlyer.setGCMProjectNumber("Your_GCM_Project_Number");

void Start () {
   // register to push notifications
       UnityEngine.iOS.NotificationServices.RegisterForNotifications(UnityEngine.iOS.NotificationType.Alert | UnityEngine.iOS.NotificationType.Badge | UnityEngine.iOS.NotificationType.Sound);
       Screen.orientation = ScreenOrientation.Portrait;
}   void Update () {
       if (!tokenSent) { // tokenSent needs to be defined somewhere (bool tokenSent = false)
           byte[] token = UnityEngine.iOS.NotificationServices.deviceToken;           
           if (token != null) {     
               AppsFlyer.registerUninstall (token);
               tokenSent = true;
           }
       }    
}

A AppsFlyer permite que você avalie notificações por push como parte de uma campanha de redirecionamento.

handlePushNotification(Dictionary<string, string> payload)

O payload de dados deve incluir um objeto: af com a string de chave-valor relevante:

Exemplo:

{  
   "data":{  
      "score":"5x1",
      "time":"15:10",
      "af":{  
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}

// with deep-linking
{
   "data":{
      "score":"5x1",
      "time":"15:10",
      "click_action":"com.example.someAction",
      "af":{
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}

Para realizar ações de cross-promotion com o SDK do Unity (ou qualquer outra plataforma não nativa) implemente o seguinte.

AFInAppEvents.CURRENCY

não for enviado como parte de um evento no aplicativo.

USD é o valor padrão. Você pode encontrar códigos de moeda ISO aceitáveis aqui.

Use a seguinte API para definir o código de moeda:

public void setCurrencyCode(String currencyCode);

Exemplo de uso:

setCurrencyCode(string currencyCode)

Para Validação do recebimento de compras no aplicativo, siga as instruções de acordo com seu sistema operacional.

//Para obter os callbacks
//AppsFlyer.createValidateInAppListener ("AppsFlyerTrackerCallbacks", 
"onInAppBillingSuccess", "onInAppBillingFailure");
AppsFlyer.validateReceipt(string publicKey, string purchaseData, 
string signature, string price, string currency, Dictionary additionalParametes);

AppsFlyer.createValidateInAppListener ("AppsFlyerTrackerCallbacks", "onInAppBillingSuccess", "onInAppBillingFailure");

AppsFlyer.setIsSandbox(true);
AppsFlyer.validateReceipt(string productIdentifier, string price, string currency,
string transactionId, Dictionary additionalParametes);

A resposta de compra validada é acionada na classe AppsFlyerTrackerCallbacks.cs

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 setDeviceTrackingDisabled(boolean isDisabled);

Exemplo de uso:

AppsFlyer.setDeviceTrackingDisabled(true);

Atualmente indisponível no Unity.

Para acompanhar instalações fora do Google Play, defina o canal/loja no AndroidManifest.xml do aplicativo com um único canal ou qualquer nome de loja para cada APK. O valor do CANAL diferencia maiúsculas de minúsculas.

Exemplos:

<meta-data android:name="CHANNEL" android:value="Amazon" />
<meta-data android:name="CHANNEL" android:value="Standalone"/>
<meta-data android:name="CHANNEL" android:value="Verizon" />

Coloque a tag de meta-dados antes da tag </application>.

Para mais detalhes sobre como acompanhar as instalações para aplicativos fora da loja, leia aqui.

Em alguns casos extremos você pode querer encerrar todos os acompanhamentos do SDK devido à conformidade legal e de privacidade. Você pode fazer isso com a API isStopTracking. Após a execução desta API, nosso SDK não se comunicará mais com nossos servidores e deixará de enviar informações para a AppsFlyer.

AppsFlyer.stopTracking(true);

Em qualquer evento, o SDK pode ser reativado chamando a mesma API, mas passando o valor "false".

A API setAdditionalData é necessária para integrar-se ao nível do SDK com várias plataformas externas, incluindo Segment, Adobe e Urban Airship. Use esta API somente se o artigo de integração da plataforma afirmar especificamente que a API setAdditionalData é necessária. Veja a seguir um exemplo de código para a implementação do setAdditionalData no Unity:

>Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("custom_param_1", "value_of_param_1");

AppsFlyer.setAdditionalData(CustomDataMap);