Configuração do Adobe I/O para acionadores da Adobe Experience Cloud

ATENÇÃO

Se você estiver usando uma versão mais antiga da integração de acionadores por meio da autenticação oAuth, será necessário mudar para o Adobe I/O conforme descrito abaixo.
Observe que, durante a migração para o Adobe I/O, alguns acionadores de entrada podem ser perdidos.

O modo de autenticação oAuth herdado com o Campaign será desativado em 20 de outubro de 2021. Os ambientes hospedados se beneficiam de uma extensão até 23 de fevereiro de 2022. Como cliente local ou híbrido, entre em contato com o Atendimento ao cliente do Adobe para estender o suporte até fevereiro de 2022. Você deve fornecer o AppID do aplicativo OAuth para o Adobe.

Pré-requisitos

Essa integração só se aplica a partir de Campaign Classic 20.2.4 e superior, versões 19.1.8 e Gold Standard 11.

Antes de iniciar esta implementação, verifique se você tem:

  • um identificador de organização valido: o identificador de organização do Identity Management System (IMS) é o identificador exclusivo da Adobe Experience Cloud, usado por exemplo para o serviço VisitorID e o IMS Single-Sign On (SSO). Saiba mais
  • um Acesso de desenvolvedor para sua organização. O administrador do sistema da IMS Org precisa seguir o procedimento Adicionar desenvolvedores a um único perfil de produto
    detalhado nesta página para fornecer acesso de desenvolvedor ao Analytics - {tenantID} Perfil de produto do Adobe Analytics associado aos acionadores.

Etapa 1: criar/atualizar projeto do Adobe I/O

  1. Acesse Adobe I/O e faça logon com o acesso do desenvolvedor da Organização IMS.

    OBSERVAÇÃO

    Verifique se você está conectado ao portal correto da organização.

  2. Extraia o identificador do cliente (ID do cliente) de integração existente do arquivo de configuração da instância ims/authIMSTAClientId. Um atributo não existente ou vazio indica que o identificador do cliente não está configurado.

    OBSERVAÇÃO

    Se o identificador do cliente estiver vazio, será possível Create a New project diretamente no Adobe I/O.

  3. Identifique o projeto existente usando o identificador do cliente extraído. Procure projetos existentes com o mesmo identificador do cliente que o extraído na etapa anterior.

  4. Selecione + Add to Project e escolha API.

  5. Na janela Add an API, selecione Adobe Analytics.

  6. Escolha Service Account (JWT) como o tipo de autenticação.

  7. Se a ID do cliente estiver vazia, selecione Generate a key pair para criar um par de chaves público e privado.

    As chaves serão baixadas automaticamente com uma data de expiração padrão de 365 dias. Depois de expirar, você precisará criar um novo par de chaves e atualizar a integração no arquivo de configuração. Usando a Opção 2, você pode optar por criar e fazer upload manualmente da Public key com uma data de expiração mais longa.

    ATENÇÃO

    Você deverá salvar o arquivo config.zip quando o prompt de download for exibido, pois não será possível baixá-lo novamente.

  8. Clique em Next.

  9. Escolha qualquer Product profile existente ou crie um novo, se necessário. Nenhuma permissão é necessária para este Product profile. Para obter mais informações sobre Analytics Product Profiles, consulte a documentação do Adobe Analytics.

    Em seguida, clique em Save configured API.

  10. Em seu projeto, selecione Adobe Analytics e copie as seguintes informações em Service Account (JWT):

    • Client ID
    • Client Secret
    • Technical account ID
    • Organization ID

ATENÇÃO

O certificado do Adobe I/O expirará após 12 meses. Você precisa gerar um novo par de chaves todo ano.

Etapa 2: adicionar as credenciais do projeto no Adobe Campaign

OBSERVAÇÃO

Esta etapa não será necessária se o identificador do cliente não estiver vazio na Etapa 1: criar/atualizar projeto do Adobe I/O.

A chave privada deve ser codificada no formato base64 UTF-8. Para fazer isso:

  1. Use a chave privada gerada na Etapa 1: criar/atualizar a seção Projeto do Adobe I/O. A chave privada precisa ser a mesma usada para criar a integração.

  2. Codifique a chave privada usando o seguinte comando: base64 ./private.key > private.key.base64. Isso salvará o conteúdo base64 em um novo arquivo private.key.base64.

    OBSERVAÇÃO

    Às vezes, uma linha extra pode ser adicionada automaticamente ao copiar/colar a chave privada. Lembre-se de removê-la antes de codificar sua chave privada.

  3. Copie o conteúdo do arquivo private.key.base64.

  4. Faça logon via SSH em cada container em que a instância do Adobe Campaign está instalada e adicione as credenciais do Projeto no Adobe Campaign executando o comando a seguir como usuárioneolane. Isso inserirá as credenciais Technical Account no arquivo de configuração da instância.

    nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>
    

Etapa 3: atualizar a tag de pipeline

OBSERVAÇÃO

Essa etapa não será necessária se o identificador do cliente não estiver vazio na Etapa 1: criar/atualizar projeto do Adobe I/O.

Para atualizar a tag pipelined, é necessário atualizar o tipo de autenticação para o projeto do Adobe I/O no arquivo de configuração config-< instance-name >.xml da seguinte maneira:

<pipelined ... authType="imsJwtToken"  ... />

Em seguida, execute um config -reload e uma reinicialização do pipelined para que as alterações sejam consideradas.

Nesta página