DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

RainFocus

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor
NOTE
A origem RainFocus está na versão beta. Leia a visão geral das fontes para obter mais informações sobre o uso de fontes com rótulo beta.

O RainFocus é uma plataforma que você pode usar para promover seus eventos e criar seus públicos. Você pode usar o RainFocus para criar belas páginas promocionais, acompanhar o desempenho da campanha e otimizar as conversões de registro.

Use a fonte RainFocus no Adobe Experience Platform e no Real-time Customer Data Platform para enriquecer automaticamente seus perfis de dados do cliente com eventos de experiência do participante em tempo real. Depois de ativados, os eventos de experiência são transmitidos automaticamente para o Real-Time CDP, permitindo uma poderosa segmentação de público, análise de dados e ativação da jornada de participantes com destinos e aplicativos downstream, como Customer Journey Analytics e Adobe Journey Optimizer.

IMPORTANT
Este conector de origem e página de documentação são criados e mantidos pela equipe RainFocus. Para fazer consultas ou solicitações de atualização, entre em contato diretamente com o clientcare@rainfocus.com ou visite a RainFocus Central de ajuda

Pré-requisitos

Você deve atender aos seguintes pré-requisitos para ativar a integração do RainFocus no Experience Platform:

Criar uma Conta de Serviço (JWT) da Adobe no Portal do Adobe Developer

IMPORTANT
O Adobe anunciou recentemente a desativação de tokens JWT em favor do OAuth. Para acomodar essa alteração, a origem RainFocus será migrada para OAuth em breve.

Coletar credenciais necessárias

Para conectar RainFocus ao Experience Platform, você deve fornecer valores para as seguintes propriedades de conexão em RainFocus:

Credencial
Descrição
Exemplo
ID de cliente
A ID do cliente pode ser obtida da conta de serviço da Adobe no Adobe Developer Portal.
b9c32a63e7d41a0f87d3e8b52a16e7a2
Segredo do cliente
O segredo do cliente pode ser obtido na conta de serviço da Adobe no Adobe Developer Portal.
k1b-p-umplcjtg_arnw-R-Bx44bybu
ID da conta técnica
A ID da conta técnica pode ser obtida da conta de serviço da Adobe no Adobe Developer Portal.
B3F9D2E8A64C573D21ABFE97@techacct.adobe.com
ID da organização
A ID da organização pode ser obtida da conta de serviço da Adobe no portal do Adobe Developer
D9A6F3BCE82FD147C50E3A19@techacct.adobe.com

Criar um esquema XDM e definir o campo de identidade create-an-xdm-schema-and-define-the-identity-field

Para armazenar os Eventos de Experiência de RainFocus no Experience Platform, você deve criar um esquema do Experience Data Model (XDM) para descrever um conjunto de dados que pode armazenar os possíveis campos e tipos de dados que serão enviados de RainFocus.

O RainFocus recomenda os seguintes campos, que abrangem todos os dados possíveis enviados por padrão.

Os seguintes grupos de campos também são recomendados (indicados pelo prefixo ):

  • Participante
  • Expositor
  • Lead
  • Session
  • HoraSessão

O esquema deve conter os seguintes campos:

Campo
Tipo
Exemplo
Descrição
attendee.registered
String
Sim
Um sinalizador que determina se o participante deve ser registrado.
attendee.attendeeId
String
1619119968857001fvLB
A ID de participante em RainFocus.
attendee.externalId
String
1666809456617001wyPj
A ID externa especificada por uma organização.
attendee.clientId
String
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
A ID do cliente SSO do participante.
attendee.email
String
usuário@company.com
O endereço de email do participante.
transmissionId
String
1680309557133001YHhz
Um identificador exclusivo usado para push de dados.
eventType
String
SessãoAgendada
O nome do Evento de Experiência do Participante.
timestamp
DateTime
2023-04-01T00:41:57.000Z
O carimbo de data e hora do push de dados.
event.name
String
Adobe Summit 2023
O nome do evento no qual uma transmissão ocorreu.
exhibitor.exhibitorId
String
1680309557133001YHhz
O identificador RainFocus do exibidor.
exhibitor.externalId
String
1666809514105001lSJN
O identificador do exibidor no sistema cliente.
exhibitor.name
String
IBM
O nome do expositor.
lead.leadId
String
1666809456617001wyPj
O identificador RainFocus do cliente potencial.
lead.note
String
session.sessionId
String
1666809373585001t4aV
O identificador RainFocus da sessão.
session.externalId
String
1666809456617001wyPj
O identificador da sessão no sistema cliente.
session.code
String
GS3
O código da sessão.
session.title
String
Palestra de inspiração
O título da sessão.
session.length
Número inteiro
90
A duração da sessão.
sessiontime.sessiontimeId
String
1673033149739001OJLZ
O identificador RainFocus para o tempo de sessão.
sessiontime.startTime
String
22/03/2023 10:00:00
A hora de início da sessão.
sessiontime.endTime
String
22/03/2023 10:00:00
A hora final da sessão.
sessiontime.room
String
B32
A sala usada para a sessão.

Para criar seu esquema para dados do RainFocus, leia a documentação a seguir para obter as etapas sobre como criar um esquema usando APIs ou a interface do usuário.

IMPORTANT
  • O esquema deve estender a classe XDM ExperienceEvent.
  • Você deve garantir que o esquema inclua uma identidade primária e esteja habilitado para o Perfil. Para obter mais informações, leia o manual sobre definição de campos de identidade na interface
  • Você pode substituir o exemplo de identidade (Email) por outro identificador apropriado, como um email sha256 ou ECID.

Criar um perfil de integração no RainFocus create-an-integration-profile-in-rainfocus

Quando a conta de serviço e o esquema XDM estiverem prontos, você poderá ativar o Integration Profile por meio da plataforma RainFocus. O Integration Profile é responsável pela transmissão de dados para o Experience Platform.

Faça logon na RainFocus plataforma. Na navegação principal, selecione Libraries e, em seguida, Integration Profiles

A interface do usuário RainFocus com Bibliotecas e Perfis de Integração selecionados.

Para criar um novo perfil, selecione o ícone (+). Em seguida, selecione Adobe Real-time Customer Data Platform e OK.

A janela Criar perfil de integração na interface do usuário do RainFocus.

Em seguida, forneça as credenciais recuperadas no Projeto do portal do Adobe Developer:

  • ID do cliente
  • Segredo do cliente
  • ID da Conta Técnica
  • ID da organização

Depois que as credenciais forem fornecidas, selecione Save.Agora você deve ver o novo Integration Profile listado no painel RainFocus.

Selecione o Integration Profile que você acabou de criar para ver uma lista de tipos de push predefinidos já configurados. Estes são os Eventos de Experiência que serão enviados para o Experience Platform quando ocorrerem.

Uma lista de tipos de push predefinidos no painel RainFocus.

Para recuperar uma cópia da carga JSON de amostra, selecione Sample JSON Payload. Em seguida, destaque e copie a amostra de carga JSON e salve-a em um novo arquivo com uma extensão .json. Isso será usado posteriormente no Experience Platform para configurações de mapeamento.

Uma amostra de carga JSON no painel RainFocus.

TIP
A instalação ainda não foi concluída: depois que o fluxo de dados for criado, você precisará retornar ao painel RainFocus para concluir o Integration Profile fornecendo a URL do ponto de extremidade de streaming e a ID do fluxo de dados.

Próximas etapas

Ao ler este documento, você concluiu a configuração de pré-requisito necessária para transmitir dados da sua conta do RainFocus para o Experience Platform. Agora você pode prosseguir para o guia em conectando RainFocus ao Experience Platform usando a interface de usuário.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089