Show Menu
TÓPICOS×

Teste da aquisição V3

Estas informações ajudam a fazer uma viagem de ida e volta no link da campanha de aquisição da versão 3 em um dispositivo Android.
A aquisição V3 se refere aos links de aquisição criados com o Criador de aquisição na interface do Adobe Mobile Services. Para usar este recurso, é necessário atualizar para o Android SDK 4.x para Soluções da Experience Cloud 4.6.0 ou posteriores.
Se o aplicativo móvel ainda não estiver no Google Play, ao criar o link de campanha é possível selecionar qualquer aplicativo móvel como destino. Essa ação só afeta o aplicativo ao qual o servidor da aquisição te direciona após clicar no link de aquisição, mas não afeta a capacidade de testar o link. Os parâmetros da cadeia de caracteres de consulta são passados para a Google Play store, que é passada para o aplicativo na instalação como parte de uma difusão de campanha. A viagem de ida e volta do teste de aquisição do aplicativo móvel requer uma simulação desse tipo de difusão.
Se você estiver fazendo uma implementação usando as APIs do Referenciador de instalação do Google Play, não será possível testar a aquisição antes que seu aplicativo esteja na Google Play Store.
O aplicativo deve estar recém-instalado ou ter os dados limpos em **Configurações**sempre que um teste for executado. Isso garante que as medições de ciclo de vida inicial associadas aos parâmetros de cadeia de caracteres de consulta da campanha sejam enviadas quando o aplicativo é inicializado pela primeira vez.
  1. Conclua as tarefas de pré-requisito na Aquisição de aplicativos móveis e certifique-se de que você implementou corretamente o receptor de transmissão para INSTALL_REFERRER .
  2. Na interface do Adobe Mobile Services, clique em Aquisição > Construtor de links de marketing e gere um URL de Aquisição de link de marketing que defina o Google Play como destino para dispositivos Android.
    Para obter mais informações, consulte Criador de links de marketing .
    Por exemplo, https://c00.adobe.com/v3/<appid>/start?a_i_id=iostestapp&a_g_id=com.adobe.android&a_dd=g&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=trackingcode .
    Se fizer referência aos aplicativos do Android ou iOS no link de aquisição, use o Google Play como loja padrão.
  3. Abra o link em um navegador do desktop.
    Você deverá ser redirecionado a uma página com URL semelhante ao exemplo a seguir: https://play.google.com/store/apps/details?id=com.adobe.android&referrer=utm_campaign%3Dadb_acq_v3%26utm_source%3Dadb_acq_v3%26utm_content%3D91b52ce097b1464b9b47cb2995c493cc6ab2c3a3
  4. Copie a ID única depois de utm_content%3D .
    No exemplo anterior, a ID é 91b52ce097b1464b9b47cb2995c493cc6ab2c3a3 .
  5. Construa o link final de aquisição usando a ID única da etapa 3, usando o formato a seguir:
    https://c00.adobe.com/v3/<appid>/end?a_ugid=<unique id> .
    Por exemplo, https://c00.adobe.com/v3/<appid>/end?a_ugid=91b52ce097b1464b9b47cb2995c493cc6ab2c3a3 .
  6. Abra o link em um navegador do desktop.
    Você deverá ver o contextData na resposta do JSON:
    {"fingerprint":"228d7e6058b1d731dc7a8b8bd0c15e1d78242f31","timestamp":1457989293,"appguid":"","contextData":{"a.referrer.campaign.name":"name","a.referrer.campaign.trackingcode":"trackingcode"}}.
    Se você não visualizar contextData ou se estiver faltando uma cadeia de caracteres, certifique-se de que o URL de aquisição siga o formato em Criar link de aquisição manualmente .
  7. Repita a etapa 3 para obter uma ID única.
  8. Verifique se as seguintes configurações em seu arquivo de configuração estão corretas:
    Configuração
    Valor
    aquisição
    O servidor deve ser c00.adobe.com . * appid *deve ser igual ao appid no link de aquisição.
    analytics
    Para fins de teste, defina o limite de tempo do referencial para permitir que o tempo adequado (60 segundos ou mais) envie a difusão automaticamente. É possível restaurar a configuração original de limite de tempo após testar.
  9. Conecte o dispositivo a um computador, desinstale e instale o aplicativo novamente.
  10. Inicie o ADB Shell e execute o aplicativo no dispositivo.
  11. Envie uma transmissão usando o comando adb a seguir:
    am broadcast -a com.android.vending.INSTALL_REFERRER -n com.adobe.android/com.adobe.android.YourBroadcastReceiver --es "referrer" "utm_source=adb_acq_v3&utm_campaign=adb_acq_v3&utm_content=<unique id get on step 5>"
  12. Complete as etapas a seguir:
    1. Substitua com.adobe.android pelo nome de pacote do aplicativo.
    2. Atualize a referência do receptor com a da localização do receptor de rastreamento de campanha no aplicativo
    3. Substitua os valores associados ao utm_content . Se a transmissão for bem sucedida, você pode esperar uma resposta como o exemplo a seguir:
    Broadcasting: Intent { act=com.android.vending.INSTALL_REFERRER cmp=com.adobe.adms.tests/.ReferralReceiver (has extras) } Broadcast completed: result=0
  13. (Opcional) É possível ativar o registro de depuração do SDK para obter informações adicionais.
    Se tudo funcionar corretamente, você deverá ver os seguintes registros:
"Analytics - Received referrer information(<referrer content>)" "Analytics - Trying to fetch referrer data from (acquisition end url)"; "Analytics - Received Referrer Data(<A JSON Response>)"
Se você não puder ver os registros acima, verifique se concluiu as etapas de 6 a 12.
A tabela a seguir contém informações adicionais sobre os erros possíveis:
Erro
Descrição
Analytics - Unable to decode response( String ).
A resposta está malformada.
Analytics - Unable to parse response ( a JSON Response ).
A cadeia de caracteres JSON está malformada.
Analytics - Unable to parse acquisition service response (no contextData parameter in response).
Não há um parâmetro contextData na resposta.
Analytics - Acquisition referrer data was not complete (no a.referrer.campaign.name in context data), ignoring.
a.referrer.campaign.name não está incluído em contextData.
Analytics - Acquisition referrer timed out.
Falha ao obter a resposta no tempo definido pelo referrerTimeout . Aumente o valor e tente novamente. Também é necessário se assegurar de que você abriu o link de aquisição antes de instalar o aplicativo.
Lembre-se das seguintes informações:
  • As ocorrências enviadas do aplicativo podem ser monitoradas usando as ferramentas de monitoramento HTTP para verificar a atribuição da aquisição.
  • Para obter mais informações sobre como fazer a transmissão do INSTALL_REFERRER , consulte Testar medição de campanha do Google Play no Guia de desenvolvedores do Google.
  • Uma correção de erro foi disponibilizada no Android 4.8.2.
    Antes de testar, atualize o SDK para a versão mais atual.
  • É possível usar a ferramenta acquisitionTest.jar do Java fornecida para ajudá-lo a obter a ID única e o referencial de instalação da transmissão que, por sua vez, o ajuda a obter as informações das etapas de 3 a 12.
    Para instalar a ferramenta Java
Para instalar a ferramenta Java:
  1. Baixe o arquivo acquisitionTester.zip .
  2. Extraia o arquivo .jar.
    É possível executar o arquivo na linha de comando.
    Por exemplo:
    java -jar acquisitionTester.jar -a com.adobe.test -r com.adobe.test.ReferrerReceiver -l "https://c00.adobe.com/v3/appid/start?a_i_id=123456&a_g_id=com.adobe.test&a_dd=i&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=1234