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.
Observação
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
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.
Observação
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
Adicione o referenciador da instalação do Android como uma dependência. Você pode encontrar a versão mais recente aqui.
-
dependencies { //make sure to use the latest SDK version: 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
- 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" /> <!-- Optional : --> <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.
Observação
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.
final Map<String,String> eventMap = new HashMap<>();
eventMap.put("currency", "USD");
eventMap.put("revenue", "200");
eventMap.put("freehand", "param");
MobileCore.trackAction("af_purchase", eventMap);
[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 são usados no aplicativo que você cria no Adobe Mobile Services. Existem outros parâmetros que podem aparecer nos dados de conversão. Clique aqui para saber mais.
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.
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")){
// conversion data returned
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, "this is first launch and a non organic install!");
}
}
} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
// direct deeplink - redirect user
Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
}
}
@Override
public void onCallbackError(String errorMessage) {
Log.d("TAG", errorMessage);
}
});
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(@"this is first launch and a non organic install!");
}
}
} 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 nos serviços mobile do Adobe.
- Selecione o aplicativo relevante e acesse a página Gerenciar variáveis e métricas.
- Selecione a opção Variáveis personalizadas e configure as variáveis para mapear os dados do SDK da AppsFlyer para o sistema Adobe.
- Para cada variável personalizada, introduza um nome significativo.
- Selecione ou escreva os dados de conversão mapeados da AppsFlyer e escolha seu escopo de Persistência preferido.
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.