Detalhes da Conexão do Salesforce Marketing Cloud¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8361 do conector.

Começando¶

Suporte à versão do Salesforce Marketing Cloud

Estabelecendo uma Conexão¶

Autenticação para a API REST do Salesforce Marketing Cloud¶

Para conectar, defina Schema descansar". A API REST do Salesforce Marketing Cloud usa o padrão de autenticação OAuth. Para autenticar usando OAuth, você precisará criar um aplicativo para obter o OAuthClientId e OAuthClientSecret propriedades de conexão. Consulte Usando autenticação OAuth para obter um guia de autenticação.

Autenticação para a API SOAP do Salesforce Marketing Cloud¶

A API SOAP do Salesforce Marketing Cloud pode se conectar usando suas credenciais de login ou usando autenticação OAuth.

Para se conectar aos dados usando a autenticação básica (credenciais de login), defina o seguinte:

• User: A conta de usuário do Salesforce Marketing Cloud usada para autenticação.
• Password: A senha utilizada para autenticar o usuário.
• AuthScheme: Defina como Básico.
• UseLegacyAuthentication: Defina como Verdadeiro.

às suas credenciais de login.

Conectando-se às APIs do Salesforce Marketing Cloud¶

Depois de se autenticar na API SOAP ou REST, você estará pronto para se conectar aos dados.

Você pode, opcionalmente, refinar o acesso aos dados usando as seguintes propriedades:

• Instance: A instância da API do Salesforce Marketing Cloud usada. A instância padrão é s7 da API de serviços da Web; no entanto, você pode usar essa propriedade para especificar uma instância diferente.

Usando Autenticação OAuth¶

OAuth requer que o usuário autenticado interaja com o Salesforce Marketing Cloud usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Personalizadas¶

Você precisará registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para o procedimento.

Credenciais Personalizadas¶

Autenticação de Área de Trabalho com Seu Aplicativo OAuth¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha um Token de Acesso OAuth¶

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• APIIntegrationType: Defina isso como Web-App ou Server-to-Server, dependendo de qual você selecionou ao criar seu aplicativo.
• OAuthGrantType: Alternativamente, em vez de definir APIIntegrationType, o OAuthGrantType pode ser configurado diretamente para Code (Web-App) ou Client (Server-to-Server). Pode ser desejável usar OAuthGrantType nos casos em que vários produtos estão sendo usados para manter as coisas consistentes.
• CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

Para criar fontes de dados do Salesforce Marketing Cloud em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Defina como DESLIGADO.
• OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o Segredo do aplicativo nas configurações do aplicativo.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Conecte-se aos dados

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Defina como REFRESH.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Criando um Aplicativo OAuth Personalizado¶

Criar um Aplicativo¶

Você pode seguir o procedimento abaixo para registrar um aplicativo e obter as credenciais do cliente OAuth, o Client ID e o Client Secret:

1. Faça login no Salesforce Marketing Cloud Vá para Marketing Cloud | Administração | Pacotes instalados.
2. Clique em New.
3. Dê um nome e uma descrição ao pacote.
4. Salve o pacote. Depois que o pacote é salvo, você vê detalhes importantes sobre o pacote. Consulte Definições de Pacotes Instalados para obter mais informações sobre cada campo. Você vê o ID do pacote, o segredo de assinatura JWT e a conta de origem apenas para pacotes criados em sua conta.
5. Em Componentes, clique em Add Component.
6. Selecione API Integration.
7. Você deve selecionar Server-to-Server ou Web App como tipo de integração se o pacote suportar funcionalidade aprimorada.
8. Atribua o escopo apropriado para sua integração.
   • Perform server-to-server requests... é selecionado automaticamente para todas as integrações de API.
   • Selecione Perform requests on behalf of the user... se este pacote contiver um aplicativo Marketing Cloud.
   • Selecione o escopo do Marketing Cloud para suas chamadas de API. Atribua apenas o escopo que seu pacote precisa.
9. Salve o componente.
10. Nos detalhes do componente, você pode encontrar o Client ID e Client Secret.

Seleção de Extensões de Dados no SalesforceMarketingCloud¶

O conector oferece a possibilidade de selecionar, inserir, atualizar e excluir dados de extensões de dados como tabelas relacionais. Para consultar uma extensão de dados, basta inserir seu nome no formato DataExtensionObject_Name, em que Name é o nome de sua extensão de dados.

Selecionando Dados de Extensões de Dados¶

SELECT * FROM DataExtensionObject_fsefes3

SELECT * FROM DataExtensionObject_fsefes3 WHERE FieldName1 = 'One'

Observação 1: Todos os filtros que funcionam com tabelas/exibições normais também funcionam com extensões de dados.

Observação 2: se sua conta do Salesforce Marketing Cloud contiver mais de uma unidade de negócios, a entrada ClientID deverá ser especificada. Você pode usar ponto e vírgula (;) para especificar mais de um ClientID.

SELECT * FROM DataExtensionObject_fsefes3 WHERE ClientID = '1234567'

Inserindo Dados em Extensões de Dados¶

INSERT INTO DataExtensionObject_fsefes3(FieldName1, FieldName2, FieldName3) VALUES ('One', 'Two', 'Three')

Atualizando Dados de Extensões de Dados¶

UPDATE DataExtensionObject_secondtest15 SET [Nome] = 'ChangedFromTheApi' WHERE [Endereço E-mail] = 'update_me@gmail.com'

Observação: deve existir uma chave primária para esta extensão de dados para que a atualização funcione.

Excluindo Dados de Extensões de Dados¶

DELETE FROM DataExtensionObject_secondtest15 WHERE [Endereço E-mail] = 'delete_me@gmail.com'

Observação: deve existir uma chave primária para esta extensão de dados para que a exclusão funcione.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector Salesforce Marketing Cloud.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector para Salesforce Marketing Cloud permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Subscriber WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Conector Jitterbit para Salesforce Marketing Cloud modela duas APIs Salesforce Marketing Cloud como bancos de dados relacionais, a API REST e a API SOAP. Colocou o Schema e use as informações em cada seção para selecionar a API adequada com base nas necessidades do seu projeto.

Processamento de consulta colaborativa

O conector transfere o máximo possível do processamento da instrução SELECT para as APIs do Salesforce Marketing Cloud e, em seguida, processa o restante da consultar no conector.

Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Usando a API REST

A API REST oferece acesso mais amplo aos recursos do Salesforce Marketing Cloud. Todas as novas tecnologias do Salesforce Marketing Cloud implementam a API REST. Consulte Modelo de dados REST para as entidades disponíveis na API REST.

Usando a API SOAP

A API SOAP fornece acesso abrangente à maioria das funcionalidades e-mail. A API SOAP usa envelopes SOAP para passar informações entre você e o Salesforce Marketing Cloud. Consulte Modelo de dados SOAP para as entidades disponíveis na API SOAP.

Modelo de Dados REST¶

O conector modela as APIs REST do Salesforce Marketing Cloud como banco de dados Tabelas e Procedimentos Armazenados. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto que facilitam a personalização dos esquemas.

As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Tabelas¶

Tabelas descreve as tabelas disponíveis. As tabelas são definidas estaticamente para modelar ativos, categorias, jornadas e muito mais.

Procedimentos Armazenados¶

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Salesforce Marketing Cloud. Procedimentos armazenados* permitem que você execute operações no Salesforce Marketing Cloud, incluindo download e upload de objetos.

Tabelas¶

O conector modela os dados no Salesforce Marketing Cloud em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Salesforce Marketing Cloud é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas do Salesforce Marketing Cloud¶

Ativos¶

Crie, atualize, exclua e consultar ativos de sua conta do SalesForce Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

Selecione todos os ativos:

SELECT * FROM ASSETS

Recupere um recurso específico:

SELECT * FROM ASSETS WHERE ID=20088

Filtragem avançada do lado do servidor usando 'AND' e 'OR' operadores lógicos são suportados para esta tabela. Você pode verificar nas informações da tabela se a coluna tem filtros compatíveis. Todas as colunas que têm filtros suportados também podem ser classificadas no lado do servidor.

SELECT * FROM ASSETS WHERE (Id=5895 OR Id=19442) AND EnterpriseId=7307527 ORDER BY Name ASC, ID DESC

Inserir

Para criar um ativo, você precisará especificar pelo menos a coluna Name e TypeId.

INSERT INTO ASSETS(TypeID,TypeName,Name) VALUES(207,'templatebasedemail','First_Based_Template_Email_')

Atualizar

Os ativos podem ser modificados fornecendo o ID do ativo e emitindo uma instrução UPDATE.

UPDATE ASSETS SET Description='This is an updated asset.', Data='
  "campaigns": {
    "campaigns": [
      {
        "campaignId": 12345,
        "campaignAssociationId": 2387
      }
    ]
  },
"email": { } ... }'  WHERE ID=19442

Excluir

Os ativos podem ser excluídos fornecendo o ID do ativo e emitindo uma instrução DELETE.

DELETE FROM ASSETS WHERE ID=20027

Colunas¶

Chamadas de Retorno¶

Crie, atualize, exclua e consultar callbacks de notificação de eventos

Informações Específicas da Tabela¶

Selecione

Selecione todos os retornos de chamada:

SELECT * FROM Callbacks

Recupere um retorno de chamada específico:

SELECT * FROM Callbacks WHERE CallbackId=94766

Inserir

Para criar um retorno de chamada, você precisará especificar pelo menos a coluna CallbackName e URL.

INSERT INTO [Chamadas de retorno] (CallbackName, Url) VALUES ('cb1', 'https://example.com')

Atualizar

Os retornos de chamada podem ser modificados fornecendo o CallbackId do retorno de chamada e emitindo uma instrução UPDATE.

UPDATE [Chamadas de retorno] SET CallbackName = 'cb update' WHERE CallbackId = '34cd6cfe-5a21-4f3e-94c5-b6313a6954a4'

Excluir

Os retornos de chamada podem ser excluídos fornecendo o CallbackId do retorno de chamada e emitindo uma instrução DELETE.

DELETE FROM [Chamadas de retorno] WHERE CallbackId = '43841979-7154-4fc4-9789-909dbba3a54f'

Colunas¶

Campanhas¶

Crie, atualize, exclua e consultar Campanhas.

Informações Específicas da Tabela¶

Selecione

Selecione todas as campanhas:

SELECT * FROM Campaigns

Recupere uma campanha específica:

SELECT * FROM Campaigns WHERE ID = '3130'

Inserir

Para criar uma campanha, você precisará especificar pelo menos a coluna Nome.

INSERT INTO [Campanhas] (Name, Description, CampaignCode, Color, Favorite) VALUES ('Test Camp', 'Test Description', 'tst 001', '0000ff', true)

Atualizar

As operações de atualização não são suportadas para esta tabela.

Excluir

As campanhas podem ser excluídas fornecendo o CampaignId da campanha e emitindo uma instrução DELETE.

DELETE FROM [Campanhas] WHERE ID = '5161'

Colunas¶

Categorias¶

Crie, atualize, exclua e consultar categorias (pastas) no Content Builder.

Informações Específicas da Tabela¶

Selecione

Selecione todas as categorias:

SELECT * FROM Categories

Recupere todas as categorias que possuem um ParentId específico:

SELECT * FROM Categories WHERE ParentId=71839

Recuperar uma categoria específica:

SELECT * FROM Categories WHERE Id=94766

Todas as colunas, exceto SharedWith e SharingType, podem ser classificadas no lado do servidor:

SELECT * FROM Categories ORDER BY Name ASC

Inserir

Para criar uma categoria, você precisará especificar pelo menos a coluna Name e ParentId.

INSERT INTO Categories(Name,ParentId,categoryType) VALUES('New New New Folder',71839,'asset')

Atualizar

As categorias podem ser modificadas fornecendo o ID da categoria e emitindo uma instrução UPDATE.

Update Categories SET SharedWith='333,555,888', SharingType='edit', EnterpriseId=12345 WHERE Id=71839

Excluir

As categorias podem ser excluídas fornecendo o ID da categoria e emitindo uma instrução DELETE.

DELETE FROM Categories WHERE Id=94843

Colunas¶

EventDefinitions¶

Crie, exclua e consultar definições de eventos.

Informações Específicas da Tabela¶

Selecione

Recupere todas as definições de evento:

SELECT * FROM EventDefinitions

Recupere uma definição de evento específica:

SELECT * FROM EventDefinitions WHERE Id='9955614b-02e7-4147-91a2-3f5f5fe9d679'

Recupere todas as definições de eventos que estão sendo executadas em um modo específico:

SELECT * FROM EventDefinitions WHERE Mode='Test'

Recupere todas as definições de evento que contêm a frase entre aspas especificada em seus nomes:

SELECT * FROM EventDefinitions WHERE Contains(Name,'Welcome Journey')

Inserir

Para criar uma definição de evento, você precisará especificar pelo menos a coluna Nome e Tipo. DataExtensionId também é obrigatório. Se você não especificar, deverá especificar a coluna Esquema.

INSERT INTO EventDefinitions(Type,Name,DataExtensionId,IsVisibleInPicker) VALUES('Event','FirstEventDefinition','74bc3342-eaca-e711-b98f-38eaa71427a1',true)

Excluir

As definições de eventos podem ser excluídas fornecendo o ID da definição de evento e emitindo uma instrução DELETE.

DELETE FROM EventDefinitions WHERE Id='f10efb9e-cb91-4fc9-be50-c20f00f7f255'

Colunas¶

Propriedades do Mensageiro do Facebook¶

Consulte e crie propriedades do messenger do Facebook.

Informações Específicas da Tabela¶

Selecione

Recupere todas as propriedades registradas do facebook messenger:

SELECT * FROM FacebookMessengerProperties

Recupere uma propriedade específica do Facebook Messenger registrada:

SELECT * FROM FacebookMessengerProperties WHERE PageId='1732555047025799'

Inserir

Para registrar uma nova propriedade do facebook messenger você deve especificar PageId, ApplicationId, ApplicationSecret, PageName, PageAccessToken, CallbackVerifyToken, EndpointUrl e ApiVersion:

INSERT INTO FacebookMessengerProperties(PageId,ApplicationId,ApplicationSecret,PageName,PageAccessToken,EndpointUrl,CallbackVerifyToken,ApiVersion) VALUES('1732555047025799','1093076390764037','03d537gg656gvkbe9b430f002e9c4517','SFMC Engineers','someaccesstoken4fasdcruib213123knubkdnfisdubnu12312ub3pijnb','https://graph.facebook.com/v2.6/me/messages','this_is_the_verify_token','v2.0')

Colunas¶

JornadaAtividades¶

Crie, atualize e consultar atividades de jornada.

Informações Específicas da Tabela¶

Selecione

Recupere as atividades da jornada para a versão mais recente da jornada especificada:

SELECT * FROM JourneyActivities WHERE JourneyId='1cb643b5-3144-4d17-80fa-a1f0035e78e2'

Recuperar atividades de jornada para uma versão de jornada específica:

SELECT * FROM JourneyActivities WHERE JourneyId='1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND JourneyVersion=1

Recupere as atividades de todas as viagens com uma versão específica:

SELECT * FROM JourneyActivities WHERE JourneyVersion=1

Inserir

Para criar uma nova atividade de jornada, você precisará especificar pelo menos a coluna JourneyId, JourneyVersion, Type, Key, Arguments, ConfigurationArguments.

INSERT INTO JourneyActivities(JourneyId,JourneyVersion,Type,Key,Arguments,ConfigurationArguments) VALUES('4753026f-20b2-481b-89c5-fcd76ffa41f7',1,'WAIT','WAITBYDURATION-1','{
  "waitEndDateAttributeDataBound": "",
  "waitDefinitionId": "f3de0c9a-5ff8-4f7b-84bd-9309ca337227",
  "waitForEventId": "",
  "executionMode": "{{Context.ExecutionMode}}",
  "startActivityKey": "{{Context.StartActivityKey}}",
  "waitQueueId": "{{Context.WaitQueueId}}"
}','{
  "waitDuration": 1,
  "waitUnit": "DAYS",
  "specifiedTime": "",
  "timeZone": "",
  "description": "",
  "waitEndDateAttributeExpression": "",
  "specificDate": "",
  "waitForEventKey": ""
}')

Atualizar

As atividades de jornada podem ser modificadas fornecendo o Id, JourneyId, JourneyVersion e emitindo uma instrução UPDATE.

Update JourneyActivities SET Description='First_Journey_Activity_Description', Outcomes='[
  {
    "key": "11bb2807-3f3d-4305-af51-547df032dbaf",
    "next": "WAITBYDURATION-1",
    "arguments": null,
    "metaData": null
  }
]' WHERE Id='fa4c3d81-8043-40e2-9741-22708d3a2e25' AND  JourneyId='4753026f-20b2-481b-89c5-fcd76ffa41f7' AND JourneyVersion=1

Colunas¶

Viagens¶

Crie, atualize, exclua e consultar jornadas.

Informações Específicas da Tabela¶

Selecione

Recupere viagens com a versão mais recente:

SELECT * FROM Journeys

Recuperar uma versão da jornada:

SELECT * FROM Journeys WHERE ID='1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND Version=1

Recupere todas as versões da jornada:

SELECT * FROM Journeys WHERE MostRecentVersionOnly=false

Recupere viagens com uma tag específica:

SELECT * FROM Journeys WHERE Tag='First_Tag'

Recupere viagens que tenham a string de pesquisa especificada dentro do nome ou descrição:

SELECT * FROM Journeys WHERE NameOrDescription='Journey'

Recupere jornadas com versão específica da API de fluxo de trabalho:

SELECT * FROM Journeys WHERE workFlowApiVersion=1

Recuperar viagens com versão específica:

SELECT * FROM Journeys WHERE Version=1

Recuperar viagens com status específico:

SELECT * FROM Journeys WHERE Status='Draft'

Classifique as jornadas de acordo com a data modificada ou coluna de nome:

SELECT * FROM Journeys Order BY ModifiedDate DESC
SELECT * FROM Journeys Order BY Name DESC

Inserir

Para criar uma nova jornada, você precisará especificar pelo menos a coluna Nome.

INSERT INTO Journeys(Name) VALUES('API-Created journey')

Para criar uma nova versão de jornada, você precisará especificar uma chave de jornada existente.

INSERT INTO Journeys(Name,Key) VALUES('API-Created journey Version 3','53bf5ea2-ff59-4c00-a23a-b1e9e333b80c')

Atualizar

As viagens podem ser modificadas fornecendo o Id, Versão da viagem e emitindo uma declaração UPDATE.

UPDATE Journeys SET Name='API-Updated journey' WHERE Id='257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version=5

Excluir

As jornadas podem ser excluídas fornecendo o ID da jornada e emitindo uma instrução DELETE.

DELETE FROM Journeys WHERE Id='53bf5ea2-ff59-4c00-a23a-b1e9e333b80c'

As versões da jornada podem ser excluídas fornecendo o ID, Versão da jornada e emitindo uma instrução DELETE.

DELETE FROM Journeys WHERE Id='257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version=5

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Propriedades do LineMessenger¶

Consultar e criar propriedades do Line Messenger.

Informações Específicas da Tabela¶

Selecione

Recupere todas as propriedades do mensageiro de linha registradas:

SELECT * FROM LineMessengerProperties

Recupere uma propriedade de mensageiro de linha registrada específica:

SELECT * FROM LineMessengerProperties WHERE ID='23493453984234345'

Inserir

Para registrar uma nova propriedade do messenger de linha, você deve especificar ChannelId, ChannelName, ChannelSecret, IsTransactional, IsTestChannel, EndpointUrl e ApiVersion:

INSERT INTO LineMessengerProperties(ChannelId,ChannelName,ChannelSecret,EndpointUrl,IsTransactional,IsTestChannel,IsActive,ApiVersion) VALUES('23493453984234345','SFMC Engineers','03d537gg656gvkbe9b430f002e9c4517','https://example.com/1732555047025799',true,false,true,'v2.0')");

Colunas¶

Assinaturas¶

Crie, atualize, exclua e consultar assinaturas de notificação de eventos.

Informações Específicas da Tabela¶

Selecione

Selecione todas as assinaturas:

SELECT * FROM Subscriptions

Recupere uma assinatura específica:

SELECT * FROM Subscriptions WHERE SubscriptionId=94766

Inserir

Para criar uma assinatura, você precisará especificar pelo menos a coluna SubscriptionName, CallbackId e EventCategoryTypes.

INSERT INTO [Assinaturas] (SubscriptionName, CallbackId, EventCategoryTypes) VALUES ('sajli subscription', '6fb0758b-155d-4968-869d-7a4f5a3ad2fe', '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]')

Atualizar

As assinaturas podem ser modificadas fornecendo o SubscriptionId e a coluna EventCategoryTypes da assinatura e emitindo uma instrução UPDATE.

UPDATE [Assinaturas] SET Status = 'paused', EventCategoryTypes = '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]' WHERE SubscriptionId = 'db1e2af0-807d-463b-96e8-fe3aaa019fdb'

Excluir

As assinaturas podem ser excluídas fornecendo o SubscriptionId da assinatura e emitindo uma instrução DELETE.

DELETE FROM [Assinaturas] WHERE SubscriptionId = '43841979-7154-4fc4-9789-909dbba3a54f'

Colunas¶

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Salesforce Marketing Cloud¶

Tipos de Ativos¶

Obtenha todos os tipos de ativos disponíveis no Salesforce Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

Recupere todos os tipos de ativos:

SELECT * FROM AssetTypes

Colunas¶

Recursos da Campanha¶

Recupere todos os ativos de campanha no Salesforce Marketing Cloud.

Ver Informações Específicas¶

Selecione

Selecione todos os ativos de campanha para uma campanha específica:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130'

Recupere uma campanha específica:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130' AND ID = '3325'

Colunas¶

Contato¶

Recupere contatos no Salesforce Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

Recuperar todos os contatos:

SELECT * FROM Contact

Observação: A maioria das colunas desta tabela é dinâmica, portanto, elas podem não ser iguais às colunas especificadas abaixo porque você pode ter um esquema de contato diferente em sua conta do Salesforce marketing cloud.
Os contatos que estão em um estado excluído, excluindo ou restrito não são recuperados.

Colunas¶

Contatos¶

Recupere todos os contatos no Salesforce Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

Recuperar todos os contatos:

SELECT * FROM Contacts

Observação: A maioria das colunas desta tabela é dinâmica, portanto, elas podem não ser iguais às colunas especificadas abaixo porque você pode ter um esquema de contato diferente em sua conta do Salesforce marketing cloud.
Os contatos que estão em um estado excluído, excluindo ou restrito não são recuperados.

Colunas¶

JourneyAuditLogs¶

Recupera um log de auditoria de uma jornada e suas versões.

Colunas¶

SmsStatusCodes¶

Consultar códigos de status sms.

Informações Específicas da Tabela¶

Selecione

Recupere todos os códigos de status para os seguintes países: EUA, Canadá, Brasil e Índia. Use esses códigos para avaliar e diagnosticar e resolver problemas problemas de envio de SMS.

SELECT * FROM SmsStatusCodes

Colunas¶

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Salesforce Marketing Cloud¶

CreateImportSendDeliveryReport¶

Gera um arquivo .csv contendo informações sobre a entrega de mensagens SMS para uma MessageList específica e coloca o relatório no local de FTP avançado para a conta do Marketing Cloud.

Entrada¶

Colunas do Conjunto de Resultados¶

CriarPalavra-chave¶

Cria uma palavra-chave em uma conta.

Entrada¶

Colunas do Conjunto de Resultados¶

CreateMessageListDeliveryReport¶

Aciona um relatório de entrega para a API messageList.

Entrada¶

Colunas do Conjunto de Resultados¶

CreateOptInMessage¶

Cria uma mensagem SMS opt-in permitindo que os contatos assinem outras mensagens SMS.

Entrada¶

Colunas do Conjunto de Resultados¶

Excluir Palavra-chave¶

Exclui uma palavra-chave em uma conta.

Excluir Palavra-chave por ID¶

Exclui uma palavra-chave em uma conta com um ID de palavra-chave.

EXECUTE DeleteKeyword KeywordId='alm5LXNSSktGMGluRznRb1Rb1R5MDZFQTo4Njow'

Excluir Palavra-chave por Código Longo¶

Exclui uma palavra-chave em uma conta com uma palavra-chave e um código longo.

EXECUTE DeleteKeyword LongCode='5550003232', Keyword='TEST'

Excluir Palavra-chave por Código Curto¶

Exclui uma palavra-chave em uma conta com uma palavra-chave, código curto e código de país.

EXECUTE DeleteKeyword ShortCode='89239', Keyword='TEST', CountryCode='US'

Entrada¶

Colunas do Conjunto de Resultados¶

FireEntryEvent¶

Acione o evento de entrada que inicia a jornada.

Entrada¶

Colunas do Conjunto de Resultados¶

GetChannelViewHtml¶

Retorna o HTML compilado da exibição do canal solicitado para o recurso.

Entrada¶

Colunas do Conjunto de Resultados¶

GetDeliveryStatusOfQueuedMO¶

Recupera o status de entrega de um MO na fila.

Entrada¶

Colunas do Conjunto de Resultados¶

GetFileForAnAsset¶

Obtém o arquivo binário para um ativo.

Entrada¶

Colunas do Conjunto de Resultados¶

GetHeaderFooterAccount¶

Obtém o cabeçalho e o rodapé padrão de uma conta.

Colunas do Conjunto de Resultados¶

GetHeaderFooterEmail¶

Obtém o cabeçalho e o rodapé de um e-mail.

Entrada¶

Colunas do Conjunto de Resultados¶

GetImportSendStatus¶

Recupera o status de uma automação ImportSend.

Entrada¶

Colunas do Conjunto de Resultados¶

GetImportStatus¶

Recupera o status de um trabalho de importação.

Entrada¶

Colunas do Conjunto de Resultados¶

GetJourneyPublicationStatus¶

Recupera o status de uma publicação de jornada.

Entrada¶

Colunas do Conjunto de Resultados¶

GetMessageContactHistory¶

Recupera a última mensagem enviada para um número de celular.

Entrada¶

Colunas do Conjunto de Resultados¶

GetMessageContactStatus¶

Recupera o status geral de entrega de uma mensagem para um contato.

Entrada¶

Colunas do Conjunto de Resultados¶

GetMessageListStatus¶

Retorna o status de uma mensagem enviada para um grupo de números móveis.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAccessToken¶

Obtém um token de autenticação de SalesforceMarketingCloud.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAuthorizationURL¶

Obtém a URL de autorização que deve ser aberta separadamente pelo usuário para conceder acesso ao seu aplicativo. Necessário apenas ao desenvolver aplicativos da Web.

Entrada¶

Colunas do Conjunto de Resultados¶

GetRefreshListStatus¶

Recupera o status da lista de atualização.

Entrada¶

Colunas do Conjunto de Resultados¶

GetSubscriptionStatus¶

Retorna o status da assinatura para números de celular ou chaves de assinante.

EXECUTE GetSubscriptionStatus MobileNumbers='["15555555555"]'
EXECUTE GetSubscriptionStatus SubscriberKeys='["ExampleSubKey1"]'

Entrada¶

Colunas do Conjunto de Resultados¶

GetTrackingHistoryOfQueuedMO¶

Recupera o histórico de rastreamento de um MO enfileirado.

Entrada¶

Colunas do Conjunto de Resultados¶

ImportAndSendMessage¶

Importa e envia.

EXECUTE ImportAndSendMessage MessageId='MessageId'," +
          "Keyword='Test_Keyword'," +
          "NotificationEmail='myEmail@example.com'," +
          "IsDuplicationAllowed=true," +
          "IsDuplicationAllowed=true," +
          "ImportDefinition='[{" +
          "    \"FileName\": \"MyTestList.csv\"," +
          "    \"ImportType\": \"FILE\"," +
          "    \"ImportMappingType\": \"ManualMap\"," +
          "    \"FieldMaps\": [{" +
          "      \"Destination\": \"_FirstName\"," +
          "      \"Source\": \"First Name\"" +
          "    }, {" +
          "      \"Destination\": \"_Subscriberkey\"," +
          "      \"Source\": \"Subscriber Key\"" +
          "    }, {" +
          "      \"Destination\": \"_LastName\"," +
          "      \"Source\": \"Last Name\"" +
          "    }, {" +
          "      \"Destination\": \"_MobileNumber\"," +
          "      \"Source\": \"Mobile\"" +
          "    }, {" +
          "      \"Destination\": \"_CountryCode\"," +
          "      \"Source\": \"Country\"" +
          "    }]" +
"  }]'

Entrada¶

Colunas do Conjunto de Resultados¶

PostMessageToList¶

Inicia uma mensagem para uma ou mais listas de contatos.

EXECUTE PostMessageToList MessageId='NCNSDNsd222as85dj92j2sM',  TargetListIds=' [" +
          "        \"bzZ0cENGam1FZUtNX0poTDRYZzhlQTo2Mzow\"" +
          "    ]', OverrideTemplateTargetLists=true, OverrideTemplateExclusionLists=false, IgnoreExclusionLists=true, OverrideMessageText=false, " +
          "ContentURL='http://image.exct.net/lib/fe6d15707662057c7411/m/1/dj_CC_AUS.jpg'," +
"UtcOffset='-0500', WindowStart='1500', WindowEnd='2200', AllowDuplication=false

Entrada¶

Colunas do Conjunto de Resultados¶

PostMessageToNumber¶

Inicia uma mensagem para um ou mais números móveis.

Assinantes¶

As colunas disponíveis para a tabela temporária Assinantes são as seguintes:

Executar¶

Use números de celular para fazer referência aos registros de contato:

EXECUTE PostMessageToNumber MessageId='NCNSDNsd222as85dj92j2sM', mobileNumbers='[" +
          "    \"13175551212\"" +
"    ]', Subscribe=true, Resubscribe=true, keyword='JOINSMS', Override=true, messageText='Welcome to Code@', ContentURL='http://image.exct.net/lib/abcd/m/1/dj_CC_AUS.jpg', SendTime='2012-10-05 20:01'

Use a tabela Subscribers#Temp como uma maneira alternativa de referenciar registros de contato:

Insert INTO Subscribers#Temp(MobileNumber,SubscriberKey,Attributes) Values('15555554410','ExampleSubKey1','{" +
          "            \"FirstName\":\"Michael\"" +
          "            }')
Insert INTO Subscribers#Temp(MobileNumber,SubscriberKey,Attributes) Values('15555552254','ExampleSubKey2','{" +
          "            \"FirstName\":\"Kristen\"" +
          "            }')          
EXECUTE PostMessageToNumber MessageId='NCNSDNsd222as85dj92j2sM', Subscribe=true, Resubscribe=true, Keyword='JOINSMS', Override=false, SendTime='2012-10-05 20:01' 

Entrada¶

Colunas do Conjunto de Resultados¶

Publicar Jornada¶

Publica uma versão da jornada de forma assíncrona.

Entrada¶

Colunas do Conjunto de Resultados¶

FilaContatoImportar¶

Coloca uma importação de contato na fila.

FieldMaps¶

As colunas disponíveis para a tabela temporária FieldMaps são as seguintes:

Executar¶

Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_MobileNumber',2,'mobile number')
Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_CountryCode',3,'locale')
Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_SubscriberKey',1,'subscriber key')
EXECUTE QueueContactImport ListId='UEhwdktFWXpFZUs3Z3hRUW45R2dBQTo2Mzow', ShortCode='90913', Keyword='WELCOME', SendEmailNotification=true, EmailAddress='example@example.com'," +
"ImportMappingType='MapByOrdinal', FileName='testdata.csv', FileType='csv', IsFirstRowHeader=true

Entrada¶

Colunas do Conjunto de Resultados¶

QueueMoMessage¶

Enfileira uma mensagem MO para envio.

EXECUTE QueueMoMessage MobileNumbers='[" +
          "  \"15555551212\"" +
          "  ]', ShortCode='86288', MessageText='CODETEST'
EXECUTE QueueMoMessage Subscribers='[    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551212\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     },    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551213\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     }   " +
"   ]', ShortCode='86288', MessageText='CODETEST'

Entrada¶

Colunas do Conjunto de Resultados¶

Atualizar Lista¶

Atualiza uma lista.

Entrada¶

Colunas do Conjunto de Resultados¶

RefreshOAuthAccessToken¶

Atualiza o token de acesso OAuth usado para autenticação com SalesforceMarketingCloud.

Entrada¶

Colunas do Conjunto de Resultados¶

SendMessageToRecipient¶

Envie uma mensagem OTT para o destinatário. As redes OTT suportadas são Facebook Messenger e LINE.

Conteúdo da Mensagem¶

Você não pode enviar uma mensagem OTT ao destinatário sem especificar o conteúdo da mensagem. Para criar o conteúdo da mensagem, você deve inserir dados em uma tabela temporária chamada 'MessageContents#TEMP'. As colunas disponíveis para esta tabela temporária são as seguintes:

MessageCustomKeys¶

Você também pode especificar chaves personalizadas de mensagem para passagem na payload da mensagem inserindo dados em uma tabela temporária chamada 'MessageCustomKeys#TEMP'. As colunas disponíveis para esta tabela temporária são as seguintes:

Executar¶

Envio de mensagem do Messenger:

Insert INTO MessageContents#Temp(type,text) Values('text','thanks for purchase')
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='messenger', SenderId='503868699681937', OttId='FBfacdb735074f7c492c0bf190fa99020', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

Diferentes tipos de conteúdo do Messenger:

Insert INTO MessageContents#Temp(type,url,AltUrl,IsReusable,AttachmentId) Values('image','https://example.com/original.jpg','https://example.com/preview.jpg',true,12345)
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='messenger', SenderId='503868699681937', OttId='FBfacdb735074f7c492c0bf190fa99020', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

LINE mensagem enviada:

Insert INTO MessageContents#Temp(type,text) Values('text','thanks for purchase')
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='CanBeAGUIDorAny100UnicodeCharString', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='line', SenderId='2145435435632435', OttId='U42348yafsd8y3248yfsq8cy9088934d', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

Entrada¶

Colunas do Conjunto de Resultados¶

StopJourney¶

Pare uma jornada em execução.

Entrada¶

Colunas do Conjunto de Resultados¶

Modelo de Dados SOAP¶

O conector modela as APIs SOAP do Salesforce Marketing Cloud como banco de dados Tabelas e Visualizações. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto que facilitam a personalização dos esquemas.

As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Tabelas¶

Tabelas descreve as tabelas disponíveis. As tabelas são definidas estaticamente para modelar ativos, categorias, jornadas e muito mais.

Visualizações¶

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições. Procedimentos armazenados* permitem que você execute operações no Salesforce Marketing Cloud, incluindo download e upload de objetos.

Tabelas¶

O conector modela os dados no Salesforce Marketing Cloud em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Salesforce Marketing Cloud é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas do Salesforce Marketing Cloud¶

Conta¶

Uma conta do Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM Account

SELECT * FROM Account WHERE Id = 123

SELECT * FROM Account WHERE Id IN (123, 456)

SELECT * FROM Account WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar a coluna Nome ao executar uma inserção nesta tabela.

INSERT INTO Account(Name) VALUES('Test')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE Account SET Fax='1123123' WHERE Id=123

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM Account WHERE ID = 123

Colunas¶

Usuário da Conta¶

Um usuário individual em uma conta. Esta tabela não suporta exclusões.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM AccountUser

SELECT * FROM AccountUser WHERE Id = 123

SELECT * FROM AccountUser WHERE Id IN (123, 456)

SELECT * FROM AccountUser WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Client_Id, Name, E-mail, UserID e Password.

INSERT INTO AccountUser(Client_Id, UserId, Name, Email, Password) VALUES(123, 'bcabsbasbcasb', 'Test', 'test@gmail.com', 'testpas@2sowrd')

Atualizar

Você deve especificar o ID e o Client_Id na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE AccountUser SET Name='changed' WHERE Id=123 AND Client_Id=456

Colunas¶

Unidade de Negócio¶

Uma unidade dentro de uma conta Enterprise ou Enterprise 2.0 maior. Esta tabela suporta apenas consultas e atualizações.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM BusinessUnit

SELECT * FROM BusinessUnit WHERE Id = 123

SELECT * FROM BusinessUnit WHERE Id IN (123, 456)

SELECT * FROM BusinessUnit WHERE CreatedDate > '2017/01/25'

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE BusinessUnit SET Name='Changed' WHERE Id=123

Colunas¶

Área de Conteudo¶

Uma ContentArea representa uma seção definida de conteúdo reutilizável.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM ContentArea

SELECT * FROM ContentArea WHERE Id = 123

SELECT * FROM ContentArea WHERE Id IN (123, 456)

SELECT * FROM ContentArea WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Nome e Conteúdo.

INSERT INTO ContentArea(Name, Content) VALUES('Testing', 'Hello world')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE ContentArea SET Name='Changed' WHERE Id=123

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM ContentArea WHERE ID = 123

Colunas¶

DataExtension¶

Representa uma extensão de dados em uma conta.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM DataExtension

SELECT * FROM DataExtension WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Name, CustomerKey e Fields.

Observação: as APIs do Salesforce Marketing Cloud têm problemas com DataExtensions com nomes com mais de 40 caracteres. Tente limitar o nome a algo relativamente curto.

INSERT INTO DataExtension (Name, CustomerKey,  Fields) VALUES('TestName', 'TestCustomerKey', 'fieldname1;fieldname2;fieldname3')

Atualizar

Você deve especificar ObjectId ou CustomerKey ou Name na cláusula WHERE ao executar uma atualização nessa tabela.

UPDATE DataExtension SET ResetRetentionPeriodOnImport=true WHERE ObjectId='nzxcaslkjd-123'

Excluir

Você deve especificar ObjectId ou CustomerKey ou Name na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM DataExtension WHERE ObjectId = 'nzxcaslkjd-123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

E-mail¶

Representa um e-mail em uma conta do Marketing Cloud.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM Email

SELECT * FROM Email WHERE Id = 123

SELECT * FROM Email WHERE Id IN (123, 456)

SELECT * FROM Email WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Nome e Assunto.

INSERT INTO Email(Name, Subject) VALUES('Testing', 'Greetings')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE Email SET Name='Changed' WHERE Id=31558

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM Email WHERE ID = 123

Colunas¶

EmailSendDefinition¶

Registro que contém as informações da mensagem, perfil do remetente, perfil de entrega e informações do público.

Informações Específicas da Tabela¶

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM EmailSendDefinition

SELECT * FROM EmailSendDefinition WHERE ObjectID = 123

SELECT * FROM EmailSendDefinition WHERE ObjectID IN (123, 456)

SELECT * FROM EmailSendDefinition WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Name, SendClassification_CustomerKey e Email_Id.

INSERT INTO EmailSendDefinition(Name, SendClassification_CustomerKey, Email_Id) VALUES('Testing', 13507, 31677)

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE EmailSendDefinition SET Description='Changed' WHERE ObjectId='acasascas'

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM EmailSendDefinition WHERE ObjectId = 'sdfsdf123'

Colunas¶