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.
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 usuário do Adobe Mobile Services, clique em Aquisição > Construtor de links de marketing e gere um URL de Link de marketing de aquisição 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