Introdução
O AppsFlyer permite que você acesse os dados de atribuição do usuário em tempo real, diretamente no nível do SDK. Ele possibilita que você personalize as páginas de destino que um usuário vê quando o aplicativo abre pela primeira vez após uma nova instalação do aplicativo. Isso normalmente é chamado de vinculação profunda "adiada". É muito comum na web, contudo, é um grande desafio fazer isso no ecossistema do aplicativo móvel. Felizmente, o AppsFlyer oferece suporte para todos os casos e plataformas.
Importante!
Para executar links diretos adiados, seu aplicativo deve oferecer suporte a esquemas de URI, links de aplicativo (Android) ou links universais (iOS). Consulte Configuração de links diretos para saber mais.
Enviar um novo usuário do aplicativo para vinculação profunda na instalação é muito semelhante a usar o Esquema do URL personalizado para vinculação profunda (iOS, Android) para usuários que já instalaram o seu aplicativo.
Exemplo
Considere um usuário que acabou de clicar no anúncio do HotelTonight no Google Adwords para uma busca de "Hotéis em Nova York". Primeiro o usuário é enviado para o Google Play/loja de aplicativos para fazer download do aplicativo e, após o aplicativo abrir pela primeira vez, o usuário vai diretamente para a página de Hotéis em Nova York. Acessando os dados de atribuição fornecidos pelo AppsFlyer, o aplicativo recebe a campanha exata e palavras-chaves utilizadas para guiar esse usuário/instalação.
Além da experiência aprimorada e da conversão otimizada, isso habilita funcionalmente campanhas sofisticadas baseadas em contexto, como fornecer ao usuário um crédito/bônus por instalar e usar o aplicativo. Por exemplo: em vez de campanhas Clique para instalar para Instale e ganhe $50 de crédito para reservas. Essas campanhas não só melhoram a conversão de clique em instalação, mas também melhoram a conversão em usuários pagantes. Essas campanhas podem melhorar o ROI geral em 2X-5X!
O SDK da AppsFlyer é responsável por permitir o acesso aos dados de atribuição de dentro do aplicativo. Na primeira inicialização do aplicativo, o acesso aos dados de atribuição do SDK da AppsFlyer pode demorar alguns segundos. Nas sessões seguintes, o acesso é imediato, pois os dados de atribuição são armazenados no dispositivo.
Observações
- De acordo com a política de privacidade do Facebook, a AppsFlyer (ou qualquer outro parceiro de métrica mobile de terceiros) não pode fornecer atribuição no nível de usuário para as instalações do Facebook, a menos que você aceite os Termos de Serviço do Facebook. Mais informações aqui.
Se você optar por não aceitar os termos de serviço, as instalações do Facebook Mobile Ads serão categorizadas como "Orgânicas" e você não poderá receber os dados de nível de usuário para as instalações do Facebook.
Acessar os dados de atribuição para implementar links diretos adiados se aplica à primeira inicialização do usuário após a instalação. Para implementar links diretos para usuários que já possuem o aplicativo instalado, consulte aqui. - Os dados de conversão não são a API de dados ideal para armazenar dados brutos de usuários em seu back-end.
Clique aqui para obter informações sobre como selecionar as melhores APIs de dados para você
Implementação do SDK
Observação
Suporte de AF Android SDK 2.3.1.6 e AF iOS SDK 2.5.3.8 e superior.
OnInstallConversionDataLoaded tem os dados de atribuição da instalação. Você pode usar essa função para:
- Vinculação profunda adiada – personalize a página de destino do seu aplicativo para o usuário que tiver entrado no aplicativo pela primeira vez.
- Obter dados de atribuição de instalação para diferentes eventos durante a vida do usuário dentro do seu aplicativo
Exemplo
Um usuário faz download e inicia o aplicativo pela primeira vez após ver seu anúncio de sapatos vermelhos no Facebook. Para enviar o usuário diretamente para a página dos sapatos vermelhos em seu aplicativo, use OnInstallConversionDataLoaded
Para acessar os dados de conversão do AppsFlyer a partir do SDK do Android, implemente o ConversionDataListener:
public interface AppsFlyerConversionListener {
void onInstallConversionDataLoaded(Map<String,String> conversionData);
void onInstallConversionFailure(String errorMessage);
}
O delegado abaixo é usado se você quiser acessar os dados de conversão do AppsFlyer a partir do SDK.
(void) onConversionDataReceived:(NSDictionary*) installData;onConversionDataReceived tem os dados de atribuição da instalação. Você pode usar essa função para:
- Vinculação profunda adiada – personalizar a página de destino do seu aplicativo para um usuário que estiver abrindo o aplicativo pela primeira vez.
- Obter dados de atribuição de instalação para diferentes eventos durante a vida do usuário dentro do seu aplicativo
onConversionDataReceived tem os dados de atribuição da instalação. Você pode usar essa função para:
- Vinculação profunda adiada – personalize a página de destino do seu aplicativo para o usuário que tiver entrado no aplicativo pela primeira vez.
- Obter dados de atribuição de instalação para diferentes eventos durante a vida do usuário dentro do seu aplicativo
Exemplo
Um usuário faz download e inicia o aplicativo pela primeira vez após ver seu anúncio de sapatos vermelhos no Facebook. Para enviar o usuário diretamente para a página dos sapatos vermelhos em seu aplicativo, use OnInstallConversionDataLoaded
Para acessar os dados de conversão do AppsFlyer a partir do SDK do Android, implemente o ConversionDataListener:
didReceiveConversionData(string conversionData);
Amostras de Código
São apresentadas abaixo diferentes amostras de código para Android e iOS.
@Override
public void onCreate(){
super.onCreate();
/** Set Up Conversion Listener to get attribution data **/
AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {
/* Returns the attribution data. Note - the same conversion data is returned every time per install */
@Override
public void onInstallConversionDataLoaded(Map<String, String> conversionData) {
for (String attrName : conversionData.keySet()) {
Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
}
setInstallData(conversionData);
}
@Override
public void onInstallConversionFailure(String errorMessage) {
Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
}
/* Called only when a Deep Link is opened */
@Override
public void onAppOpenAttribution(Map<String, String> conversionData) {
for (String attrName : conversionData.keySet()) {
Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
}
}
@Override
public void onAttributionFailure(String errorMessage) {
Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
}
};
/* This API enables AppsFlyer to detect installations, sessions, and updates. */
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , this);
AppsFlyerLib.getInstance().startTracking(this, AF_DEV_KEY);
Dica
Se você não precisar dos dados de conversão, você pode simplesmente enviar null no método init:
AppsFlyerLib.getInstance().init(AF_DEV_KEY, null, this);#import "AppsFlyerTracker.h"
@interface AppDelegate : UIResponder<UIApplicationDelegate, AppsFlyerTrackerDelegate> {
...
}
- (BOOL)application:(UIApplication ?*)application didFinishLaunchingWithOptions:(NSDictionary*?)launchOptions {
[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"[MY_DEV_KEY]";
[AppsFlyerTracker sharedTracker].appleAppID = @"123456789";
// Load conversion and deep link data
[AppsFlyerTracker sharedTracker].delegate = self;
return YES;
}
-(void)applicationDidBecomeActive:(UIApplication *)application
{
[[AppsFlyerTracker sharedTracker] trackAppLaunch];
}
-(void)onConversionDataReceived:(NSDictionary*) installData {
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 none organic install. Media source: %@ Campaign: %@",sourceID,campaign);
} else if([status isEqualToString:@"Organic"]) {
NSLog(@"This is an organic install.");
}
}
-(void)onConversionDataRequestFailure:(NSError *) error {
NSLog(@"%@",error);
}
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerTrackerDelegate{
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
AppsFlyerTracker.shared().appsFlyerDevKey = "MY_DEV_KEY"
AppsFlyerTracker.shared().appleAppID = "123456789"
AppsFlyerTracker.shared().delegate = self
//AppsFlyerTracker.shared().isDebug = true
//AppsFlyerTracker.shared().appInviteOneLinkID = "ONELINK_ID";
return true
}
func applicationDidBecomeActive(_ application: UIApplication) {
AppsFlyerTracker.shared().trackAppLaunch()
}
func onConversionDataReceived(_ installData: [AnyHashable: Any]) {
guard let first_launch_flag = installData["is_first_launch"] as? Int else {
return
}
guard let status = installData["af_status"] as? String else {
return
}
if(first_launch_flag == 1) {
if(status == "Non-organic") {
if let media_source = installData["media_source"] , let campaign = installData["campaign"]{
print("This is a Non-Organic install. Media source: \(media_source) Campaign: \(campaign)")
}
} else {
print("This is an organic install.")
}
} else {
print("Not First Launch")
}
}
func onConversionDataRequestFailure(_ error: Error!) {
if let err = error{
print(err)
}
}
func onAppOpenAttribution(_ attributionData: [AnyHashable : Any]!) {
if let data = attributionData{
print("\(data)")
}
}
func onAppOpenAttributionFailure(_ error: Error!) {
if let err = error{
print(err)
}
}No AF GameObject dentro do método Start:
#if UNITY_IOS
/* Mandatory - set your iOS app ID */
AppsFlyer.setAppID("123456789");
/* Call getConversionData() to get the conversion data in iOS*/
AppsFlyer.getConversionData();
AppsFlyer.trackAppLaunch();
#elif UNITY_ANDROID
/* Mandatory - set your Android package name */
AppsFlyer.setAppID ("com.company.app");
/* For getting the conversion data in Android, you need to add the "AppsFlyerTrackerCallbacks" listener.*/
AppsFlyer.init ("AF_DEY_KEY","AppsFlyerTrackerCallbacks");
#endifImplemente sua lógica no método didReceiveConversionData dentro da classe AppsFlyerTrackerCallbacks:
public class AppsFlyerTrackerCallbacks : MonoBehaviour {
public Text callbacks;
// Use this for initialization
void Start () {
print ("AppsFlyerTrackerCallbacks on Start");
}
public void didReceiveConversionData(string conversionData) {
print("AppsFlyerTrackerCallbacks:: got conversion data = " + conversionData);
}
public void didReceiveConversionDataWithError(string error) {
print ("AppsFlyerTrackerCallbacks:: got conversion data error = " + error);
}
public void didFinishValidateReceipt(string validateResult) {
print ("AppsFlyerTrackerCallbacks:: got didFinishValidateReceipt = " + validateResult);
}
public void didFinishValidateReceiptWithError (string error) {
print ("AppsFlyerTrackerCallbacks:: got idFinishValidateReceiptWithError error = " + error);
}
public void onAppOpenAttribution(string validateResult) {
print ("AppsFlyerTrackerCallbacks:: got onAppOpenAttribution = " + validateResult);
}
public void onAppOpenAttributionFailure (string error) {
print ("AppsFlyerTrackerCallbacks:: got onAppOpenAttributionFailure error = " + error);
}
public void onInAppBillingSuccess () {
print ("AppsFlyerTrackerCallbacks:: got onInAppBillingSuccess succcess");
}
public void onInAppBillingFailure (string error) {
print ("AppsFlyerTrackerCallbacks:: got onInAppBillingFailure error = " + error);
}
void printCallback(string str) {
callbacks.text += str + "\n";
}
}
{
"af_status": "Non-organic",
"media_source": "tapjoy_int",
"campaign": "July4-Campaign",
"agency": "starcomm",
"af_siteid": null,
"af_sub1": "subtext1",
"af_sub2": null,
"af_sub3": null,
"af_sub4": null,
"af_sub5": null,
"freehand-param": "somevalue",
"click_time": "2014-05-23 20:11:31",
"install_time": "2014-05-23 20:12:16.751"
}Primeira Inicialização.
Os dados de conversão são enviados pelos servidores do AppsFlyer, em tempo real, para o aplicativo recém instalado após a primeira inicialização. Em seguida, o SDK armazena esses dados na memória cache do aplicativo (preferência compartilhada ou userDefault).
Com qualquer inicialização subsequente do aplicativo, o SDK do AppsFlyer lê os dados de conversão armazenados no cache e não consulta os servidores do AppsFlyer. Portanto, os dados de conversão SEMPRE retornam os mesmos valores, seja na primeira inicialização ou não.
Para ajudar os desenvolvedores a usarem os dados de conversão somente na primeira inicialização, a AppsFlyer adicionou um parâmetro chamado is_first_launch na resposta de dados de conversão. is_first_launch é true (YES em Objective-C) na primeira inicialização do aplicativo e false (NO em Objective-C) depois. Está disponível nos SDKs do Android (a partir do SDK versão 4.8.4) e do iOS (a partir do SDK versão 4.8.2).
Se quiser realizar a vinculação profunda adiada somente na primeira inicialização, faça isso depois de verificar se is_first_launch é verdadeiro.
Observação
Considerando que os dados de conversão estão armazenados na memória compartilhada do aplicativo, os usuários podem excluí-los se limparem os dados do aplicativo. Isso faz com que is_first_launch se torne verdadeiro novamente. Portanto, as inicializações seguintes, após a exclusão dos dados do aplicativo, são tratadas como primeiras instalações.
Chaves Disponíveis na Resposta de Atribuição
Os dados de conversão retornados consistem de TODOS os parâmetros no link de atribuição original e alguns parâmetros de servidor adicionais criados no momento do clique ou da instalação.
Considerando que os dados de conversão se baseiam no link de atribuição, significa que fontes e links de atribuição diferentes podem produzir parâmetros de dados de conversão diferentes.
A função a seguir é chamada toda vez que o aplicativo é iniciado:
onInstallConversionDataLoaded para Android
onConversionDataReceived para iOS
Existem três resultados possíveis, dependendo do tipo da instalação:
- Instalações não orgânicas
- Retorna os dados de atribuição originais da instalação (veja os exemplos abaixo).
- Instalação orgânica
- (ou re-instalação) Retorna "instalação orgânica"
- Reatribuição
- Retorna os detalhes de conversão da reatribuição.
Explicações dos Nomes das Chaves
| Nome da chave | Explicação | Valores de exemplo | das fontes de mídia |
|---|---|---|---|
|
af_status |
Mostra que tipo de atribuição foi detectada. Valores válidos:
|
Não orgânica |
Tudo |
|
af_message |
Texto livre |
Instalação orgânica/mensagem de erro |
Tudo |
|
media_source |
Nome da fonte de mídia. Esse é o parâmetro "pid" do link de atribuição AF |
ObservaçãoFontes de instalação oriundas de agência estão ocultas e possuem valor "nulo". |
Tudo
|
|
campaign |
Nome da campanha (parâmetro "c" do link de atribuição da AppsFlyer ou nome da campanha do Facebook) |
Ad1/camp123 |
Tudo |
|
clickid |
Id do clique ou id da transação |
123456/xsfd234 |
Tudo |
|
af_siteid |
Id do site (para otimização) |
Site1 |
Tudo |
|
af_sub1 |
Parâmetro extra |
someParameter |
Tudo |
|
af_sub2 |
Parâmetro extra |
|
Tudo |
|
af_sub3 |
Parâmetro extra |
|
Tudo |
|
af_sub4 |
Parâmetro extra |
|
Tudo |
|
af_sub5 |
Parâmetro extra |
|
Tudo |
|
af_keywords |
Palavras-chaves pesquisadas nas campanhas de busca. Ou seja, Campanhas do Google Search |
Tudo |
|
|
click_time |
Data e hora (milissegundos) do clique |
2014-01-08 00:07:53.233 |
Tudo |
|
install_time |
Data e hora (milissegundos) da conversão |
2014-01-08 00:12:51.701 |
Tudo |
|
agency |
Agência ou PMD que gera a instalação |
nanigans |
Tudo |
|
is_first_launch |
verdadeiro para a primeira inicialização e falso depois |
true |
Tudo |
|
is_fb
|
Sinalizador indicando que é uma atribuição do Facebook. Valores: verdadeiro/falso |
true |
|
|
ad_id |
Número de identificação exclusiva do Facebook de um anúncio |
6012740800279 |
|
|
campaign_id |
ID da campanha no Facebook |
6012700005123 |
|
|
adset |
Nome do conjunto de anúncios no Facebook |
US – 18+ |
|
|
adset_id |
ID do conjunto de anúncios no Facebook |
6099800005123 |
|
|
orig_cost |
O valor de custo da instalação (pode ser em qualquer moeda) |
1.5 |
Tudo |
|
cost_cents_USD |
O valor de custo em Cêntimos dos EUA após a conversão de moeda |
150 (Cêntimos) |
Tudo |
Observação
Para integrações de links de atribuição (redes que não são de autorrelatório), todos os parâmetros de URL que aparecem no link de atribuição são retornados no GCD.
Exemplo de instalação do link de atribuição da AppsFlyer regular
Uma instalação gerada usando o seguinte link de atribuição:
http://app.appsflyer.com/com.greatapp?pid=network_int&c=network_TH&af_ad=ad_name&af_sub1=102619
&af_sub2=network_TH_G001_Android&af_dp=app%3A%2F%2Fhome&af_prt=expertagency
&af_siteid=1777215&af_sub_siteid=1702&freehand-param=somevalue&tag={TAGID}
&clickid={CLICKID}&af_click_lookback=1d
http://app.appsflyer.com/id123456789?pid=network_int&c=network_KR&af_ad=ad_name&af_sub1=CD48704_
&af_sub2=network_KR_G001_iOS&af_dp=app%3A%2F%2Fhome&af_prt=expertagency&
af_siteid=1777236&af_sub_siteid=1702&freehand-param=somevalue&tag={TAGID}
&clickid={CLICKID}&af_click_lookback=1d
produz o seguinte
Resposta de Dados de Conversão
{
"media_source":"network_int",
"campaign":"network_TH",
"adset":null,
"clickid":"fb7f51d42-2621-93bd-e9a1b24f1acfab7b76e5104706104f4d6*******",
"adgroup":null,
"campaign_id":null,
"af_cost_currency":"USD",
"af_status":"Non-organic",
"af_sub_siteid":"1702",
"agency":"expertagency",
"af_sub3":null,
"af_cost_model":"CPI",
"af_siteid":"1777215",
"af_ad" = "ad_name",
"af_dp":"app://home",
"adset_id":null,
"click_time":"2017-07-19 08:30:31.890",
"cost_cents_USD":"150",
"iscache":true,
"is_first_launch":true,
"af_cpi":null,
"af_sub1":"102619",
"af_cost_value":"1.5",
"af_click_lookback":"1d",
"af_sub4":null,
"site_id":"1777215",
"adgroup_id":null,
"tag":"8d55089f-31b6-407b-9266-*********",
"orig_cost":"1.5",
"af_prt":"expertagency",
"af_sub5":null,
"install_time":"2017-07-19 08:30:35.461",
"af_sub2":"network_TH_G001_Android",
"freehand-param":"somevalue"
}
{
"media_source":"network_int",
"campaign":"network_KR",
"adset":null,
"adgroup":null,
"campaign_id":null,
"af_cost_currency":"USD",
"af_status":"Non-organic",
"agency":"expertagency",
"af_sub3":null,
"af_cost_model":"CPI",
"af_siteid":"1777236",
"af_ad" = "ad_name",
"af_dp":"app://home",
"adset_id":null,
"click_time":"2017-07-18 14:48:42.896",
"cost_cents_USD":"0",
"iscache":true,
"is_first_launch":1,
"af_cpi":null,
"af_sub1":"CD48704_",
"af_click_lookback":"1d",
"af_sub4":null,
"site_id":"1777236",
"adgroup_id":null,
"tag":"43fafd60-76ad-4a8f-9d1d-************",
"orig_cost":"0.0",
"af_prt":"expertagency",
"af_sub5":null,
"install_time":"2017-07-18 15:09:06.014",
"af_sub2":"network_KR_G001_iOS",
"clickID":"3gggBgAw2Bvxa8gR56ZA8Y3qjUy2gPkFgP6rA96s4e*******",
"freehand-param":"somevalue"
}Observação
A ordem das chaves pode variar. Chaves adicionais podem ser adicionadas sem aviso.
Exemplo de Instalação no Facebook
Observação
Não há nenhum link de atribuição para campanhas do Facebook.
Os parâmetros de link direto definidos nas campanhas do Facebook não estão disponíveis fora do Facebook. Isso inclui o parâmetro af_dp, que contém o caminho do esquema no aplicativo. Portanto, para implementar links diretos adiados, lógica adicional deve ser aplicada para campanhas do Facebook. Use os dados do Facebook na resposta getConversionData, como campaign, adset, adgroup etc., para redirecionar de forma programática os seus usuários.
Resposta de Dados de Conversão
{
"adset":"T:DAT-Desktop_O:All_L:AR-AE_A:All_R:1-30 Day",
"adgroup":"T:DAT-Desktop_O:All_L:AR-AE_A:All_R:1-30 Day",
"campaign_id":"6068535534218",
"af_status":"Non-organic",
"agency":null,
"af_sub3":null,
"af_siteid":null,
"adset_id":"6073532011618",
"is_fb":true,
"is_first_launch":true,
"click_time":"2017-07-18 12:55:05",
"iscache":false,
"ad_id":"6074245540018",
"af_sub1":null,
"campaign":"T:DAT_L:AR-AE",
"is_paid":true,
"af_sub4":null,
"adgroup_id":"6073532011418",
"is_mobile_data_terms_signed":true,
"af_channel":"Facebook",
"af_sub5":null,
"media_source":"Facebook Ads",
"install_time":"2017-07-19 08:06:56.189",
"af_sub2":null
}
{
"media_source":"Facebook Ads",
"campaign":"T:App Install_A:ALL",
"adset":"T:App Install_M:iOS_O:ALL_L:DE-DE_A:ALL",
"adgroup":"T:App Install_M:iOS_O:ALL_L:DE-DE_A:ALL_Banne",
"campaign_id":"6074766693717",
"af_status":"Non-organic",
"agency":null,
"af_sub3":null,
"af_siteid":null,
"adset_id":"6074767207317",
"is_fb":true,
"is_first_launch":true,
"click_time":"2017-07-17 16:23:18",
"iscache":false,
"ad_id":"6078076656717",
"af_sub1":null,
"is_paid":true,
"af_sub4":null,
"adgroup_id":"6074821181517",
"is_mobile_data_terms_signed":true,
"af_channel":"Facebook",
"af_sub5":null,
"install_time":"2017-07-18 15:10:50.190",
"af_sub2":null
}
Vinculação profunda adiada com SRNs
O AppsFlyer sempre recebe os dados de conversão e os disponibiliza para o aplicativo quando iniciado pela primeira vez.
Usuários novos que instalarem após clicar em uma campanha de vinculação profunda/de redirecionamento em uma SRN podem ser redirecionados dentro do aplicativo após a inicialização, usando os dados de conversão.
Contudo, com as SRNs, os parâmetros de vinculação profunda regulares do AppsFlyer, como af_dp, não estão presentes como parte dos dados de vinculação profunda.
Para usar esses dados dentro do aplicativo, o desenvolvedor precisa empregar lógica adicional com base nos parâmetros disponíveis, como campanha, nomes do conjunto de anúncios ou de anúncios únicos.
Exemplo
Jill, comerciante de celulares da greatapp, decide realizar uma campanha de links diretos no Facebook, direcionada ao público geral.
A campanha redireciona quaisquer usuários que clicarem para uma atividade "bônus".
Jack, o desenvolvedor de celulares, adiciona essa lógica após obter os dados de conversão:
1. Tem origem no Facebook ("is_fb=true")?
2. Se verdadeiro, obtenha o valor do parâmetro do grupo de anúncios.
3. Se o valor contém a palavra "bonus", envie o usuário para a atividade "bônus".
Usando métodos do Facebook, usuários existentes que clicarem no anúncio são redirecionados para a atividade diretamente, enquanto os novos usuários obtêm a mesma experiência usando os dados de conversão da AppsFlyer.