Visão geral da extensão do AWS

NOTE
O Adobe Experience Platform Launch foi reformulado como um conjunto de tecnologias de coleção de dados na 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 CRM (gerenciamento de relacionamento com o cliente) e ERP (planejamento de recursos da empresa).

A extensão AWS encaminhamento de eventos aproveita Amazon Kinesis Data Streams para enviar eventos do Edge Network Adobe Experience Platform para AWS para processamento adicional. Este guia aborda como instalar a extensão e empregar seus recursos em uma regra de encaminhamento de eventos.

Pré-requisitos

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

Instalar a extensão install

Para instalar a extensão AWS, navegue até a interface da Coleção de dados ou a interface do Experience Platform e selecione Encaminhamento de eventos na navegação à esquerda. Aqui, selecione uma propriedade à qual adicionar a extensão ou crie uma nova propriedade.

Depois de selecionar ou criar a propriedade desejada, selecione Extensões na navegação à esquerda e selecione a guia Catálogo. Procure o cartão AWS e selecione Instalar.

O botão Instalar sendo selecionado para a extensão do AWS na interface da Coleção de Dados.

Na próxima tela, você deve fornecer as credenciais de conexão para sua conta do AWS. Você deve fornecer sua ID de chave de acesso e chave de acesso secreta do AWS. Se você não souber esses valores, consulte a documentação do AWS 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.

IMPORTANT
É necessário anexar uma política de acesso à conta AWS usada para gerar as credenciais de acesso. Esta política deve ser configurada para conceder direitos de acesso para enviar dados ao fluxo de dados Kinesis. Consulte Exemplo 2 no documento AWS sobre 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 será instalada.

Configurar uma regra de encaminhamento de eventos rule

Após instalar a extensão, crie uma nova regra para o encaminhamento de eventos e configure suas condições conforme desejado. Ao configurar as ações para a regra, selecione a extensão AWS e selecione Enviar Dados para o Kinesis Data Stream para o tipo de ação.

O tipo de ação Enviar Dados para o Fluxo de Dados do Kinesis que está sendo selecionado para uma regra na Interface da Coleção de Dados.

O painel direito atualiza para mostrar as opções de configuração de como os dados devem ser enviados. Você deve atribuir elementos de dados às várias propriedades que representam sua configuração Event Hub.

As opções de configuração para o tipo de ação Enviar Dados para o Fluxo de Dados do Kinesis mostradas 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 esta regra de encaminhamento de eventos enviará registros de dados.
AWS Region
A região AWS onde o fluxo de dados Kinesis é criado.
Chave de Partição
A chave de partição que a extensão usará ao enviar dados para o fluxo de dados.

Kinesis Data Streams separa 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 fragmento um determinado registro de dados pertence.

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

Dados

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

Na opção Raw, você pode colar o objeto JSON diretamente no campo de texto fornecido ou selecionar o ícone de elemento de dados ( ícone de Conjunto de Dados ) para selecionar de uma lista de elementos de dados existentes para representar a carga.

Você também pode usar a opção Editor de pares de valores-chave JSON para adicionar manualmente cada par de valores-chave por meio de um editor de interface do usuário. 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 de regra. Quando estiver satisfeito com a regra, selecione Salvar na biblioteca.

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

Próximas etapas

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

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743