Scrivere alle entità Salesforce Marketing Cloud - AWS Glue

Scrivere alle entità Salesforce Marketing Cloud

Prerequisiti

  • Un oggetto di Salesforce Marketing a cui si desidera scrivere. È necessario specificare il nome dell'oggetto, come ad esempio List o Campaigns una qualsiasi delle altre entità descritte nella tabella seguente.

  • Il connettore Salesforce Marketing Cloud supporta tre operazioni di scrittura:

    • INSERT

    • UPSERT

    • UPDATE

    Quando si utilizzano le operazioni di scrittura UPDATE e UPSERT, è necessario indicare l'opzione ID_FIELD_NAMES per specificare il campo ID esterno per i record.

Entità supportate come destinazione:

Entità Priorità Interfaccia (REST, SOAP, ecc.) Può essere Inserted Può essere Updated Può essere Upserted
Campagne P0 REST Y- Singolo Y- Singolo N
Risorse di contenuti P0 REST Y- Singolo, bulk Y- Singolo N
Contatti P1 REST Y- Singolo Y- Singolo N
Verifica del dominio P1 REST Y- Singolo Y- Singolo, bulk N
Callback di notifiche di eventi P1 REST Y- Singolo Y- Singolo N
Iscrizione alle notifiche di eventi P1 REST Y- Singolo Y- Singolo N
Messaggistica P1 REST Y- Singolo N N
Oggetto tag nidificato P2 REST Y- Singolo Y- Singolo N
Seed-List P1 REST Y- Singolo Y- Singolo N
Configurazione P1 REST Y- Singolo Y- Singolo N
Estensione di dati P0 SOAP Y- Singolo Y- Singolo Y- Singolo
E-mail P0 SOAP Y- Singolo Y- Singolo N
Elenco P0 SOAP Y- Singolo Y- Singolo N
Invia P0 SOAP Y- Singolo N N
Abbonato P0 SOAP Y- Singolo Y- Singolo N

Esempio di operazione INSERT per 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"
    }
)

Esempio di operazione INSERT per 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"
    }
)

Esempio di operazione UPDATE per 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"
    }
)

Esempio di operazione UPDATE per 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"
    }
)

Esempio di operazione UPSERT per 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"
    }
)