Gravação em entidades do Salesforce Marketing Cloud - AWS Glue

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 ou Campaigns, 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 e UPSERT, você deverá fornecer opção ID_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
E-mail 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"
    }