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

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

    

Etapa 2: adicionar as credenciais do projeto no Adobe Campaign

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

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.