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. O modo de autenticação oAuth herdado com o Campaign será desativado em 30 de novembro de 2021. Saiba mais

Observe que, durante a migração para o Adobe I/O, alguns acionadores de entrada podem ser perdidos.

Pré-requisitos

Essa integração se aplica somente a partir das Gold Standardversões do Campaign Classic 20.3, 20.2.4, 19.1.8 e 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