AWS visão geral da extensão

OBSERVAÇÃO

A Adobe Experience Platform Launch foi reformulada como um conjunto de tecnologias de coleta de dados no Adobe Experience Platform. Como resultado, várias alterações de terminologia foram implementadas na documentação do produto. Consulte o seguinte documento para obter uma referência consolidada das alterações de terminologia.

Amazon Web Services (AWS) é uma plataforma de computação em nuvem que oferece uma grande variedade de serviços, como computação distribuída, armazenamento de banco de dados, entrega de conteúdo e serviços de integração de software como um serviço (SaaS) para gerenciamento de relacionamento com o cliente (CRM) e ERP (Enterprise Resource Planning, planejamento de recursos corporativos).

O AWS encaminhamento de eventos aproveitadores de extensão Amazon Kinesis Data Streams para enviar eventos da rede de borda da Adobe Experience Platform para o AWS para transformação subsequente. Este guia aborda como instalar a extensão e empregar seus recursos em uma regra de encaminhamento de eventos.

Pré-requisitos

Você deve ter um AWS com uma conta existente Kinesis fluxo de dados para usar essa extensão. Se você não tiver um fluxo de dados pré-existente, consulte o AWS documentação sobre criar um novo fluxo de dados usando o AWS Console de gerenciamento.

Instalar a extensão

Para instalar o AWS , navegue até a interface do usuário da coleta de dados ou a interface do usuário do Experience Platform e selecione Encaminhamento de evento no painel de navegação esquerdo. Aqui, selecione uma propriedade para adicionar a extensão ou crie uma nova propriedade.

Após selecionar ou criar a propriedade desejada, selecione Extensões na navegação à esquerda, selecione o Catálogo guia . Procure a variável AWS cartão e, em seguida, selecione Instalar.

O Instalar botão que está sendo selecionado para o AWS na interface do usuário da Coleta de dados.

Na próxima tela, você deve fornecer as credenciais de conexão para AWS conta. Especificamente, você deve fornecer seu AWS a ID da chave de acesso e a chave de acesso secreta. Se não souber esses valores, consulte a AWS documentação sobre como obter a ID da chave de acesso e a chave de acesso secreta.

A ID da chave de acesso e a chave de acesso secreta adicionadas na exibição de configuração da extensão.

IMPORTANTE

É necessário anexar uma política de acesso à AWS conta usada para gerar as credenciais de acesso. Essa política deve ser configurada para conceder direitos de acesso para enviar dados para o Kinesis fluxo de dados. Consulte Exemplo 2 no AWS documento em políticas de exemplo para Kinesis Data Streams para ver como a política deve ser definida.

Quando terminar, selecione Salvar e a extensão é instalada.

Configurar uma regra de encaminhamento de eventos

Depois de instalar a extensão, crie um novo encaminhamento de evento regra e configure as condições conforme desejado. Ao configurar as ações para a regra, selecione o AWS e selecione Enviar dados para o fluxo de dados do Kinesis para o tipo de ação.

O Enviar dados para o fluxo de dados do Kinesis tipo de ação sendo selecionado para uma regra na interface do usuário da Coleta de dados.

O painel direito é atualizado para mostrar as opções de configuração de como os dados devem ser enviados. Especificamente, você deve atribuir elementos de dados para as várias propriedades que representam as Event Hub configuração.

As opções de configuração do Enviar dados para o fluxo de dados do Kinesis tipo de ação mostrado na interface do usuário.

Detalhes do fluxo de dados do Kinesis

Entrada Descrição
Nome do fluxo O nome do fluxo para o qual essa regra de encaminhamento de eventos enviará registros de dados.
AWS Region O AWS região em que Kinesis fluxo de dados é criado.
Chave de Partição O chave de partição que a extensão usará ao enviar dados para o fluxo de dados.

Kinesis Data Streams segrega os registros de dados pertencentes a um fluxo em vários fragmentos. Ele usa a chave de partição enviada com cada registro de dados para determinar a qual compartilhamento um determinado registro de dados pertence.

Uma boa chave de partição para distribuir clientes pode ser o número do cliente, já que é diferente para cada cliente. Uma chave de partição ruim pode ter o CEP, pois todos podem viver na mesma área próxima. Em geral, você deve escolher uma chave de partição que tenha o maior intervalo de valores em potencial diferentes. Consulte a AWS artigo sobre dimensionamento de Kinesis fluxos de dados para obter as práticas recomendadas de gerenciamento de chaves de partição.

Dados

Entrada Descrição
Carga Esse campo contém os dados que serão encaminhados para a variável Kinesis fluxo de dados, no formato JSON.

Em Bruto , você pode colar o objeto JSON diretamente no campo de texto fornecido ou pode selecionar o ícone do elemento de dados (Ícone do conjunto de dados) para selecionar de uma lista de elementos de dados existentes para representar a carga útil.

Também é possível usar a variável Editor de pares de valores-chave JSON para adicionar manualmente cada par de valores chave por meio de um editor de interface. Cada valor pode ser representado por uma entrada bruta, ou um elemento de dados pode ser selecionado.

Quando terminar, selecione Manter alterações para adicionar a ação à configuração da regra. Quando estiver satisfeito com a regra, selecione Salvar na biblioteca.

Finalmente, publique um novo encaminhamento de evento build para ativar as alterações na biblioteca.

Próximas etapas

Este guia cobriu como enviar dados para o Kinesis Data Streams usando o AWS extensão de encaminhamento de evento. Para obter mais informações sobre os recursos de encaminhamento de eventos no Experience Platform, consulte o visão geral do encaminhamento de eventos.

Nesta página