Implementação do AAM para Android

Implementação do AAM para Android

Pesquisar
Guia do Usuário

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Introdução

O AAM para celular pode ser usado para inserir, organizar e segmentar os dados de público-alvo de primeira e terceira parte de um anunciante para dispositivos móveis e computadores. Auxiliar um profissional de marketing na criação de público-alvo, análise e execução de campanhas de marketing. O Audience Manager pode ser integrado a várias plataformas e sistemas operacionais móveis.

Este artigo se concentra na implementação do Adobe Audience Manager em aplicativos para dispositivos móveis do Android.  Este artigo é de natureza técnica, pois o público-alvo é o desenvolvedor Android que está implementando e validando a solução.

O guia de implementação é específico para a implementação do Audience Manager quando o serviço do Experience Cloud e os serviços principais são implementados para o cliente. Caso o serviço Experience Cloud seja implementado para o cliente e os serviços principais não sejam implementados, verifique a tecnologia de implementação específica com o serviço Experience Cloud. Se o serviço da Experience Cloud (serviço de ID do visitante) não estiver habilitado, consulte o guia de implementação do lado do cliente correspondente.

Pré-requisitos

Você deve ter baixado os arquivos do Adobe SDK para iniciar a implementação configurada para o Audience Manager. Se você tiver acesso de administrador ao Analytics, poderá configurar o aplicativo no Adobe Mobile Services e baixar o SDK para seu aplicativo. Se você não tiver acesso ao Adobe Mobile Services, poderá baixar o SDK neste link: https://github.com/Adobe-Marketing-Cloud/mobile-services/releases?

Pesquise o Android SDK mais recente e baixe o AdobeMobileLibrary-4.Arquivo *-Android.zip. Você deve ter os seguintes componentes de software dentro:

  • adobeMobileLibrary.jar: Biblioteca projetada para uso com dispositivos Android e simuladores.
  • ADBMobileConfig.json: arquivo de configuração do SDK personalizado para seu aplicativo.

Adicione o adobeMobileLibrary.jar como uma dependência de arquivo em Dependências dentro de sua estrutura de projeto, como mostrado na captura de tela abaixo:

image1

Se o seu aplicativo já estiver configurado para o Adobe Analytics, as etapas acima já teriam sido executadas juntamente com a implementação principal e a implementação da métrica do ciclo de vida, e você poderá prosseguir diretamente para a seção da configuração do Audience Manager.

Implementação principal e ciclo de vida

O SDK baixado requer o Android 2.2 ou posterior para que a implementação funcione.

1. Adicione o arquivo ADBMobileConfig.json à pasta de ativos em seu projeto.

2. Adicione permissões de aplicativo para permitir que a biblioteca do AppMeasurement envie e registre chamadas de rastreamento offline. Para adicionar essas permissões, adicione as seguintes linhas ao arquivo AndroidManifest.xml (no diretório do projeto do aplicativo):

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. Implemente medições de ciclo de vida (em cada atividade dentro de seu aplicativo):

a. Importe a seguinte biblioteca:

 import com.adobe.mobile.*;

b. Na função onResume, comece a coletar dados do ciclo de vida: 

@Override
public voidonResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}

 c. Dentro da função onPause, pause a coleta de dados do ciclo de vida

@Override
public voidonPause() {
Config.pauseCollectingLifecycleData();
}

4. Para incluir dados adicionais com chamadas de métricas do ciclo de vida, passe um parâmetro adicional para collectLifecycleData que contém dados de contexto:

@Override
public voidonResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}

É possível ver esta documentação para algumas etapas que devem ser executadas se você estiver usando o IntelliJ IDEA ou o Eclipse em vez do Android Studio para configurar os aplicativos: https://marketing.adobe.com/resources/help/pt_BR/mobile/android/dev_qs.html

Configuração do Audience Manager

1. Quando configuramos o aplicativo na Intetrface do usuário de Mobile Services: https://mobilemarketing.adobe.com temos opções para habilitar o SSF (Server Side Forwarding) na seção de configuração do SDK do Audience Manager.  

A partir de lá, podemos verificar o Encaminhamento do Analytics e inserir subdomínio para o Audience Manager. Então, depois de baixar o arquivo ADBMobileConfig.json, ele terá todos os campos necessários.

 

image2
image2_1 
"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

A seguir estão as etapas para inserir manualmente esses valores no arquivo ADBMobileConfig.json. Dentro do arquivo ADBMobileConfig.json na seção de audienceManager e marketingCloud, forneça os seguintes detalhes de configuração

 

"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Nota:

  • Um pré-requisito para usar o encaminhamento do lado do servidor dos dados de análise é que o cliente deve ser provisionado para o Serviço da Experience Cloud ID (https://marketing.adobe.com/resources/help/pt_BR/mcvid/).
  • Os IDs de organização do Experience Cloud identificam exclusivamente cada empresa cliente na Adobe Experience Cloud e são semelhantes aos seguintes valores: 016D5C175213CCA80A490D05@AdobeOrg.       

Quando a configuração acima é definida, todas as medições de ciclo de vida são capturadas na chamada de análise e são encaminhadas diretamente pelo lado do servidor.

image3

2. No método onCreate da atividade principal, permita o acesso do SDK ao contexto do aplicativo usando Config.setContext:

@Override
public voidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Allow the SDK access to the application context
Config.setContext(this.getApplicationContext());
}

Se você já adicionou essa chamada ao implementar o Analytics ou o Target, não é necessário adicioná-lo novamente.

Verificar a implementação

Abaixo estão alguns pontos de verificação de logs de chamadas para verificar a implementação do lado do servidor:

Se uma sincronização de ID do cliente ocorrer, ela será mostrada em: d_cid_ic na chamada de rede dpm.demdex.net. Quando a implementação do lado do servidor é concluída, não é feita nenhuma chamada de rede adicional do Audience Manager. Os dados do Google Analytics são enviados para o Audience Manager por completo.

image4

Observe que o d_uuid não estará disponível na chamada de solicitação se o encaminhamento do lado do servidor for feito junto com a implementação da ID do visitante (diferente da implementação do lado do cliente). Você poderá ver valores de d_mid & d_orgid em vez de serem associados ao serviço de ID de visitante na chamada dpm.demdex.net. No entanto, o valor uuid aparecerá na resposta, que teria a seguinte aparência (exibida na chamada de rede do Analytics):

image5