Salesforce Marketing Cloud 엔터티에 쓰기 - AWS Glue

Salesforce Marketing Cloud 엔터티에 쓰기

사전 조건 

  • 쓰기 대상 Salesforce Marketing 객체입니다. List나 Campaigns 또는 아래 표에 설명된 다른 엔터티와 같은 객체의 이름을 지정해야 합니다.

  • Salesforce Marketing Cloud 커넥터는 3가지 쓰기 작업을 지원합니다.

    • INSERT

    • UPSERT

    • UPDATE

    UPDATE 및 UPSERT 쓰기 작업을 사용하는 경우 레코드의 외부 ID 필드를 지정하려면 ID_FIELD_NAMES 옵션을 제공해야 합니다.

대상에 지원되는 엔터티:

개체 우선순위 인터페이스(REST, SOAP 등) 삽입 가능 업데이트 가능 업서트 가능
Campaigns P0 REST Y- 단일 Y- 단일 N
콘텐츠 자산 P0 REST Y- 단일, 대량 Y- 단일 N
Contact P1 REST Y- 단일 Y- 단일 N
도메인 확인 P1 REST Y- 단일 Y- 단일, 대량 N
이벤트 알림 콜백 P1 REST Y- 단일 Y- 단일 N
이벤트 알림 구독 P1 REST Y- 단일 Y- 단일 N
메시지 전송 P1 REST Y- 단일 N N
객체 중첩된 태그 P2 REST Y- 단일 Y- 단일 N
시드-목록 P1 REST Y- 단일 Y- 단일 N
설정 P1 REST Y- 단일 Y- 단일 N
데이터 확장 P0 SOAP Y- 단일 Y- 단일 Y- 단일
이메일 P0 SOAP Y- 단일 Y- 단일 N
나열 P0 SOAP Y- 단일 Y- 단일 N
Send 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"
    }