Visão geral: Envie dados para o SDK do Adobe Launch e o SDK da AppsFlyer com a implementação única da extensão do SDK do Adobe Launch da AppsFlyer.
Visão geral
O SDK do Adobe Launch é parte integrante da Adobe Experience Platform. O Adobe Experience Platform ajuda as empresas a reunir, consolidar e analisar dados de várias aplicações e plataformas. Permite aos proprietários de empresas e programadores compreender melhor o comportamento dos clientes para otimizar a experiência e o fornecimento de conteúdos. Se seu aplicativo implementar o SDK do Adobe Launch e o SDK da AppsFlyer, será possível enviar dados para ambos com uma única implementação da extensão do SDK do Adobe Launch da AppsFlyer. Isso reduz a complexidade global do seu processo de desenvolvimento e contribui para uma base de código mais limpa e de fácil manutenção.
Importante!
Se estiver usando a extensão do Adobe Launch, não é necessária a integração padrão do Adobe Analytics.
Pré-requisitos
São necessárias algumas coisas antes de integrar a extensão Adobe SDK da AppsFlyer.
Recupere a sua chave do desenvolvedor da AppsFlyer
- No painel do seu aplicativo, clique em Configurações do aplicativo abaixo de Configurações no menu à esquerda.
- Em Instalação do SDK, copie chave do desenvolvedor.
Obtenha seu ID do aplicativo
- Para Android: o ID da aplicação é o nome do pacote, por exemplo, exemplo.com.app.
- Para iOS: o ID da aplicação é o ID do iTunes da aplicação sem o prefixo id, por exemplo, 123456748.
Passo 1: Configuração do Adobe Launch
Siga as instruções aqui para configurar o Adobe Launch.
1.1 Crie uma nova propriedade no Adobe Launch
- Faça login no Adobe Experience Cloud.
- Selecione Lançamento.
- Clique em Ir para lançamento.
- Clique em Nova propriedade.
- Dê um nome à propriedade e selecione Mobile.
- Clique em Salvar.
1.2 Instalar as extensões necessárias do Adobe Launch
Instale as seguintes extensões no Adobe Launch:
- Adobe Analytics - conecte os dados registrados do SDK ao módulo Adobe Analytics.
- Extensão SDK da AppsFlyer - envia dados e eventos para a Adobe e a AppsFlyer usando o SDK do Adobe Launch.
- Perfil do Adobe - permite que o SDK armazene dados num perfil do lado do cliente.
- Adobe Mobile Core - permite a configuração do SDK para mobile e fornece acesso a eventos e condições do ciclo de vida predefinidos.
Instalar a extensão do Adobe Analytics
- Faça login no Adobe Analytics.
- Crie um conjunto de relatórios.
- Faça login novamente no Adobe Launch.
- Na lista de propriedades, clique na propriedade que criou anteriormente.
- Clique em Extensões.
- Pesquise e instale Adobe Analytics.
- Em Conjuntos de relatóriosespecifique o conjunto de relatórios criados no passo 2.
- Clique em Salvar.
Instalar a extensão SDK da AppsFlyer
- Selecione Extensões novamente.
- Procure e instale a extensão do SDK da AppsFlyer.
- Em ID do aplicativo iOS da AppsFlyerespecifique o ID do aplicativo iOS que obteve no passo dos pré-requisitos.
- Em Chave do desenvolvedor da AppsFlyer especifique a chave do desenvolvedor que você obteve na etapa de pré-requisitos.
- Ative Enviar dados de atribuição para o Adobe Analytics. Observe que existem algumas restrições ao compartilhamento de dados ao nível do usuário com plataformas de análise de terceiros.
- Clique em Salvar.
Instale a extensão Profile e Mobile Core
- Selecione Extensões novamente.
- Procure e instale Perfil.
- Procure e instale Mobile Core.
- Ao instalar o Mobile Core, basta guardar a extensão tal como está. Não é necessário especificar o servidor do Experience Cloud.
Passo 2: Implementação da extensão do SDK da AppsFlyer para Adobe
Siga as instruções nesta seção para implementar a extensão do SDK do Adobe no seu aplicativo.
2.1 Adicione o SDK ao aplicativo
- Na sua propriedade do Adobe, selecione Ambientes.
- Selecione o ambiente para o qual pretende implementar o SDK.
- No lado direito, clique no ícone da caixa.
- Copie os trechos de código da janela que será aberta e siga as instruções. Se o Adobe estiver sendo configurado pelo profissional de marketing, envie estes trechos de código ao programador do aplicativo.
2.2 Publicando o ambiente
Para completar a implementação do SDK, é necessário publicar o ambiente numa biblioteca.
- Na sua propriedade Adobe, selecione Publicar.
- Clique em Adicionar nova biblioteca.
- Dê um nome e, em Ambiente, selecione Desenvolvimento.
- Clique em Salvar e compilar para desenvolvimento.
- Quando a compilação estiver concluída, em Desenvolvimentoclique nos três pontos ao lado da biblioteca e selecione Enviar para aprovação.
- Em Enviadoclique nos três pontos ao lado da biblioteca e selecione Compilar para teste.
- Quando a compilação estiver concluída, clique nos três pontos ao lado da biblioteca e selecione Aprovar para publicação.
- Em Aprovarclique nos três pontos ao lado da biblioteca e selecione Compilar e publicar na produção.
2.3 Como adicionar o referenciador da instalação do Android ao seu aplicativo
O referenciador da instalação do Android melhora a precisão da atribuição, protege contra fraudes na instalação e muito mais. É compatível com o SDK da AppsFlyer para Android versão 4.8.6.
Importante!
O Google desativou oBroadcastReceiverem março de 2020.
- Essa alteração não afeta o aplicativo.
- Você ainda pode precisar do BroadcastReceiver para atribuição fora da loja. Verifique com a loja onde o aplicativo está listado para ter certeza.
- Implementar o referenciador de instalação é obrigatório agora.
Há duas formas de adicionar o referenciador da instalação ao seu aplicativo:
- Usando o Gradle (recomendado)
- Como adicionar o referenciador da instalação manualmente
Como adicionar o referenciador da instalação usando o Gradle Como adicionar o referenciador da instalação manualmente
Adicione o referenciador da instalação do Android como uma dependência. Você pode encontrar a versão mais recente aqui.
dependencies { //certifique-se de usar a versão mais recente do SDK: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk implementation 'com.appsflyer:af-android-sdk:5.+' implementation 'com.android.installreferrer:installreferrer:1.1' }- Sincronize o projeto para recuperar as dependências - veja a seguinte captura de tela:
Os desenvolvedores que estiverem usando ProGuard, e quiserem usar a API do novo referenciador do Google, devem definir o seguinte regra do ProGuard:-dontwarn com.android.installreferrer
https://support.appsflyer.com/hc/article_attachments/49929332279441
- Baixe o aar do referenciador da instalação
- Adicione-o ao projeto
- Adicione a seguinte permissão ao manifesto:
com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE
2.4 Definindo permissões necessárias
Adicionar permissões ajuda a aumentar a taxa de atribuição de modelagem probabilística. Também permite que o SDK envie mais dados, como Wifi e dados da rede da operadora. Você pode encontrar esses dados em relatórios de dados brutos e usá-los para análise e otimização de campanhas.
Adicionando 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" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- Opcional : --> <uses-permission android:name="android.permission.READ_PHONE_STATE" />
Usando a extensão do SDK do Adobe
Agora você pode começar a usar a extensão do SDK do Adobe para enviar dados para o Adobe e para a AppsFlyer.
Importante!
Atualmente, a extensão do SDK do Adobe Launch apenas suporta a obtenção de dados de conversão e o envio de eventos. No entanto, ao adicionar a extensão do SDK do Adobe Launch à sua aplicação, o SDK da AppsFlyer também é adicionado. Como consequência, qualquer funcionalidade atualmente em falta na extensão do SDK Adobe pode ser implementada usando o SDK da AppsFlyer.
Enviando eventos
Os eventos in-app fornecem insight do que está acontecendo em seu aplicativo. Recomendamos reservar um tempo e definir os eventos que você deseja registrar. O registro de eventos in-app ajuda a mensurar KPIs como ROI (retorno sobre o investimento) e LTV (Lifetime Value).
A extensão do SDK do Adobe Launch permite enviar dados de eventos in-app para o Adobe e para a AppsFlyer. Em seguida, você pode usar o Adobe Analytics para analisar o comportamento do usuário e a AppsFlyer para analisar o ROI e o LTV.
Android iOS
final Map<String,String> eventMap = new HashMap<>();
eventMap.put("currency", "USD");
eventMap.put("revenue", "200");
eventMap.put("freehand", "param"); MobileCore.trackAction("af_purchase", eventMap);
Exemplo
[ACPCore trackAction:@"af_purchase data:@{@"revenue":@"200",@"currency":@"USD"];
O envio dos eventos conforme especificado no código acima cria um evento no painel da AppsFlyer chamado af_purchase com uma receita de 200 USD. Este evento também é enviado e aparece no Adobe Analytics.
Todos os dados de conversão que são enviados com eventos são prefixados por Appsflyer. Consulte a tabela a seguir para mais detalhes.
| Variáveis de dados de conversão prefixadas |
|---|
| appsflyer.af_click_lookback |
| appsflyer.install_time |
| appsflyer.cost_cents_USD |
| appsflyer.media_source |
| appsflyer.af_adset |
| appsflyer.click_time |
| appsflyer.orig_cost |
| appsflyer.campaign |
Os dados de conversão estão disponíveis no Analysis Workspace do Adobe Analytics. Para mais informações sobre como migrar as regras de processamento do Adobe Mobile Services para o Adobe Analytics, consulte a documentação da Adobe.
Use-o para deep linking e deferred deep linking.
Os deep links e deferred deep linking permitem melhorar a sua experiência de usuário. Eles permitem abrir o aplicativo em atividades específicas e personalizar o conteúdo de acordo com os dados da campanha.
Para obter dados do deep linking, implemente os callbacks de extensão.
Android iOS
Na classe de aplicações globais, implemente o seguinte código:
AppsFlyerAdobeExtension.registerAppsFlyerExtensionCallbacks(new AppsFlyerExtensionCallbacksListener() {
@Override
public void onCallbackReceived(Map<String, String> callback) {
Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
if(callback.get("callback_type").equals("onConversionDataReceived")){
// dados de conversão retornados
if(callback.get("is_first_launch").equals("true")){
String af_status = callback.get("af_status");
if(af_status.equals("Non-organic")){
Log.d(AppsFlyerLibCore.LOG_TAG, "este é o primeiro lançamento e uma instalação não orgânica!");
}
}
} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
// deep link direto - redirecionar usuário
Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
}
}
@Override
public void onCallbackError(String errorMessage) {
Log.d("TAG", errorMessage);
}
});
Exemplo
Em AppDelegate.m, implemente o seguinte código:
[AppsFlyerAdobeExtension registerCallbacks:^(NSDictionary *dictionary) {
NSLog(@"[AppsFlyerAdobeExtension] Received callback: %@", dictionary);
if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onConversionDataReceived"]){
if([[dictionary objectForKey:@"is_first_launch"] boolValue] == YES){
NSString* af_status = [dictionary objectForKey:@"af_status"];
if([af_status isEqualToString:@"Non-organic"]){
NSLog(@"este é o primeiro lançamento e uma instalação não orgânica!");
}
}
} else if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onAppOpenAttribution"]) {
NSLog(@"onAppOpenAttribution Received");
}
}];
[AppsFlyerAdobeExtension callbacksErrorHandler:^(NSError *error) {
NSLog(@"[AppsFlyerAdobeExtension] Error recieving callback: %@" , error);
}];
Obtenha dados de conversão da AppsFlyer
Os dados de conversão são enviados com eventos para a plataforma Adobe. Estas variáveis permitem aplicar lógica e regras às dimensões, métricas ou filtros do relatório.
-
Faça login na sua conta do Adobe Analytics.
- Navegue até Admin > Report Suites
- Selecione o Report Suite que foi configurado durante a implementação do Adobe Analytics.
- Selecione Geral > Regras de processamento.
- Crie regras de processamento para mapear as variáveis de contexto da AppsFlyer para eVars.
Consulte a tabela a seguir para mapear as variáveis de contexto da AppsFlyer:
| Nome recomendado para mapear | Dados de conversão |
|---|---|
| Janela de visualização da AppsFlyer | appsflyer.af_click_lookback |
| Tempo de instalação da AppsFlyer | appsflyer.install_time |
| Custo AppsFlyer Centavos US | appsflyer.cost_cents_USD |
| Fonte de mídia AppsFlyer | appsflyer.media_source |
| Conjunto de Anúncios AppsFlyer | appsflyer.af_adset |
| Hora do Clique AppsFlyer | appsflyer.click_time |
| Custo Original AppsFlyer | appsflyer.orig_cost |
| Campanha AppsFlyer | appsflyer.campaign |
Usando os dados de conversão mapeados da AppsFlyer para análises
Todos os dados provenientes do SDK estão disponíveis no conjunto de relatórios do Adobe Analytics que está conectado ao aplicativo.
É possível usar os dados e suas dimensões e métricas relacionadas nos relatórios e painéis gerados do Adobe Analytics. Esses dados também estão disponíveis no painel da AppsFlyer para atribuição e análise de eventos in-app.