Extensão do SDK do Adobe Launch

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

dev_key.png

  1. No painel do seu aplicativo, clique em Configurações do aplicativo abaixo de Configurações no menu à esquerda.
  2. 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. Faça login no Adobe Experience Cloud.
  2. Selecione Lançamento.
  3. Clique em Ir para lançamento.
  4. Clique em Nova propriedade.
  5. Dê um nome à propriedade e selecione Mobile.
  6. Clique em Salvar.

1.2 Instalar as extensões necessárias do Adobe Launch

Instale as seguintes extensões no Adobe Launch:

adboe_extensions.png

  • 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

  1. Faça login no Adobe Analytics.
  2. Crie um conjunto de relatórios.
  3. Faça login novamente no Adobe Launch.
  4. Na lista de propriedades, clique na propriedade que criou anteriormente.
  5. Clique em Extensões.
  6. Pesquise e instale Adobe Analytics.
  7. Em Conjuntos de relatóriosespecifique o conjunto de relatórios criados no passo 2.
  8. Clique em Salvar.

Instalar a extensão SDK da AppsFlyer

  1. Selecione Extensões novamente.
  2. Procure e instale a extensão do SDK da AppsFlyer.
  3. Em ID do aplicativo iOS da AppsFlyerespecifique o ID do aplicativo iOS que obteve no passo dos pré-requisitos.
  4. Em Chave do desenvolvedor da AppsFlyer especifique a chave do desenvolvedor que você obteve na etapa de pré-requisitos.
  5. 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.
  6. Clique em Salvar.

Instale a extensão Profile e Mobile Core

  1. Selecione Extensões novamente.
  2. Procure e instale Perfil.
  3. 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

adobe_sdk.png

  1. Na sua propriedade do Adobe, selecione Ambientes.
  2. Selecione o ambiente para o qual pretende implementar o SDK.
  3. No lado direito, clique no ícone da caixa.
  4. 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.

adobe_publishing.png

  1. Na sua propriedade Adobe, selecione Publicar.
  2. Clique em Adicionar nova biblioteca.
  3. Dê um nome e, em Ambiente, selecione Desenvolvimento.
  4. Clique em Salvar e compilar para desenvolvimento
  5. Quando a compilação estiver concluída, em Desenvolvimentoclique nos três pontos ao lado da biblioteca e selecione Enviar para aprovação.
  6. Em Enviadoclique nos três pontos ao lado da biblioteca e selecione Compilar para teste.
  7. Quando a compilação estiver concluída, clique nos três pontos ao lado da biblioteca e selecione Aprovar para publicação.
  8. 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
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.

  1. 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'
    }
  2. Sincronize o projeto para recuperar as dependências - veja a seguinte captura de tela:

    android_af_sdk_sync_gradle.png

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

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

  1. 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.

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);

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.

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")){
				// 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);
		}
	});

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.

adobe_analytics.png

  1. Faça login nos serviços mobile do Adobe.
  2. Selecione o aplicativo relevante e acesse a página Gerenciar variáveis e métricas.
  3. Selecione a opção Variáveis personalizadas e configure as variáveis para mapear os dados do SDK da AppsFlyer para o sistema Adobe.
  4. Para cada variável personalizada, introduza um nome significativo.
  5. 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.