Conceitos do conector do Salesforce Marketing Cloud
Beta
Este recurso está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Saiba como o conector do Salesforce Marketing Cloud funciona.
Como o conector funciona
O conector do Salesforce Marketing Cloud usa autenticação OAuth Server-to-Server para se conectar à API do Marketing Cloud. Depois de criar uma conexão do Unity Catalog e configurar um pipeline de ingestão, o conector recupera dados do Salesforce Marketing Cloud e os grava em tabelas Delta no Unity Catalog.
O conector oferece suporte tanto à ingestão incremental para muitas tabelas quanto a atualizações em lotes para outras. Para tabelas com suporte incremental, o conector rastreia as alterações e recupera apenas registros novos ou modificados em execuções de pipeline subsequentes. Para tabelas somente em lotes, o conector realiza um refresh completo em cada atualização de pipeline.
Esquemas de origem
O conector do Salesforce Marketing Cloud usa o parâmetro source_schema para diferenciar entre os diferentes tipos de dados. É possível listar várias tabelas com diferentes esquemas de origem no mesmo pipeline.
A tabela a seguir descreve os valores disponíveis do esquema de origem:
Esquema de origem | Descrição |
|---|---|
| Injerir tabelas principais como Campanhas, Cliques, Jornadas e outros objetos integrados do Marketing Cloud |
| Ingira extensões de dados padrão que armazenam dados de assinantes, segmentos e dados relacionais |
| Ingerir extensões de dados padrão compartilhadas de uma unidade de negócios para outra |
| Ingira extensões de dados sincronizadas automaticamente do Salesforce CRM para o Marketing Cloud (contatos, leads, etc.) |
| Ingerir extensões de dados criadas por integrações do Salesforce (eventos de dados do Salesforce, objetos do Salesforce) |
| Ingira extensões de dados do Salesforce compartilhadas entre unidades de negócios |
Observação : o Databricks recomenda a ingestão de extensões de dados do Salesforce e do Salesforce Compartilhado usando o conector do Salesforce do Lakeflow Connect. O conector do Salesforce Marketing Cloud não pode ingerir essas extensões de dados incrementalmente, mas o conector do Salesforce pode.
Extensões de dados
Extensões de dados são tabelas no Salesforce Marketing Cloud que armazenam dados de assinantes, segmentos e relacionais. O conector oferece suporte à ingestão de vários tipos de extensões de dados:
- Extensões de dados padrão : tabelas personalizadas para armazenar dados de marketing
- Extensões de dados compartilhadas : extensões de dados compartilhadas entre unidades de negócios
- Extensões de dados sincronizadas : tabelas sincronizadas automaticamente do Salesforce CRM
- Extensões de dados do Salesforce : tabelas criadas por integrações do Salesforce
Ao ingerir extensões de dados, é necessário fornecer a External Key (Customer Key) como o nome source_table. Usar o nome de exibição em vez da Key Externa fará com que o pipeline falhe.
Keys primárias e acompanhamento de história
Se uma key primária for definida na extensão de dados de origem, o conector usará essa key durante a ingestão. Se nenhuma key primária for definida, o conector adicionará automaticamente uma coluna chamada __databricks_id, que é um hash de todas as colunas e é usada como a key primária.
Quando __databricks_id for usado, o acompanhamento da história (SCD Tipo 2) não é suportado para essa tabela. Se a tabela estiver configurada para ingerir no modo SCD Tipo 2, a ingestão falhará.
Nomenclatura da tabela de destino
Se o senhor não fornecer um nome destination_table, o conector nomeará as tabelas automaticamente com base no source_schema:
Esquema de origem | Nome da tabela de destino default |
|---|---|
| O mesmo que o nome da tabela de origem |
|
|
|
|
|
|
|
|
|
|
Observação : O Databricks normaliza automaticamente os nomes de exibição das extensões de dados, substituindo espaços e hífens por sublinhados para compatibilidade com o Delta.
Por exemplo, a tabela de destino que contém os dados da extensão de dados padrão com nome de exibição src_de_c6035790 será denominada de_src_de_c6035790, a menos que você forneça um nome destination_table diferente.
Unidades de negócios
A API do Marketing Cloud retorna dados para uma única unidade de negócios, incluindo unidades de negócios filhas. Se você tiver várias unidades de negócios, deverá criar conexões separadas do Unity Catalog e configurar pacotes de integração de API separados para cada uma.