(Beta) Amazon Kinesis conexão

Visão geral

IMPORTANTE

O Amazon Kinesis no Platform está atualmente em beta. A documentação e a funcionalidade estão sujeitas a alterações.

O Kinesis Data Streams serviço por Amazon Web Services O permite coletar e processar grandes fluxos de registros de dados em tempo real.

Você pode criar uma conexão de saída em tempo real com o Amazon Kinesis armazenamento para fazer o stream de dados do Adobe Experience Platform.

Amazon Kinesis na interface do usuário

Casos de uso

Ao usar destinos de transmissão, como Amazon Kinesis, você pode alimentar facilmente eventos de segmentação de alto valor e atributos de perfil associados nos sistemas de sua escolha.

Por exemplo, um prospecto baixou um white-paper que os qualifica em um segmento de "alta propensão à conversão". Mapeando o segmento em que o prospecto entra na Amazon Kinesis , você receberia esse evento em Amazon Kinesis. Lá, você pode empregar uma abordagem faça você mesmo e descrever a lógica de negócios sobre o evento, pois acha que funcionaria melhor com os sistemas de TI de sua empresa.

Tipo de exportação

Baseado em perfil - estiver exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), conforme escolhido na tela selecionar atributos do fluxo de trabalho de ativação do público.

Obrigatório Amazon Kinesis permissões

Para se conectar e exportar dados com êxito para seu Amazon Kinesis fluxos, o Experience Platform precisa de permissões para as seguintes ações:

  • kinesis:ListStreams
  • kinesis:PutRecord
  • kinesis:PutRecords

Essas permissões são organizadas por meio do Kinesis e são marcados pela Platform depois de configurar o destino do Kinesis na interface do usuário da plataforma.

O exemplo abaixo exibe os direitos mínimos de acesso necessários para exportar dados com êxito para um Kinesis destino.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams",
                "kinesis:PutRecord",
                "kinesis:PutRecords"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}
Propriedade Descrição
kinesis:ListStreams Uma ação que lista seus fluxos de dados do Amazon Kinesis.
kinesis:PutRecord Uma ação que grava um único registro de dados em um fluxo de dados do Kinesis.
kinesis:PutRecords Uma ação que grava vários registros de dados em um fluxo de dados do Kinesis em uma única chamada.

Para obter mais informações sobre como controlar o acesso para Kinesis fluxos de dados, leia o seguinte Kinesis documento.

Conecte-se ao destino

Para se conectar a esse destino, siga as etapas descritas na tutorial de configuração de destino.

Parâmetros de conexão

Ao configuração nesse destino, você deve fornecer as seguintes informações:

  • Amazon Web Serviceschave de acesso e chave secreta: Em Amazon Web Servicesgerar um access key - secret access key par para conceder acesso à plataforma Amazon Kinesis conta. Saiba mais na Documentação do Amazon Web Services.
  • região: Indicar qual Amazon Web Services região para a qual transmitir dados.
  • Nome: Forneça um nome para a conexão com o Amazon Kinesis
  • Descrição: Forneça uma descrição para a conexão com o Amazon Kinesis.
  • fluxo: Forneça o nome de um fluxo de dados existente em seu Amazon Kinesis conta. A Platform exportará dados para esse fluxo.

Ativar segmentos para este destino

Consulte Ativar dados do público-alvo para destinos de exportação de perfil de fluxo para obter instruções sobre como ativar segmentos de público-alvo para este destino.

Comportamento de exportação de perfil

O Experience Platform otimiza o comportamento de exportação do perfil para o destino do Amazon Kinesis, a fim de exportar apenas dados para o seu destino quando ocorrerem atualizações relevantes para um perfil após a qualificação de segmento ou outros eventos significativos. Os perfis são exportados para o seu destino nas seguintes situações:

  • A atualização de perfil foi acionada por uma alteração na associação de segmento para pelo menos um dos segmentos mapeados para o destino. Por exemplo, o perfil se qualificou para um dos segmentos mapeados para o destino ou saiu de um dos segmentos mapeados para o destino.
  • A atualização do perfil foi acionada por uma alteração no mapa de identidade. Por exemplo, um perfil que já se qualificou para um dos segmentos mapeados para o destino foi adicionado a uma nova identidade no atributo do mapa de identidade.
  • A atualização do perfil foi acionada por uma alteração em atributos para pelo menos um dos atributos mapeados para o destino. Por exemplo, um dos atributos mapeados para o destino na etapa de mapeamento é adicionado a um perfil.

Em todos os casos descritos acima, somente os perfis onde as atualizações relevantes ocorreram são exportados para o seu destino. Por exemplo, se um segmento mapeado para o fluxo de destino tiver cem membros e cinco novos perfis se qualificarem para o segmento, a exportação para o seu destino será incremental e incluirá apenas os cinco novos perfis.

Observe que todos os atributos mapeados são exportados para um perfil, independentemente de onde as alterações se encontrem. Portanto, no exemplo acima, todos os atributos mapeados para esses cinco novos perfis serão exportados mesmo se os atributos em si não tiverem sido alterados.

Dados exportados

Seu exportado Experience Platform os dados chegam em Amazon Kinesis no formato JSON. Por exemplo, a exportação abaixo contém um perfil que se qualificou para um determinado segmento e saiu de outro segmento, e inclui o nome do atributo de perfil, o sobrenome, a data de nascimento e o endereço de email pessoal. As identidades desse perfil são ECID e email.

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
    "ups": {
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
        "lastQualificationTime": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Nesta página