Amazon Kinesis conexão

Visão geral

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.

• Para obter mais informações sobre Amazon Kinesis, consulte o Documentação do Amazon.
• Para conectar-se a Amazon Kinesis programaticamente, consulte o Tutorial da API de destinos de transmissão.
• Para conectar-se a Amazon Kinesis usando a interface do usuário da Platform, consulte as seções abaixo.

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 e frequência de exportação

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Endereço IP lista de permissões

Para atender aos requisitos de segurança e conformidade dos clientes, o Experience Platform fornece uma lista de IPs estáticos que você pode lista de permissões a Amazon Kinesis destino. Consulte LISTA DE PERMISSÕES de endereço IP para destinos de transmissão para obter a lista completa de IPs a serem lista de permissões.

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/*"
            ]
        }
    ]
}

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. Ao se conectar a esse destino, você deve fornecer as seguintes informações:

Informações de autenticação

Insira os campos abaixo e selecione Ligar ao destino:

• 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.

Preencha os detalhes do destino

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

• 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.
• Incluir nomes de segmentos: Alterne se deseja que a exportação de dados inclua os nomes dos segmentos que você está exportando. Para obter um exemplo de exportação de dados com essa opção selecionada, consulte Dados exportados mais abaixo.
• Incluir carimbos de data e hora do segmento: Alterne se deseja que a exportação de dados inclua o carimbo de data e hora UNIX quando os segmentos foram criados e atualizados, bem como o carimbo de data e hora UNIX quando os segmentos foram mapeados para o destino para ativação. Para obter um exemplo de exportação de dados com essa opção selecionada, consulte Dados exportados mais abaixo.

Ativar alertas

Você pode habilitar alertas para receber notificações sobre o status do fluxo de dados para seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o guia sobre inscrever-se em alertas de destinos usando a interface do usuário.

Quando terminar de fornecer detalhes para a conexão de destino, selecione Próximo.

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 seu Amazon Kinesis , para exportar somente dados para seu destino quando ocorrerem atualizações relevantes de 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 determinada 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 determinada 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 determinada por uma alteração nos 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.

O que determina uma exportação de dados e o que está incluído na exportação

Com relação aos dados exportados para um determinado perfil, é importante entender os dois conceitos diferentes de o que determina a exportação de dados para o Amazon Kinesis destino e que dados estão incluídos na exportação.

Por exemplo, considere esse fluxo de dados como um Amazon Kinesis destino onde três segmentos são selecionados no fluxo de dados e quatro atributos são mapeados para o destino.

Uma exportação de perfil para o destino pode ser determinada por um perfil que se qualifica para ou sai de um dos três segmentos mapeados. No entanto, na exportação de dados, no segmentMembership objeto (consulte Dados exportados seção abaixo), outros segmentos não mapeados podem aparecer, se esse perfil específico for membro deles e se compartilharem a mesma política de mesclagem do segmento que acionou a exportação. Se um perfil se qualificar para a variável Cliente com Carros da Coreia , mas também é membro do Assistiu ao "Regresso ao Futuro" filme e Fãs de ficção científica , esses outros dois segmentos também estarão presentes na variável segmentMembership objeto da exportação de dados, mesmo que não estejam mapeados no fluxo de dados, se eles compartilharem a mesma política de mesclagem com a Cliente com Carros da Coreia segmento.

Do ponto de vista dos atributos do perfil, qualquer alteração nos quatro atributos mapeados acima determinará uma exportação de destino e qualquer um dos quatro atributos mapeados presentes no perfil estará presente na exportação de dados.

Preenchimento retroativo de dados históricos

Ao adicionar um novo segmento a um destino existente ou ao criar um novo destino e mapear segmentos a ele, o Experience Platform exporta os dados de qualificação de segmento históricos para o destino. Perfis que se qualificaram para o segmento before o segmento adicionado ao destino é exportado para o destino dentro de aproximadamente uma hora.

Dados exportados

Seu exportado Experience Platform os dados chegam ao seu Amazon Kinesis destino no formato JSON. Por exemplo, a exportação abaixo contém um perfil que se qualificou para um determinado segmento, é um membro de outros dois segmentos e saiu de outro segmento. A exportação também inclui o atributo de perfil nome, sobrenome, data de nascimento e 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":"2022-01-11T21:24:39Z",
         "status":"exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
         "lastQualificationTime":"2022-01-02T23:37:33Z",
         "status":"existing"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"existing"
      },
      "5114d758-ce71-43ba-b53e-e2a91d67b67f":{
         "lastQualificationTime":"2022-01-11T23:37:33Z",
         "status":"realized"
      }
   }
},
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Abaixo estão outros exemplos de dados exportados, dependendo das configurações da interface do usuário selecionadas no fluxo de destino de conexão para a variável Incluir nomes de segmentos e Incluir carimbos de data e hora do segmento opções:

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Limites e política de repetição

Em 95% das vezes, o Experience Platform tenta oferecer uma latência de taxa de transferência inferior a 10 minutos para mensagens enviadas com êxito com uma taxa inferior a 10 mil solicitações por segundo para cada fluxo de dados para um destino HTTP.

No caso de solicitações com falha no destino da API HTTP, o Experience Platform armazena as solicitações com falha e tenta novamente duas vezes para enviar as solicitações para o terminal.

Recursos do Business.Adobe.com