Escritura en entidades de Salesforce Marketing Cloud - AWS Glue

Escritura en entidades de Salesforce Marketing Cloud

Requisitos previos

  • Un objeto de Salesforce Marketing en el que desea escribir. Deberá especificar el nombre del objeto, por ejemplo, List o Campaigns o cualquiera de las demás entidades que se indican en la siguiente tabla.

  • El conector de Salesforce Marketing Cloud admite tres operaciones de escritura:

    • INSERT

    • UPSERT

    • UPDATE

    Al utilizar las operaciones de escritura UPDATE y UPSERT, debe proporcionar la opción ID_FIELD_NAMES para especificar el campo de ID externo de los registros.

Entidades compatibles para el destino:

Entidad Priority (Prioridad) Interfaz (REST, SOAP, etc.) Se puede insertar Se puede actualizar Se puede actualizar o insertar
Campañas P0 REST Sí Sí: individual N
Activos de contenido P0 REST Sí: individual, masivo Sí: individual N
Contacto P1 REST Sí Sí: individual N
Verificación de dominio P1 REST Sí: individual Sí: individual, masivo N
Devolución de llamadas para notificaciones de eventos P1 REST Sí Sí: individual N
Suscripción a notificaciones de eventos P1 REST Sí Sí: individual N
Mensajería P1 REST Sí N N
Etiqueta anidada de objeto P2 REST Sí Sí: individual N
Lista de semillas P1 REST Sí Sí: individual N
Configuración P1 REST Sí Sí: individual N
Extensión de datos P0 SOAP Sí: individual Sí: individual Sí: individual
Correo electrónico P0 SOAP Sí: individual Sí: individual N
Enumeración P0 SOAP Sí: individual Sí: individual N
Send P0 SOAP Sí: individual N N
Suscriptor P0 SOAP Sí: individual Sí: individual N

Ejemplo de operación 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"
    }
)

Ejemplo de operación 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"
    }
)

Ejemplo de operación 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"
    }
)

Ejemplo de operación 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"
    }
)

Ejemplo de operación 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"
    }
)