Referência do conector Marketo

info

Beta

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Encontre informações de referência para o conector Marketo, incluindo tabelas suportadas, opções de conector e esquemas de destino.

Tabelas de origem compatíveis

O conector Marketo suporta as seguintes tabelas de origem:

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
leads	id	Registros de pessoas na sua instância do Adobe Marketo Engage, incluindo campos de identidade, demográficos e de pontuação de leads. Ingerido por meio da API Bulk Extract.	Incremental	updatedAt
static_lists	id	Listas estáticas usadas para segmentação e direcionamento de público. Ingerido por meio da API REST.	Apenas refresh completo
activity_<typeId>	marketoGUID	Uma tabela por tipo de atividade do Adobe Marketo Engage, em que <typeId> é o ID numérico do tipo de atividade (por exemplo, activity_1). Cada tabela compartilha um conjunto de colunas fixas e adiciona colunas de atributos específicas do tipo. Ingerido por meio da API de extração em massa (Bulk Extract API).	Incremental	activityDate
<customObjectApiName>	marketoGUID	Uma tabela por objeto personalizado, nomeada pelo seu nome de API do Adobe Marketo Engage. O esquema é descoberto no momento da execução. Ingerido por meio da API de extração em massa (Bulk Extract API).	Incremental	updatedAt

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
leads	id	Registros de pessoas na sua instância do Adobe Marketo Engage, incluindo campos de identidade, demográficos e de pontuação de leads. Ingerido por meio da API Bulk Extract.	Incremental	updatedAt
static_lists	id	Listas estáticas usadas para segmentação e direcionamento de público. Ingerido por meio da API REST.	Apenas refresh completo
activity_<typeId>	marketoGUID	Uma tabela por tipo de atividade do Adobe Marketo Engage, em que <typeId> é o ID numérico do tipo de atividade (por exemplo, activity_1). Cada tabela compartilha um conjunto de colunas fixas e adiciona colunas de atributos específicas do tipo. Ingerido por meio da API de extração em massa (Bulk Extract API).	Incremental	activityDate
<customObjectApiName>	marketoGUID	Uma tabela por objeto personalizado, nomeada pelo seu nome de API do Adobe Marketo Engage. O esquema é descoberto no momento da execução. Ingerido por meio da API de extração em massa (Bulk Extract API).	Incremental	updatedAt

Opções de conector

Defina a seguinte opção em um objeto de tabela na sua definição de pipeline. Consulte Definir a data de início da sincronização inicial.

Opção

Descrição

sync_start_date

A data de início da sincronização inicial, no formato YYYY-MM-DD. Esta é a data mais antiga a partir da qual se pode sincronizar data histórica. Se você não configurar isso, o conector importará dois anos de histórico por default. Essa opção se aplica somente ao preenchimento inicial: após a primeira sincronização de uma tabela, alterá-la não terá efeito, a menos que você execute uma full refresh.

Opção

Descrição

sync_start_date

A data de início da sincronização inicial, no formato YYYY-MM-DD. Esta é a data mais antiga a partir da qual se pode sincronizar data histórica. Se você não configurar isso, o conector importará dois anos de histórico por default. Essa opção se aplica somente ao preenchimento inicial: após a primeira sincronização de uma tabela, alterá-la não terá efeito, a menos que você execute uma full refresh.

Esquemas de tabela de destino

leads

Chave primária: id Campo do cursor: updatedAt

campo	Tipo de dados
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

campo	Tipo de dados
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

static_lists

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

campo	Tipo de dados
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

activity_<typeId>

Chave primária: marketoGUID Campo do cursor: activityDate

Cada tabela de atividade inclui as seguintes colunas fixas:

campo	Tipo de dados
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

campo	Tipo de dados
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

Cada tabela de atividade também adiciona uma coluna por atributo definido para esse tipo de atividade no Adobe Marketo Engage. O conector descobre esses atributos a partir dos metadados do Adobe Marketo Engage, mantém seus nomes originais e associa seus tipos usando o mapeamento de tipo de dados do Adobe Marketo Engage para tipo Spark.

<customObjectApiName>

Chave primária: marketoGUID Campo do cursor: updatedAt

Os esquemas de objetos personalizados são descobertos em tempo de execução a partir do Adobe Marketo Engage e variam de acordo com a instância. Cada tabela de objeto personalizado inclui marketoGUID, createdAt e updatedAt, seguidos pelos campos específicos do objeto definidos em sua inscrição. Os tipos de campo seguem o mapeamento de tipo de dados do Adobe Marketo Engage para tipo Spark.

Mapeamento de tipo de dados do Adobe Marketo Engage para tipo Spark

O conector mapeia os tipos de dados do Adobe Marketo Engage para tipos Spark para todas as colunas descobertas em tempo de execução, como atributos de atividade e campos de objeto personalizados. A correspondência não diferencia maiúsculas de minúsculas.

Tipo de dados do Adobe Marketo Engage	Tipo Spark
integer	BIGINT
string, text, email, url, phone, reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
Qualquer outro tipo	STRING

Tipo de dados do Adobe Marketo Engage	Tipo Spark
integer	BIGINT
string, text, email, url, phone, reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
Qualquer outro tipo	STRING