Gravação em entidades do Salesforce Marketing Cloud
Pré-requisitos
Um objeto do Salesforce Marketing no qual você deseja gravar. Você precisará especificar o nome do objeto, como
List
ouCampaigns
, ou qualquer outra entidade descrita na tabela abaixo.O conector do Salesforce Marketing Cloud é compatível com três operações de gravação:
INSERT
UPSERT
UPDATE
Ao usar as operações de gravação
UPDATE
eUPSERT
, você deverá fornecer opçãoID_FIELD_NAMES
para especificar o campo de ID externo para os registros.
Entidades compatíveis para destino:
Entidade | Prioridade | Interface (REST, SOAP etc.) | Pode ser inserido | Pode ser atualizado | Pode ser upserted |
---|---|---|---|---|---|
Campanhas | P0 | REST | S- Único | S- Único | N |
Ativos de conteúdo | P0 | REST | S- Único, em massa | S- Único | N |
Contato | P1 | REST | S- Único | S- Único | N |
Verificação de domínio | P1 | REST | S- Único | S- Único, em massa | N |
Retorno de chamada de notificação de eventos | P1 | REST | S- Único | S- Único | N |
Assinatura de notificação de eventos | P1 | REST | S- Único | S- Único | N |
Sistema de mensagens | P1 | REST | S- Único | N | N |
Tags de objetos aninhados | P2 | REST | S- Único | S- Único | N |
Seed-List | P1 | REST | S- Único | S- Único | N |
Configuração | P1 | REST | S- Único | S- Único | N |
Extensão de dados | P0 | SOAP | S- Único | S- Único | S- Único |
P0 | SOAP | S- Único | S- Único | N | |
Lista | P0 | SOAP | S- Único | S- Único | N |
Enviar | P0 | SOAP | S- Único | N | N |
Assinante | P0 | SOAP | S- Único | S- Único | N |
Exemplo de operação INSERT para REST:
salesforcemarketingcloud _write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Campaigns", "API_VERSION": "v1", "writeOperation" : "INSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" }
Exemplo de operação INSERT para SOAP:
salesforcemarketingcloud _write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "List", "API_VERSION": "v1", "writeOperation" : "INSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" }
Exemplo de operação UPDATE para REST:
salesforcemarketingcloud _write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Campaigns", "API_VERSION": "v1", "writeOperation" : "UPDATE", "ID_FIELD_NAMES": "id", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" }
Exemplo de operação UPDATE para SOAP:
salesforcemarketingcloud _write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "List", "API_VERSION": "v1", "writeOperation" : "UPDATE", "ID_FIELD_NAMES": "id", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" }
Exemplo de operação UPSERT para SOAP:
salesforcemarketingcloud _write = glueContext.write_dynamic_frame.from_options( connection_type="salesforcemarketingcloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "DataExtension/Insert-***E/6*******3", "API_VERSION": "v1", "writeOperation" : "UPSERT", "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com" }