DocumentaçãoCampaignDocumentação do Campaign Classic v7

Migrar para a API do Adobe Analytics 2.0 analytics-2-migration

Última atualização: 11 de agosto de 2026
  • Aplica-se a:
  • Campaign Classic v7

As APIs do Adobe Analytics 1.4 estão atingindo o fim da vida útil. O conector do Web Analytics que vincula a instância do Campaign à Adobe Analytics depende dessas APIs, portanto, é necessário atualizar para uma compilação que use as novas APIs do Analytics 2.0 para manter a integração em execução.

CAUTION
A atualização reimporta os dois fluxos de trabalho técnicos internos que alimentam o conector, webAnalyticsSendMetrics e webAnalyticsGetWebEvents (consulte a Referência de fluxos de trabalho do Web Analytics para saber o que cada um faz). Qualquer personalização feita com base nesses fluxos de trabalho é substituída pela reimportação. Evite modificar diretamente esses fluxos de trabalho internos — crie sua personalização em um fluxo de trabalho personalizado separado; portanto, as atualizações futuras não a substituirão. A atualização também atualiza os arquivos integrados do Analytics JavaScript: se qualquer um dos workflows personalizados fizer referência a esses arquivos, eles serão interrompidos e precisarão ser adaptados ao novo código.

Você será afetado? are-you-impacted

Você será afetado se sua instância usar a conta externa Web Analytics para qualquer um dos seguintes itens:

  • Envio de indicadores e atributos de campanha de email para o Adobe Analytics como métricas.
  • Envio de dados de classificação ao Adobe Analytics.
  • O fluxo de remarketing (identificação de contatos convertidos após uma campanha).
  • Uma conta externa do Web Analytics que você planeja configurar pela primeira vez.

Não tem certeza de qual delas se aplica a você? Verifique quais dos workflows técnicos acima estão ativos em sua instância e revise a configuração da conta externa do Web Analytics em Administration > Platform > External accounts (consulte Conta externa do Web Analytics).

Como migrar how-to-migrate

Se você estiver em uma instância hospedada pela Adobe, a Adobe lidará com o provisionamento SFTP, a lista de permissões de IP e a configuração de chaves para você como parte da atualização. Você só precisará validar seus casos de uso depois que a nova build estiver ativa.

Se você estiver em uma implantação local ou híbrida, siga estas etapas.

  1. Atualize seu ambiente do Campaign para uma compilação que inclua as alterações do Adobe Analytics 2.0. Você pode confirmar qual compilação está executando a partir de Help > About… (consulte como verificar a versão do Campaign).

  2. Revise quais dos casos de uso acima se aplicam à sua instância, já que a próxima etapa depende disso.

  3. Se você usar o fluxo de trabalho de remarketing, o fluxo de trabalho webAnalyticsFindConverted precisará de um canal SFTP dedicado para trocar dados com o Adobe Analytics 2.0. Configure da seguinte maneira; caso contrário, pule para a próxima etapa.

    1. Provisione um servidor SFTP para a instância usando a autenticação baseada em chave, seguindo as mesmas práticas recomendadas para o servidor SFTP que você aplicaria a qualquer outra integração SFTP externa. A Adobe fornece um exemplo de script de configuração SFTP para ajudar você a começar.

    2. Registre os detalhes de conexão desse servidor no Adobe Analytics executando o script fornecido com a nova build:

      code language-none 
      nlserver javascript -instance:<instance_name> -arg:host=<sftp_host_url>#user=<sftp_user> -file <path_to_the_file>/aaremarketingLocation.js

      Exemplo:

      code language-none 
      nlserver javascript -instance:test_mkt_stage2 -arg:host=test-mkt-stage1.campaign.adobe.com#user=test -file ./nl6/datakit/nms/eng/js/aaremarketingLocation.js

    3. Lista de permissões do Adobe Analytics no servidor SFTP, já que as exportações de remarketing só são iniciadas a partir de um conjunto fixo de intervalos IP do Adobe:

  4. Habilite o sinalizador de recurso FEATUREFLAG_USE_ANALYTICS_20_API na sua instância criando ou definindo o longvalue da opção para 1 em xtkOption, em Administration> Platform >Options na árvore do Campaign Explorer. Esta etapa é necessária independentemente de qual caso de uso acima se aplica a você.

  5. Valide a migração exercitando cada caso de uso que se aplica à sua instância (envie uma campanha de teste, verifique se os indicadores chegam ao Analytics e confirme os dados de remarketing, se aplicável) antes de desativar qualquer conectividade antiga.

Configuração de uma nova conta externa do Web Analytics setting-up-a-new-web-analytics-external-account

O seguinte se aplica independentemente de sua instância ser hospedada pela Adobe ou no local/híbrida.

Se você estiver configurando a conta externa Web Analytics pela primeira vez em vez de migrar uma existente, siga as etapas de configuração da conta externa e o guia de introdução do conector.

Como o Analytics 2.0 apresenta um novo tratamento de classificação, também é necessário criar um conjunto de classificações no Adobe Analytics antes que sua conta externa possa coletar os dados de classificação do conjunto de relatórios. Esta é uma nova etapa: crie-a após configurar suas Variáveis de conversão e Eventos bem-sucedidos e antes de configurar a conta externa no Campaign.

Para criar seu conjunto de classificações:

  1. Na barra de menu superior do Adobe Analytics, selecione Components > Classification sets e clique em New.

  2. No diálogo Add New Classification Set:

    • Insira um Name para o conjunto de classificações.
    • Defina o Type como Primary.
    • Em Job notifications, escolha quem deve ser notificado sobre o sucesso ou falha dos trabalhos do conjunto de classificações e forneça os endereços de email correspondentes.
    • No Subscriptions, selecione seu conjunto de relatórios e a variável de conversão criada para o nome da campanha interna na etapa anterior.

  3. Clique em Save.

Esse conjunto de classificações será descoberto automaticamente pelo Campaign quando você configurar sua conta externa na próxima etapa. Para obter mais informações sobre conjuntos de classificações, consulte a documentação do Adobe Analytics.

Precisa de ajuda? need-help

Se você tiver problemas durante a migração, contate o Atendimento ao cliente da Adobe.

recommendation-more-help
campaign-classic-help