Salesforce Marketing Cloud エンティティへの書き込み - AWS Glue

Salesforce Marketing Cloud エンティティへの書き込み

前提条件

  • 書き込み先の Salesforce Marketing オブジェクト。List または Campaigns などのオブジェクト名、または以下の表に概説されている他のエンティティのいずれかを指定する必要があります。

  • Salesforce Marketing Cloud コネクタは、次の 3 つの書き込みオペレーションをサポートしています。

    • INSERT

    • UPSERT

    • UPDATE

    UPDATE および UPSERT 書き込みオペレーションを使用する場合は、ID_FIELD_NAMES オプションを指定してレコードの外部 ID フィールドを指定する必要があります。

送信先でサポートされているエンティティ:

エンティティ 優先度 インターフェイス (REST、SOAP など) 挿入可能 更新可能 アップサート可能
キャンペーン P0 REST Y- シングル Y- シングル N
Content Assets P0 REST Y- シングル、バルク Y- シングル N
連絡先 P1 REST Y- シングル Y- シングル N
ドメインの検証 P1 REST Y- シングル Y- シングル、バルク N
Event Notification Callback P1 REST Y- シングル Y- シングル N
Event Notification Subscription P1 REST Y- シングル Y- シングル N
メッセージング P1 REST Y- シングル N N
Object Nested Tag P2 REST Y- シングル Y- シングル N
Seed-List P1 REST Y- シングル Y- シングル N
セットアップ P1 REST Y- シングル Y- シングル N
Data Extension P0 SOAP Y- シングル Y- シングル Y- シングル
E メール P0 SOAP Y- シングル Y- シングル N
リスト P0 SOAP Y- シングル Y- シングル N
送信 P0 SOAP Y- シングル N N
サブスクライバー P0 SOAP Y- シングル Y- シングル N

REST の INSERT オペレーションの例:

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"
    }
)

SOAP の INSERT オペレーションの例:

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"
    }
)

REST の UPDATE オペレーションの例:

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"
    }
)

SOAP の UPDATE オペレーションの例:

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"
    }
)

SOAP の UPSERT オペレーションの例:

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"
    }
)