Referência do conector do Salesforce Marketing Cloud

info

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.

Esta página fornece informações de referência técnica para o conector do Salesforce Marketing Cloud.

Objetos suportados

O conector do Salesforce Marketing Cloud é compatível com as seguintes tabelas default (quando source_schema é definido como default):

Nome da tabela	Tipo de atualização
journeys	Incremental
campaigns	Incremental
emails	Incremental
automations	Lotes (não incremental)
push_messages	Incremental
subscribers	Lotes (não incremental)
audit_events	Incremental
security_events	Incremental
click_events	Incremental
sent_events	Incremental
open_events	Incremental
not_sent_events	Incremental
bounce_events	Incremental
unsubscribe_events	Incremental

Para extensões de dados, você deve fornecer a Chave Externa (Chave do Cliente) como o nome source_table. Extensões de dados são somente em lotes (não incrementais).

Transformações automáticas de tipo de dados

O conector transforma os tipos de dados do Salesforce Marketing Cloud em extensões de dados para tipos de dados compatíveis com Delta da seguinte forma:

Salesforce Marketing Cloud tipo	Delta tipo
Texto	string
E-mail	string
Endereço de e-mail	string
Telefone	string
local	string
Número	inteiro
Número Longo	long
Decimal(p, s)	decimal(min(p, 38), min(s, 18))
Booleana	boolean
Data	timestamp_ntz
Byte	Byte

nota

As APIs do Marketing Cloud não fornecem informações sobre o fuso horário dos carimbos de data/hora. Portanto, o conector armazena carimbos de data/hora sem fuso horário (TimestampNTZ).

Campos de autenticação obrigatórios

Ao criar uma conexão do Unity Catalog para o Salesforce Marketing Cloud, forneça os seguintes parâmetros:

campo	Descrição
Subdomínio	O subdomínio de 28 caracteres para sua instância do Marketing Cloud, começando com mc do URI Base de Autenticação (por exemplo, mc1234abcdzz9t0k5l7m8n9p0q)
ID de marketing (MID)	O ID de marketing para sua account, visível no canto superior direito da interface do Salesforce Marketing Cloud
ID do cliente	O ID do cliente do Pacote de Integração de API
Segredo do cliente	O segredo do cliente do Pacote de Integração da API

Schemas para tabelas default

Para esquemas detalhados de todas as tabelas default compatíveis (incluindo nomes de campo e tipos de dados), consulte as seções a seguir:

jornadas

Chave primária composta: (id, version).

campo	Tipo de dados
ID	string
version	inteiro
chave	string
name	string
data da última publicação	carimbo de data/hora
Status	string
Descrição	string
Data de criação	carimbo de data/hora
Data de modificação	carimbo de data/hora
versão da API do fluxo de trabalho	inteiro
atividades	array<struct>
triggers	array<struct>
Objetivos	array<string>
saídas	array<string>
notificadores	array<string>
estatísticas	struct
Status de integridade	struct
entryMode	string
definitionType	string
Canal	string
default	struct
Metadados	string
Modo de execução	string
ID da categoria	inteiro
definitionId	string
Status agendado	string
campanhas	array<string>

campanhas

campo	Tipo de dados
ID	string
Data de criação	carimbo de data/hora
Data de modificação	carimbo de data/hora
name	string
Descrição	string
campaignCode	string
Cor	string
favorito	boolean

email

campo	Tipo de dados
ID	long
customerKey	string
objectID	string
Tipo de conteúdo	string
assetTypeId	inteiro
Nome do tipo de ativo	string
Nome de exibição do tipo de ativo	string
name	string
Proprietário	struct
Criado por	struct
Data de criação	carimbo de data/hora
modificado por	struct
Data de modificação	carimbo de data/hora
enterpriseId	long
Status	string
thumbnailUrl	string
conteúdo	string
conteúdo de visualização do pré-cabeçalho	string
subjectlineViewContent	string
htmlViewContent	string
codificação de caracteres	string

automações

Chave primária composta: (id, view).

A coluna view é uma coluna sintética adicionada pelo conector. Ele distingue entre tipos de registro dentro da mesma entrada de automação (normal vs. targetdes).

campo	Tipo de dados
ID	string
View	string
chave	string
name	string
Descrição	string
ID da categoria	inteiro
Tipo	string
ID do tipo	inteiro
Status	string
statusId	inteiro
programar	struct<typeId: integer, startDate: timestamp_ntz, endDate: timestamp_ntz, scheduledTime: timestamp_ntz>
última hora de execução	timestamp_ntz
lastRunInstanceId	string
Gatilho de automação	struct
gatilho de arquivo	struct
extensões de dados de destino	array<struct>

Tabelas de eventos

Todas as tabelas de eventos (click_events, sent_events, open_events, bounce_events, unsubscribe_events, not_sent_events) compartilham schemas semelhantes com campos incluindo:

• BatchID (inteiro)
• EventDate (carimbo de data/hora)
• SendID (inteiro)
• SubscriberKey (strings)
• TriggeredSendDefinitionObjectID (string)

Os campos adicionais variam por tipo de evento. Para esquemas completos, consulte a documentação da API do Salesforce Marketing Cloud.