Dados de conversão
Neste guia, você aprenderá como obter dados de conversão usando o SDK do iOS, além de exemplos de uso.
Antes de começar
A obtenção de dados de conversão requer que você primeiro integre o SDK.
Obtendo dados de conversão no SDK do iOS
#import "AppDelegate.h"
#import <AppsFlyerLib/AppsFlyerLib.h>
@interface AppDelegate ()
@end
@implementation AppDelegate
// ...
-(void)onConversionDataSuccess:(NSDictionary*) installData {
// Invoked when conversion data resolution succeeds
}
-(void)onConversionDataFail:(NSError *) error {
// Invoked when conversion data resolution fails
NSLog(@"%@",error);
}
// ...
@end
import UIKit
import AppsFlyerLib
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate {
// ...
func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
// Invoked when conversion data resolution succeeds
}
func onConversionDataFail(_ error: Error!) {
// Invoked when conversion data resolution fails
}
// ...
}
onConversionDataSuccess
onConversionDataSuccess
is implemented in AppsFlyerLibDelegate
.
The onConversionDataSuccess
method is invoked whenever:
- Um usuário abre o aplicativo
- Um usuário move o aplicativo para o primeiro plano
When invoked, onConversionDataSuccess
returns a NSDictionary
(called installData
in the example) that contains attribution data for that install. installData
is cached the first time onConversionDataSuccess
is called and will be identical on consecutive calls.
onConversionDataFail
onConversionDataFail
is implemented in AppsFlyerLibDelegate
.
If for whatever reason the SDK fails to fetch the conversion data, onConversionDataFail
is invoked.
Acessando dados de atribuição
You can get the conversion type by checking the value of af_status
in onConversionDataSuccess
's payload. It can be one of the following values:
Organic
Non-organic
Exemplo
Veja a seguir um exemplo de implementação:
#import "AppDelegate.h"
#import <AppsFlyerLib/AppsFlyerLib.h>
#import <UserNotifications/UserNotifications.h>
@interface AppDelegate ()
@end
@implementation AppDelegate
// ...
-(void)onConversionDataSuccess:(NSDictionary*) installData {
// Business logic for Non-organic install scenario is invoked
id status = [installData objectForKey:@"af_status"];
if([status isEqualToString:@"Non-organic"]) {
id sourceID = [installData objectForKey:@"media_source"];
id campaign = [installData objectForKey:@"campaign"];
NSLog(@"This is a Non-organic install. Media source: %@ Campaign: %@",sourceID,campaign);
}
else if([status isEqualToString:@"Organic"]) {
// Business logic for Organic install scenario is invoked
NSLog(@"This is an Organic install.");
}
}
-(void)onConversionDataFail:(NSError *) error {
NSLog(@"%@",error);
}
// ...
@end
import UIKit
import AppsFlyerLib
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate {
// ...
func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
if let status = installData["af_status"] as? String {
if (status == "Non-organic") {
// Business logic for Non-organic install scenario is invoked
if let sourceID = installData["media_source"],
let campaign = installData["campaign"] {
print("This is a Non-organic install. Media source: \(sourceID) Campaign: \(campaign)")
}
}
else {
// Business logic for organic install scenario is invoked
}
}
}
func onConversionDataFail(_ error: Error!) {
// Logic for when conversion data resolution fails
if let err = error{
print(err)
}
}
}
Deferred deep linking (método herdado)
When the app is opened via deferred deep linking, onConversionDataSuccess
's payload returns deep linking data, as well as attribution data.
- A prática recomendada é implementar deep links com Unified Deep Linking (UDL)
- For existing clients and reference, here is our legacy iOS deep linking guide, using
onConversionDataSuccess
.
Atualizado 7 meses atrás