설명서Audience ManagerAudience Manager 사용 안내서

아웃바운드 템플릿 매크로 outbound-template-macros

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

아웃바운드 템플릿을 만드는 데 사용할 수 있는 매크로를 나열합니다. 여기에는 파일 이름 매크로, 헤더 매크로 및 콘텐츠 매크로가 포함됩니다.

파일 이름 및 파일 헤더 매크로 file-name-header-macros

이 표에서는 파일 이름 및 헤더 필드를 정의하는 데 사용할 수 있는 매크로를 나열하고 설명합니다. 코드 샘플에 대해서는 아웃바운드 매크로 예제를 참조하십시오.

매크로
설명
ASCII_SOH
인쇄되지 않는 ASCII 문자. 컨텐츠의 행 또는 섹션의 시작을 나타냅니다. 파일에서 데이터 열을 구분하는 데 사용할 수도 있습니다.
DPID
데이터 공급자 ID.
MASTER_DPID
사용자 ID 키 데이터 공급자 ID.
NEW_LINE
아웃바운드 주문에 대한 여러 줄 헤더를 만들 수 있습니다.
ORDER_ID
주문/대상 ID.
PID_ALIAS

주문/대상 ID에 대한 별칭입니다.

별칭은 관리자 UI에서 설정됩니다.

SPLITNUM

아웃바운드 파일을 여러 부분으로 분할함을 나타냅니다. 파일 이름의 SPLITNUM 섹션을 0이 앞에 오는 부품 번호로 대체하여 SPLITNUM 섹션에 최소 3자를 지정합니다.

SPLITNUM 매크로는 <> 문자로 둘러싸일 필요가 없습니다.

예: <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>SPLITNUM.csv

s3_123456_9999_full_1566906141001.csv

s3_123456_9999_full_1566906141002.csv

s3_123456_9999_full_1566906141003.csv

위의 예에서 마지막 세 자리(001,002,003)는 SPLITNUM 식별자입니다.

SYNC_MODE

동기화 유형을 나타내며 다음을 포함합니다.

  • full : 전체 동기화.
  • iter : 증분 동기화.
SYNC_TYPE

데이터 전송 방법을 나타내며 다음을 포함합니다.

  • ftp
  • http
  • s3
TAB
구분 기호로 사용되는 이 매크로는 필드 사이에 탭을 삽입합니다.
TIMESTAMP

10자리, UTC, Unix 타임스탬프.

Java 날짜/타임스탬프 서식 규칙에 따라 <TIMESTAMP; format="YYYYMMDDhhmmss"> (으)로 서식을 지정할 수도 있습니다.

콘텐츠 매크로 content-macros

데이터 파일의 내용을 서식 지정하는 데 사용되는 매크로입니다. 코드 샘플에 대해서는 아웃바운드 매크로 예제를 참조하십시오.

매크로
설명
CLOSE_CURLY_BRACKET
닫는 중괄호 } 문자를 삽입합니다.
DP_UUID

데이터 공급자 고유 사용자 식별자 .

아웃바운드 파일에서 데이터를 전송하는 데이터 파트너의 ID입니다.

DP_UUID_LIST
데이터 파트너에 대한 여러 ID가 포함된 목록을 반환합니다. 이 기능은 데이터를 공유할 수 있는 여러 하위 부서 또는 기타 조직 그룹이 있는 대규모 조직이 있는 경우에 유용합니다. 이 매크로는 이러한 하위 그룹의 ID 목록을 반환합니다.
DPID
데이터 공급자 ID.
DPUUIDS

이 매크로의 출력은 데이터 공급자 ID(DPID)를 관련 고유 사용자 ID(DPUUID)에 매핑합니다. 이 매크로에는 출력을 제어하려면 서식 문자열이 있어야 합니다. 샘플 출력은 다음과 유사합니다.

"dpids=dpid1,dpid2,...dpid n|maxMappings= n|format=json"

maxMappings 설정은 매크로가 반환할 매핑의 수를 결정합니다. maxMappings=0 일 때 이 매크로는 지정된 각 DPID에 대한 모든 매핑을 반환합니다. 데이터는 타임스탬프(가장 최근 첫 번째)별로 정렬되며 가장 큰 타임스탬프가 있는 결과를 먼저 반환합니다.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
이러한 매크로 조합은 사용자가 속하고 제거된 세그먼트를 나열하는 조건문을 만듭니다. 두 조건이 모두 충족되지 않거나 데이터가 없으면 빈 문자열을 반환합니다.
MCID
Adobe Experience Cloud ID.
OPEN_CURLY_BRACKET
여는 중괄호 { 문자를 삽입합니다.
OPT_OUT
삭제 예정. 사용하지 마십시오.
ORDER_ID
주문 또는 대상 ID.
OUTPUT_ATTRIBUTE_TYPE
삭제 예정. 사용하지 마십시오.
OUTPUT_ATTRIBUTE_VALUE
1 을(를) 정적 하드 코딩된 값으로 반환합니다.
PID
파트너 ID.
PIDALIAS

주문/대상 ID에 대한 별칭입니다.

별칭은 관리자 UI에서 설정됩니다.

REMOVED_SEGMENT_LIST
제거된 세그먼트 목록(있는 경우)을 반환합니다.
SEGMENT_LIST

목록의 세그먼트 목록을 반환합니다. 다음과 같은 선택적 인수를 허용합니다.

  • segmentId : 세그먼트 ID. 삭제 예정. sid 사용.
  • csegid : 고객 세그먼트 ID. 삭제 예정. sid 사용.
  • sid : 세그먼트 ID
  • type : 데이터를 세그먼트 데이터로 식별하는 정적 하드 코딩된 값인 5 을(를) 반환합니다.
  • alias : 사용되지 않습니다. 사용하지 마십시오.
  • lastUpdateTime : 마지막 세그먼트 멤버십 상태를 나타내는 Unix 타임스탬프가 업데이트되었습니다.
  • lastRealizationTime : 세그먼트가 마지막으로 실현된 시간을 나타내는 Unix 타임스탬프입니다.

매크로 뒤에 있는 중괄호 안에 이 변수를 넣습니다. 예를 들어 이 코드는 파이프 "|" 문자로 결과를 구분합니다. <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator=",">

SET_ATTRIBUTES
1 을(를) 정적 하드 코딩된 값으로 반환합니다.
SYNC_MODE

동기화 유형을 나타내며 다음을 포함합니다.

  • full : 전체 동기화.
  • iter : 증분 동기화.
SYNC_TYPE

데이터 전송 방법을 나타내며 다음을 포함합니다.

  • ftp
  • http
  • s3
TAB
구분 기호로 사용되는 이 매크로는 필드 사이에 탭을 삽입합니다.
TRAIT_LIST

트레이트 목록을 반환합니다. 다음과 같은 선택적 인수를 허용합니다.

  • type : 숫자 ID별로 트레이트 유형을 식별합니다. 반환:

    • DPM 특성(오프라인, 인바운드 작업에 의해 온보딩된)을 식별하는 10 .
    • 규칙 기반 특성(실시간으로, DCS를 통해 온보딩된)을 식별하는 3 .

  • traitId : 트레이트 ID.

  • lastRealized : 트레이트가 마지막으로 실현된 시간입니다. Unix 타임스탬프입니다.

매크로 뒤에 있는 중괄호 안에 이 변수를 넣습니다. 예를 들어 이 코드는 파이프 "|" 문자로 결과를 구분합니다. <TRAIT_LIST:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID
Audience Manager 사용자 ID.
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695