Azure Event Hubs conexão

Visão geral

IMPORTANTE

Este destino só está disponível para Real-time Customer Data Platform Ultimate clientes.

Azure Event Hubs O é uma grande plataforma de transmissão de dados e um serviço de assimilação de eventos. Ele pode receber e processar milhões de eventos por segundo. Os dados enviados para um hub de eventos podem ser transformados e armazenados usando qualquer provedor de análise em tempo real ou adaptadores de armazenamento/agrupamento.

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

AWS Kinesis na interface do usuário

Casos de uso

Ao usar destinos de transmissão, como Azure Event Hubs, 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 Azure Event Hubs , você receberia esse evento em Azure Event Hubs. 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.

Item Tipo Notas
Tipo de exportação Baseado em perfil Você está exportando todos os membros de um segmento, junto com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), conforme escolhido na tela selecionar atributos de perfil do fluxo de trabalho de ativação de destino.
Frequência de exportação Streaming Os destinos de transmissão são conexões "sempre ativas" baseadas em API. Assim que um perfil é atualizado no Experience Platform com base na avaliação do segmento, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de transmissão.

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 Azure Event Hubs 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.

Conecte-se ao destino

IMPORTANTE

Para se conectar ao destino, é necessário Gerenciar destinos permissão de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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

Autenticação padrão

Imagem da tela da interface do usuário que mostra os campos preenchidos para os detalhes de autenticação padrão do Hubs de Eventos do Azure

Se você selecionar a variável Autenticação padrão digite para se conectar ao terminal HTTP, insira os campos abaixo e selecione Ligar ao destino:

  • Nome da chave SAS: O nome da regra de autorização, que também é conhecida como o nome da chave SAS.
  • Chave SAS: A chave primária do namespace de Hubs de Eventos. O sasPolicy que sasKey corresponde a deve ter gerenciar direitos configurados para que a lista Hubs de eventos seja preenchida. Saiba mais sobre como autenticar para Azure Event Hubs com chaves SAS no Documentação do Microsoft.
  • Namespace: Preencha o Azure Event Hubs namespace. Saiba mais sobre Azure Event Hubs namespaces no Documentação do Microsoft.

Autenticação SAS (Shared Access Signature)

Imagem da tela da interface do usuário que mostra os campos preenchidos para os detalhes de autenticação padrão do Hubs de Eventos do Azure

Se você selecionar a variável Autenticação padrão digite para se conectar ao terminal HTTP, insira os campos abaixo e selecione Ligar ao destino:

  • Nome da chave SAS: O nome da regra de autorização, que também é conhecida como o nome da chave SAS.
  • Chave SAS: A chave primária do namespace de Hubs de Eventos. O sasPolicy que sasKey corresponde a deve ter gerenciar direitos configurados para que a lista Hubs de eventos seja preenchida. Saiba mais sobre como autenticar para Azure Event Hubs com chaves SAS no Documentação do Microsoft.
  • Namespace: Preencha o Azure Event Hubs namespace. Saiba mais sobre Azure Event Hubs namespaces no Documentação do Microsoft.
  • Namespace: Preencha o Azure Event Hubs namespace. Saiba mais sobre Azure Event Hubs namespaces no Documentação do Microsoft.

Detalhes do destino

Após estabelecer a conexão de autenticação com o destino do Hubs de Eventos do Azure, forneça as seguintes informações para o destino:

Imagem da tela da interface do usuário que mostra os campos preenchidos para os detalhes de destino dos Hubs de Eventos do Azure

  • Nome: Preencha um nome para a conexão com o Azure Event Hubs.
  • Descrição: Forneça uma descrição da conexão. Exemplos: "Clientes Premium", "Clientes interessados em cozinha".
  • eventHubName: Forneça um nome para o fluxo para sua Azure Event Hubs destino.
  • 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 segmentos para este destino

IMPORTANTE

Para ativar os dados, é necessário Gerenciar destinos, Ativar destinos, Exibir perfis e Exibir segmentos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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 Azure Event Hubs , 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 Azure Event Hubs destino e que dados estão incluídos na exportação.

O que determina uma exportação de destino O que está incluído na exportação de destino
  • Atributos e segmentos mapeados servem como a dica para uma exportação de destino. Isso significa que, se qualquer segmento mapeado alterar estados (de nulo para realizado ou de realizado/existente para existente) ou se qualquer atributo mapeado for atualizado, uma exportação de destino será iniciada.
  • Como as identidades não podem ser mapeadas para Azure Event Hubs destinos, as alterações em qualquer identidade em um determinado perfil também determinam exportações de destino.
  • Uma alteração para um atributo é definida como qualquer atualização no atributo, independentemente de ser ou não o mesmo valor. Isso significa que uma substituição em um atributo é considerada uma alteração mesmo que o valor em si não tenha sido alterado.
  • Todos os segmentos (com o status de associação mais recente), independentemente de estarem ou não mapeados no fluxo de dados, são incluídos na variável segmentMembership objeto.
  • Todas as identidades na identityMap também são incluídos (no momento, o Experience Platform não suporta mapeamento de identidade na Azure Event Hubs destino).
  • Somente os atributos mapeados são incluídos na exportação de destino.

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

Fluxo de dados de destino do Amazon Kinesis

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. Se um perfil se qualificar para o segmento Cliente com Carros coreanos, mas também for membro do filme "Voltar ao futuro" assistido e dos segmentos de fãs de ficção científica, esses dois outros segmentos também estarão presentes segmentMembership objeto da exportação de dados, mesmo que não estejam mapeados no fluxo de dados.

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 Azure Event Hubs 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:

 A amostra de exportação de dados abaixo inclui nomes de segmentos na segmentMembership seção
"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"
          }
        }
      }
 A amostra de exportação de dados abaixo inclui carimbos de data e hora do segmento na segmentMembership seção
"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.000 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.

Nesta página