Integração do SDK da AppsFlyer - iOS

A identificação de dispositivo única da AppsFlyer é criada para cada nova instalação de um aplicativo. É possível obtê-la utilizando o código a seguir:

let appsflyerId = AppsFlyerTracker.shared().getAppsFlyerUID()

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

Definir sua própria identificação de cliente lhe permite fazer uma referência cruzada da sua própria identificação única com a identificação única da AppsFlyer e com as identificações de outros dispositivos. Essa identificação está disponível nos relatórios CSV da AppsFlyer junto com as APIs de postback para referência cruzada com suas identificações internas.

Para definir sua identificação de usuário cliente:

AppsFlyerTracker.shared().customerUserID = "my user id"

[AppsFlyerTracker sharedTracker].customerUserID = @"my user id";

Obtenção de ID de usuário cliente:

To avoid setting the customer user ID value again beyond the first launch you can check if its value is empty or not by using: 

[AppsFlyerTracker sharedTracker].customerUserID

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

A AppsFlyer lhe permite informar um ou mais endereços de e-mail de usuários se você os coletar em seu aplicativo. Os valores de e-mail podem ser criptografados seguindo os métodos de criptografia: Sha1, MD5 e simples.

Exemplo: coleta de e-mail do usuário

AppsFlyerTracker.shared().setUserEmails( ["email1@domain.com", "email2@domain.com"], 
with: EmailCryptTypeSHA1)

[[AppsFlyerTracker sharedTracker] setUserEmails:@[@"email1@domain.com", @"email2@domain.com"] 
withCryptType:EmailCryptTypeSHA1];

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

Para o Acompanhamento de desinstalações, ative as notificações remotas por push em seu aplicativo. Consulte o Guia de programação de notificação remota da Apple para mais detalhes.

Siga as instruções de integração do SDK do iOS para concluir a configuração do recurso de desinstalação.

Para ativar o acompanhamento de inicializações de aplicativos em notificações por push, adicione o código a seguir à delegação do seu aplicativo:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
	AppsFlyerTracker.shared().handlePushNotification(userInfo)
}

-(void) application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
	[[AppsFlyerTracker sharedTracker] handlePushNotification:userInfo];
    }

A mensagem por push deve ter um parâmetro af com os parâmetros de acompanhamento da AppsFlyer.

Exemplo de mensagem:}

{
   "aps":{
      "alert":"Push text",
      "sound":"default",
      "category":"REMINDER_CATEGORY"
   },
   "_p":123456,
   "payloadKey":"payloadValue",
   "af":{
      "pid":"swrve_int",
      "is_retargeting":"true",
      "c":"test_campaign"
   }
}

A AppsFlyer permite que você acompanhe e atribua instalações originadas de uma promoção cruzada de um de seus aplicativos dentro do aplicativo atual do usuário.  Aplicativos de promoções cruzadas podem ser um importante fator de crescimento para impulsionar novas instalações para seus aplicativos.

Para mais detalhes, consulte o artigo Acompanhamento de promoções cruzadas aqui.

O SDK da AppsFlyer pode oferecer verificação do servidor de compras no aplicativo. Para configurar o acompanhamento de validação de recebimento, é necessário chamar o método validateAndTrackInAppPurchase dentro do SKStoreKit’s completeTransaction: retorno de chamada. Essa chamada automaticamente gera um evento af_purchase no aplicativo.

- (void) validateAndTrackInAppPurchase:(NSString *) productIdentifier
price:(NSString *) price
currency:(NSString *) currency
transactionId:(NSString *) tranactionId
additionalParameters:(NSDictionary *) params
success:(void (^)(NSDictionary *response)) successBlock
failure:(void (^)(NSError *error, id reponse)) failedBlock;

Essa chamada tem dois blocos de callback: um para "sucesso" e outro para "falha" (por qualquer motivo, incluindo falha na validação). Em caso de sucesso, um dicionário é retornado com os dados de validação do recebimento fornecidos pelos servidores da Apple. 

#ifdef DEBUG
    [AppsFlyerTracker sharedTracker].useReceiptValidationSandbox = YES;
#endif

[[AppsFlyerTracker sharedTracker] validateAndTrackInAppPurchase:product.productIdentifier price:product.price.stringValue
currency:@"USD"
transactionId:trans.transactionIdentifier
additionalParameters:@{@"test": @"val" , @"test1" : @"val 1"}
success:^(NSDictionary *result){
  NSLog(@"Purchase succeeded And verified!!! response: %@", result[@"receipt"]);
} failure:^(NSError *error, id response) {
  NSLog(@"response = %@", response);
}];

AppsFlyerTracker.shared().validateAndTrack(inAppPurchase:  product.productIdentifier, price: "\(product.price)", currency:  product.priceLocale.currencyCode, transactionId:  trans.transactionIdentifier, additionalParameters: nil,success:{(result) in
   print("Purchase succeeded And verified!!! response \(result)")
   },failure:{(error,message) in
   print("response = \(message)")
   })

Para uma lista dos possíveis valores de retorno para validação dos recebimentos, consulte a documentação da Apple aqui.

A AppsFlyer fornece um método para anonimizar identificadores de usuários específicos em suas análises. Esse método está em conformidade com os requisitos de privacidade mais recentes e cumpre as políticas de privacidade e dados do Facebook. O padrão é NÃO, ou seja, a anonimização não está habilitada por padrão.

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

AppsFlyerTracker.shared().deviceTrackingDisabled = true

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

O acompanhamento pode ser reiniciado ao chamar deviceTrackingDisabled novamente definido como falso.

By default, at least 5 seconds must lapse between 2 app launches to count as separate 2 sessions (more about counting sessions). 
However, you can use the following API to set your custom value for the minimum required time between sessions:

AppsFlyerTracker.shared().minTimeBetweenSessions = <your_custom_time_in_seconds>

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <your_custom_time_in_seconds>;

A extensão do aplicativo exige permissões para usar a Internet:

1. Acesse o arquivo info.plist da extensão do seu aplicativo.
2. Em NSExtension / NSExtensionAttributes defina o sinalizador RequestsOpenAccess para SIM.

Adicione o código a seguir ao UIViewController viewDidLoad da extensão do aplicativo:

override func viewDidLoad() {    
        super.viewDidLoad()
        AppsFlyerTracker.shared().appsFlyerDevKey = "MY_APPSFLYER_KEY"

        // MY_APP_ID below stands for you app ID on iTunes Connect. Should be 9 or 10 digits.
        AppsFlyerTracker.shared().appleAppID = "MY_APP_ID"
                
        AppsFlyerTracker.sharedTracker().trackAppLaunch()
    }

- (void)viewDidLoad {
        [super viewDidLoad];
        // Replace MY_APPSFLYER_KEY below by your AppsFlyer dev key
        [AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"MY_APPSFLYER_KEY";

        // MY_APP_ID below stands for you app ID on iTunes Connect. Should be 9 or 10 digits.
        [AppsFlyerTracker sharedTracker].appleAppID = @"MY_APP_ID";
                
        [[AppsFlyerTracker sharedTracker] trackAppLaunch];
    }

In some extreme cases you might want to shut down all SDK tracking due to legal and privacy compliance. This can be achieved with the isStopTracking API. Once this API is invoked, our SDK no longer communicates with our servers and stops functioning.

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.

AppsFlyerTracker.shared().isStopTracking = true

[AppsFlyerTracker sharedTracker].isStopTracking = true;

O SDK da AppsFlyer permite que você colete o nome do dispositivo para análise interna. Por padrão, este recurso está desativado. Para ativá-lo, use a seguinte API:

>AppsFlyerTracker.shared().shouldCollectDeviceName = false`

[AppsFlyerTracker sharedTracker].shouldCollectDeviceName = NO;

A APIsetAdditionalData é 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 iOS para Objective-C ou Swift

NSDictionary* CustomDataMap = [[NSDictionary alloc] initWithObjectsAndKeys:@"value_of_param_1", @"custom_param_1", nil];
    
[[AppsFlyerTracker sharedTracker] setAdditionalData:CustomDataMap];

let CustomDataMap: [AnyHashable: Any] = [
   "custom_param_1" : "value_of_param_1"
]
        
AppsFlyerTracker.shared().customData = CustomDataMap