Écriture destinée aux entités Salesforce Marketing Cloud - AWS Glue

Écriture destinée aux entités Salesforce Marketing Cloud

Prérequis

  • Un objet Salesforce Marketing auquel vous souhaitez écrire. Vous devrez spécifier le nom de l’objet tel que List ou Campaigns ou l’une des autres entités décrites dans le tableau ci-dessous.

  • Le connecteur Salesforce Marketing Cloud prend en charge trois opérations d’écriture :

    • INSERT

    • UPSERT

    • UPDATE

    Lorsque vous utilisez les opérations d’écriture UPDATE et UPSERT, vous devez proposer l’option ID_FIELD_NAMES afin de spécifier le champ d’ID externe pour les enregistrements.

Entités prises en charge pour la destination :

Entité Priority (Priorité) Interface (REST, SOAP, etc.) Peut être inséré Peut être mis à jour Peut faire l’objet d’un upsert
Campagnes P0 REST Y- Unique Y- Unique N
Content Assets P0 REST Y- Unique, en bloc Y- Unique N
Contact P1 REST Y- Unique Y- Unique N
Vérification de domaine P1 REST Y- Unique Y- Unique, en bloc N
Event Notification Callback P1 REST Y- Unique Y- Unique N
Event Notification Subscription P1 REST Y- Unique Y- Unique N
Messagerie P1 REST Y- Unique N N
Object Nested Tag P2 REST Y- Unique Y- Unique N
Seed-List P1 REST Y- Unique Y- Unique N
Configuration P1 REST Y- Unique Y- Unique N
Data Extension P0 SOAP Y- Unique Y- Unique Y- Unique
E-mails P0 SOAP Y- Unique Y- Unique N
Liste P0 SOAP Y- Unique Y- Unique N
Envoyer P0 SOAP Y- Unique N N
Subscriber P0 SOAP Y- Unique Y- Unique N

Exemple d’opération INSERT pour 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"
    }
)

Exemple d’opération INSERT pour 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"
    }
)

Exemple d’opération UPDATE pour 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"
    }
)

Exemple d’opération UPDATE pour 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"
    }
)

Exemple d’opération UPSERT pour 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"
    }
)