메시지 포맷
사전 요구 사항 - Adobe Experience Platform 개념 prerequisites
Adobe 측의 메시지 포맷 및 프로필 구성 및 변환 프로세스를 이해하려면 다음 Experience Platform 개념을 숙지하십시오.
- XDM(경험 데이터 모델). XDM 개요 및 Adobe Experience Platform에서 XDM 스키마를 만드는 방법.
- 클래스. UI에서 클래스를 만들고 편집합니다.
- IdentityMap. ID 맵은 Adobe Experience Platform의 모든 최종 사용자 ID의 맵을 나타냅니다. XDM 필드 사전의
xdm:identityMap을(를) 참조하세요. - SegmentMembership segmentMembership XDM 특성은 프로필이 멤버인 대상을 알려줍니다.
status필드의 세 가지 다른 값에 대해 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 설명서를 읽어 보십시오.
지원되는 통합 유형 supported-integration-types
이 페이지에 설명된 기능을 지원하는 통합 유형에 대한 자세한 내용은 아래 표를 참조하십시오.
개요 overview
이 페이지에서는 Adobe Experience Platform에서 대상으로 내보낸 데이터의 메시지 형식 및 프로필 변형을 다룹니다.
Adobe Experience Platform은 데이터를 다양한 데이터 형식으로 상당한 수의 대상으로 내보냅니다. 대상 유형의 몇 가지 예로는 광고 플랫폼(Google), 소셜 네트워크(Facebook) 및 클라우드 스토리지 위치(Amazon S3, Azure 이벤트 허브)가 있습니다.
Experience Platform은 측면에서 예상되는 포맷과 일치하도록 내보낸 프로필의 메시지 포맷을 조정할 수 있습니다. 이 사용자 지정을 이해하기 위해서는 다음 개념이 중요합니다.
- Adobe Experience Platform의 소스 (1) 및 타겟 (2) XDM 스키마
- 파트너측의 예상 메시지 형식(3) 및
- 메시지 변환 템플릿을(를) 만들어 정의할 수 있는 XDM 스키마와 예상 메시지 형식 사이의 변환 계층.
Experience Platform은 XDM 스키마를 사용하여 데이터의 구조를 일관되고 재사용 가능한 방식으로 설명합니다.
Source XDM 스키마(1): 이 항목은 고객이 Experience Platform에서 사용하는 스키마를 참조합니다. 대상 Experience Platform 워크플로의 매핑 단계에서 고객은 XDM 스키마의 필드를 대상의 대상 스키마에 매핑합니다(2).
대상 XDM 스키마(2): 대상 예상 형식의 JSON 표준 스키마(3)와 대상이 해석할 수 있는 특성을 기반으로 대상 XDM 스키마에서 프로필 속성 및 ID를 정의할 수 있습니다. 대상 구성, schemaConfig 및 identityNamespaces 개체에서 이 작업을 수행할 수 있습니다.
대상 프로필 속성의 JSON 표준 스키마(3): 이 예제는 플랫폼에서 지원하는 모든 프로필 속성과 해당 유형(예: 개체, 문자열, 배열)의 JSON 스키마를 나타냅니다. 대상이 지원할 수 있는 필드 예는 firstName, lastName, gender, email, phone, productId, productName 등일 수 있습니다. Experience Platform에서 내보낸 데이터를 원하는 형식으로 맞춤화하려면 메시지 변환 템플릿이 필요합니다.
위에서 설명한 스키마 변환을 기반으로 소스 XDM 스키마와 파트너 측의 샘플 스키마 간에 프로필 구성이 변경되는 방법은 다음과 같습니다.
시작하기 - 세 가지 기본 특성 변환 getting-started
프로필 변환 프로세스를 보여주기 위해 아래 예제에서는 Adobe Experience Platform에 있는 세 가지 공통 프로필 속성(이름, 성 및 이메일 주소)을 사용합니다.
플랫폼이 다음과 같은 메시지 형식을 수신할 수 있다고 가정해 보겠습니다.
POST https://YOUR_REST_API_URL/users/
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
"attributes":
{
"first_name": "Yours",
"last_name": "Truly",
"external_id": "yourstruly@adobe.com"
}
}
메시지 형식을 고려하여 해당 변환은 다음과 같습니다.
_your_custom_schema.firstNameattributes.first_namefirst_name_your_custom_schema.lastNameattributes.last_namelast_namepersonalEmail.addressattributes.external_idexternal_idExperience Platform의 프로필 구조 profile-structure
페이지의 아래 예를 더 이해하려면 Experience Platform 내 프로필의 구조를 아는 것이 중요합니다.
프로필에는 다음 3개의 섹션이 있습니다.
-
segmentMembership(항상 프로필에 있음)- 이 섹션에는 프로필에 있는 모든 대상자가 포함되어 있습니다. 대상자는
realized또는exited상태 중 하나를 가질 수 있습니다.
- 이 섹션에는 프로필에 있는 모든 대상자가 포함되어 있습니다. 대상자는
-
identityMap(항상 프로필에 있음)- 이 섹션에는 프로필에 있는 모든 ID(이메일, Google GAID, Apple IDFA 등)와 활성화 워크플로에서 내보내기를 위해 매핑된 사용자가 포함됩니다.
-
속성(대상 구성에 따라 프로필에 표시될 수 있음) 미리 정의된 속성과 자유 형식 속성 간에는 약간의 차이가 있습니다.
- 자유 형식 특성 의 경우 프로필에 특성이 있는 경우
.value경로가 포함됩니다(예 1의lastName특성 참조). 프로필에 없으면.value경로가 포함되지 않습니다(예 1의firstName특성 참조). - 미리 정의된 특성 의 경우
.value경로가 포함되지 않습니다. 프로필에 있는 모든 매핑된 속성은 속성 맵에 표시됩니다. 없는 속성은 존재하지 않습니다(예 2 -firstName특성이 프로필에 존재하지 않음).
- 자유 형식 특성 의 경우 프로필에 특성이 있는 경우
Experience Platform의 두 가지 프로필 예를 참조하십시오.
자유 형식 특성에 대한 segmentMembership, identityMap 및 특성이 있는 예제 1 example-1
{
"segmentMembership": {
"ups": {
"11111111-1111-1111-1111-111111111111": {
"lastQualificationTime": "2019-04-15T02:41:50.000+0000",
"status": "realized"
}
}
},
"identityMap": {
"mobileIds": [
{
"id": "e86fb215-0921-4537-bc77-969ff775752c"
}
]
},
"attributes": {
"firstName": {
},
"lastName": {
"value": "lastName"
}
}
}
미리 정의된 특성에 대한 segmentMembership, identityMap 및 특성이 있는 예제 2 example-2
{
"segmentMembership": {
"ups": {
"11111111-1111-1111-1111-111111111111": {
"lastQualificationTime": "2019-04-15T02:41:50.000+0000",
"status": "realized"
}
}
},
"identityMap": {
"mobileIds": [
{
"id": "e86fb215-0921-4537-bc77-969ff775752c"
}
]
},
"attributes": {
"lastName": "lastName"
}
}
ID, 속성 및 대상자 멤버십 변환에 템플릿 언어 사용 using-templating
Adobe은 Jinja와(과) 유사한 템플릿 언어인 페블 템플릿을(를) 사용하여 Experience Platform XDM 스키마의 필드를 대상에서 지원하는 형식으로 변환합니다.
이 섹션에서는 입력 XDM 스키마에서 템플릿을 통해 그리고 대상에서 허용하는 페이로드 형식으로 출력하면서 이러한 변환을 수행하는 방법에 대한 몇 가지 예를 제공합니다. 아래 예제는 다음과 같이 복잡성을 증가시켜 제공됩니다.
- 간단한 변형 예. 프로필 특성, 대상자 멤버십 및 ID 필드에 대한 간단한 변형을 사용하여 템플릿화가 작동하는 방식을 알아봅니다.
- 위의 필드를 결합하는 템플릿의 복잡성 증가 예: 대상 및 ID를 보내는 템플릿을 만듭니다 및 세그먼트, ID 및 프로필 특성을 보내는 템플릿을 만듭니다.
- 집계 키를 포함하는 템플릿. 대상 구성에서 구성 가능한 집계를 사용하는 경우 Experience Platform은 대상 ID, 대상 상태 또는 ID 네임스페이스와 같은 기준을 기반으로 대상으로 내보낸 프로필을 그룹화합니다.
프로필 속성 attributes
대상으로 내보낸 프로필 속성을 변형하려면 아래 JSON 및 코드 샘플을 참조하십시오.
입력
프로필 1:
{
"attributes": {
"firstName": {
"value": "Hermione"
},
"birthDate": {}
}
}
프로필 2:
{
"attributes": {
"firstName": {
"value": "Harry"
},
"birthDate": {
"value": "1980/07/31"
}
}
}
템플릿
{
"profiles": [
{% for profile in input.profiles %}
{
{% for attribute in profile.attributes %}
"{{ attribute.key }}":
{% if attribute.value is empty %}
null
{% else %}
"{{ attribute.value.value }}"
{% endif %}
{% if not loop.last %},{% endif %}
{% endfor %}
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
{
"profiles": [
{
"firstName": "Hermione",
"birthDate": null
},
{
"firstName": "Harry",
"birthDate": "1980/07/31"
}
]
}
대상자 멤버십 audience-membership
segmentMembership XDM 특성은 프로필이 멤버인 대상을 알려줍니다.status 필드의 세 가지 다른 값에 대해 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 설명서를 읽어 보십시오.
입력
프로필 1:
{
"segmentMembership": {
"ups": {
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"788d8874-8007-4253-92b7-ee6b6c20c6f3": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"8f812592-3f06-416b-bd50-e7831848a31a": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "exited"
}
}
}
}
프로필 2:
{
"segmentMembership": {
"ups": {
"32396e4b-16f6-4033-9702-fc69b5e24e7c": {
"lastQualificationTime": "2021-08-20T17:23:04Z",
"status": "realized"
},
"af854278-894a-4192-a96b-320fbf2623fd": {
"lastQualificationTime": "2021-08-20T16:44:37Z",
"status": "realized"
},
"66505bf9-bc08-4bac-afbc-8b6706650ea4": {
"lastQualificationTime": "2019-08-20T17:23:04Z",
"status": "realized"
}
}
}
}
템플릿
{
"profiles": [
{% for profile in input.profiles %}
{
"AdobeExperiencePlatformSegments": {
"add": [
{% for segment in profile.segmentMembership.ups | added %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
],
"remove": [
{# Alternative syntax for filtering audiences by status: #}
{% for segment in removedSegments(profile.segmentMembership.ups) %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
]
}
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
{
"profiles": [
{
"AdobeExperiencePlatformSegments": {
"add": [
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
"788d8874-8007-4253-92b7-ee6b6c20c6f3"
],
"remove": [
"8f812592-3f06-416b-bd50-e7831848a31a"
]
}
},
{
"AdobeExperiencePlatformSegments": {
"add": [
"32396e4b-16f6-4033-9702-fc69b5e24e7c",
"af854278-894a-4192-a96b-320fbf2623fd",
"66505bf9-bc08-4bac-afbc-8b6706650ea4"
],
"remove": [
]
}
}
]
}
ID identities
Experience Platform의 ID에 대한 자세한 내용은 ID 네임스페이스 개요를 참조하십시오.
입력
프로필 1:
{
"identityMap": {
"email": [
{
"id": "johndoe@example.com"
},
{
"id": "jd@example.com"
}
],
"external_id": [
{
"id": "123456"
}
]
}
}
프로필 2:
{
"identityMap": {
"email": [
{
"id": "jane.doe@example.com"
}
]
}
}
템플릿
{
"profiles": [
{% for profile in input.profiles %}
{
"identities": [
{% for email in profile.identityMap.email %}
{
"type": "email",
"id": "{{ email.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
{# Add a comma only if you have both emails and external_ids. #}
{% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
,
{% endif %}
{% for external in profile.identityMap.external_id %}
{
"type": "external_id",
"id": "{{ external.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
{
"profiles": [
{
"identities": [
{
"type": "email",
"id": "johndoe@example.com"
},
{
"type": "email",
"id": "jd@example.com"
},
{
"type": "external_id",
"id": "123456"
}
]
},
{
"identities": [
{
"type": "email",
"id": "jane.doe@example.com"
}
]
}
]
}
대상자 및 ID를 전송하는 템플릿 만들기 segments-and-identities
이 섹션에서는 Adobe XDM 스키마와 파트너 대상 스키마 간에 일반적으로 사용되는 변환의 예를 제공합니다.
아래 예제는 대상 멤버십 및 ID 형식을 변환하여 대상에 출력하는 방법을 보여 줍니다.
입력
프로필 1:
{
"identityMap": {
"email": [
{
"id": "johndoe@example.com"
},
{
"id": "jd@example.com"
}
],
"external_id": [
{
"id": "123456"
}
]
},
"segmentMembership": {
"ups": {
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"788d8874-8007-4253-92b7-ee6b6c20c6f3": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"8f812592-3f06-416b-bd50-e7831848a31a": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "exited"
}
}
}
}
프로필 2:
{
"identityMap": {
"email": [
{
"id": "jane.doe@example.com"
}
]
},
"segmentMembership": {
"ups": {
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
"lastQualificationTime": "2021-08-31T10:01:42Z",
"status": "realized"
}
}
}
}
템플릿
{
"profiles": [
{% for profile in input.profiles %}
{
"identities": [
{% for email in profile.identityMap.email %}
{
"type": "email",
"id": "{{ email.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
{# Add a comma only if you have both emails and external_ids. #}
{% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
,
{% endif %}
{% for external in profile.identityMap.external_id %}
{
"type": "external_id",
"id": "{{ external.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{% for segment in profile.segmentMembership.ups | added %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
],
"remove": [
{# Alternative syntax for filtering audiences by status: #}
{% for segment in removedSegments(profile.segmentMembership.ups) %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
]
}
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
아래 json은(는) Adobe Experience Platform에서 내보낸 데이터를 나타냅니다.
{
"profiles": [
{
"identities": [
{
"type": "email",
"id": "johndoe@example.com"
},
{
"type": "email",
"id": "jd@example.com"
},
{
"type": "external_id",
"id": "123456"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
"788d8874-8007-4253-92b7-ee6b6c20c6f3"
],
"remove": [
"8f812592-3f06-416b-bd50-e7831848a31a"
]
}
},
{
"identities": [
{
"type": "email",
"id": "jane.doe@example.com"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075"
],
"remove": []
}
}
]
}
세그먼트, ID 및 프로필 속성을 보내는 템플릿 만들기 segments-identities-attributes
이 섹션에서는 Adobe XDM 스키마와 파트너 대상 스키마 간에 일반적으로 사용되는 변환의 예를 제공합니다.
또 다른 일반적인 사용 사례는 대상자 멤버십, ID(예: 이메일 주소, 전화 번호, 광고 ID) 및 프로필 속성이 포함된 데이터를 내보내는 것입니다. 이러한 방식으로 데이터를 내보내려면 아래 예를 참조하십시오.
입력
프로필 1:
{
"attributes": {
"firstName": {
"value": "Hermione"
},
"birthDate": {}
},
"identityMap": {
"email": [
{
"id": "johndoe@example.com"
},
{
"id": "jd@example.com"
}
],
"external_id": [
{
"id": "123456"
}
]
},
"segmentMembership": {
"ups": {
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"788d8874-8007-4253-92b7-ee6b6c20c6f3": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"8f812592-3f06-416b-bd50-e7831848a31a": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "exited"
}
}
}
}
프로필 2:
{
"attributes": {
"firstName": {
"value": "Harry"
},
"birthDate": {
"value": "1980/07/31"
}
},
"identityMap": {
"email": [
{
"id": "harry.p@example.com"
}
]
},
"segmentMembership": {
"ups": {
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
}
}
}
}
템플릿
{
"profiles": [
{% for profile in input.profiles %}
{
"attributes": {
{% for attribute in profile.attributes %}
"{{ attribute.key }}":
{% if attribute.value is empty %}
null
{% else %}
"{{ attribute.value.value }}"
{% endif %}
{% if not loop.last %},{% endif %}
{% endfor %}
},
"identities": [
{% for email in profile.identityMap.email %}
{
"type": "email",
"id": "{{ email.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
{# Add a comma only if we have both emails and external_ids. #}
{% if profile.identityMap.email is not empty and profile.identityMap.external_id is not empty %}
,
{% endif %}
{% for external in profile.identityMap.external_id %}
{
"type": "external_id",
"id": "{{ external.id }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
],
"AdobeExperiencePlatformSegments": {
"add": [
{% for segment in profile.segmentMembership.ups | added %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
],
"remove": [
{# Alternative syntax for filtering audiences by status: #}
{% for segment in removedSegments(profile.segmentMembership.ups) %}
"{{ segment.key }}"{% if not loop.last %},{% endif %}
{% endfor %}
]
}
}
]
}
결과
아래 json은(는) Adobe Experience Platform에서 내보낸 데이터를 나타냅니다.
{
"profiles": [
{
"attributes": {
"firstName": "Hermione",
"birthDate": null
},
"identities": [
{
"type": "email",
"id": "johndoe@example.com"
},
{
"type": "email",
"id": "jd@example.com"
},
{
"type": "external_id",
"id": "123456"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075",
"788d8874-8007-4253-92b7-ee6b6c20c6f3"
],
"remove": [
"8f812592-3f06-416b-bd50-e7831848a31a"
]
}
},
{
"attributes": {
"firstName": "Harry",
"birthDate": "1980/07/21"
},
"identities": [
{
"type": "email",
"id": "harry.p@example.com"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"36a51c13-9dd6-4d2c-8aa3-07d785ea5075"
],
"remove": []
}
}
]
}
템플릿에 집계 키를 포함하여 다양한 기준으로 그룹화된 내보낸 프로필에 액세스합니다 template-aggregation-key
대상 구성에서 구성 가능한 집계를 사용하는 경우 대상 ID, 대상 별칭, 대상 멤버십 또는 ID 네임스페이스와 같은 기준을 기반으로 대상으로 내보낸 프로필을 그룹화할 수 있습니다.
메시지 변환 템플릿에서 다음 섹션의 예에 표시된 대로 위에 언급된 합계 키에 액세스할 수 있습니다. 집계 키를 사용하여 Experience Platform에서 내보낸 HTTP 메시지를 대상에 필요한 형식 및 속도 제한과 일치하도록 구성합니다.
템플릿에서 대상 ID 집계 키 사용 aggregation-key-segment-id
구성 가능한 집계를 사용하고 includeSegmentId을(를) true로 설정하면 대상으로 내보낸 HTTP 메시지의 프로필이 대상 ID별로 그룹화됩니다. 템플릿의 대상 ID에 액세스하는 방법은 아래를 참조하십시오.
입력
아래의 네 가지 프로필을 고려하십시오. 여기서
- 처음 두 개는 대상 ID가
788d8874-8007-4253-92b7-ee6b6c20c6f3인 대상에 속합니다. - 세 번째 프로필은 대상 ID가
8f812592-3f06-416b-bd50-e7831848a31a인 대상의 일부입니다. - 네 번째 프로필은 위의 두 대상 모두에 속합니다.
프로필 1:
{
"attributes":{
"firstName":{
"value":"Hermione"
}
},
"segmentMembership":{
"ups":{
"788d8874-8007-4253-92b7-ee6b6c20c6f3":{
"lastQualificationTime":"2020-11-20T13:15:49Z",
"status":"realized"
}
}
}
}
프로필 2:
{
"attributes":{
"firstName":{
"value":"Harry"
}
},
"segmentMembership":{
"ups":{
"788d8874-8007-4253-92b7-ee6b6c20c6f3":{
"lastQualificationTime":"2020-11-20T13:15:49Z",
"status":"realized"
}
}
}
}
프로필 3:
{
"attributes":{
"firstName":{
"value":"Tom"
}
},
"segmentMembership":{
"ups":{
"8f812592-3f06-416b-bd50-e7831848a31a":{
"lastQualificationTime":"2021-02-20T12:00:00Z",
"status":"realized"
}
}
}
}
프로필 4:
{
"attributes":{
"firstName":{
"value":"Jerry"
}
},
"segmentMembership":{
"ups":{
"8f812592-3f06-416b-bd50-e7831848a31a":{
"lastQualificationTime":"2021-02-20T12:00:00Z",
"status":"realized"
},
"788d8874-8007-4253-92b7-ee6b6c20c6f3":{
"lastQualificationTime":"2020-11-20T13:15:49Z",
"status":"realized"
}
}
}
}
템플릿
audienceId이(가) 대상 ID에 액세스하기 위해 템플릿에 사용되는 방법은 아래에 나와 있습니다. 이 예제에서는 대상 분류에서 대상 멤버십에 audienceId을(를) 사용한다고 가정합니다. 자체 분류법에 따라 다른 필드 이름을 대신 사용할 수 있습니다.
{
"audienceId": "{{ input.aggregationKey.segmentId }}",
"profiles": [
{% for profile in input.profiles %}
{
"first_name": "{{ profile.attributes.firstName.value }}"
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
프로필은 대상으로 내보낼 때 대상 ID를 기준으로 두 개의 그룹으로 분할됩니다.
{
"audienceId":"788d8874-8007-4253-92b7-ee6b6c20c6f3",
"profiles":[
{
"firstName":"Hermione"
},
{
"firstName":"Harry"
},
{
"firstName":"Jerry"
}
]
}
{
"audienceId":"8f812592-3f06-416b-bd50-e7831848a31a",
"profiles":[
{
"firstName":"Tom"
},
{
"firstName":"Jerry"
}
]
}
템플릿에 대상 별칭 집계 키 사용 aggregation-key-segment-alias
구성 가능한 집계를 사용하고 includeSegmentId을(를) true로 설정하면 템플릿의 대상 별칭에 액세스할 수도 있습니다.
아래 줄을 템플릿에 추가하여 대상자 별칭으로 그룹화된 내보낸 프로필에 액세스합니다.
customerList={{input.aggregationKey.segmentAlias}}
템플릿에서 대상 상태 집계 키 사용 aggregation-key-segment-status
구성 가능한 집계를 사용하고 includeSegmentId 및 includeSegmentStatus을(를) true로 설정하면 템플릿의 대상 상태에 액세스할 수 있습니다. 이렇게 하면 프로필이 세그먼트에서 추가되어야 하는지 또는 제거되어야 하는지에 따라 대상으로 내보낸 HTTP 메시지에서 프로필을 그룹화할 수 있습니다.
가능한 값:
- 실현됨
- 기존
- 종료됨
위의 값을 기준으로 아래 줄을 템플릿에 추가하여 세그먼트에서 프로필을 추가하거나 제거합니다.
action={% if input.aggregationKey.segmentStatus == "exited" %}REMOVE{% else %}ADD{% endif%}
템플릿에서 ID 네임스페이스 집계 키 사용 aggregation-key-identity
다음은 대상 구성의 구성 가능한 집계가 "namespaces": ["email", "phone"] 및 "namespaces": ["GAID", "IDFA"] 형식의 ID 네임스페이스별로 내보낸 프로필을 집계하도록 설정된 예입니다. 그룹화에 대한 자세한 내용은 대상 구성 만들기 설명서의 groups 매개 변수를 참조하십시오.
입력
프로필 1:
{
"identityMap":{
"email":[
{
"id":"e1@example.com"
},
{
"id":"e2@example.com"
}
],
"phone":[
{
"id":"+40744111222"
}
],
"IDFA":[
{
"id":"AEBE52E7-03EE-455A-B3C4-E57283966239"
}
],
"GAID":[
{
"id":"e4fe9bde-caa0-47b6-908d-ffba3fa184f2"
}
]
}
}
프로필 2:
{
"identityMap":{
"email":[
{
"id":"e3@example.com"
}
],
"phone":[
{
"id":"+40744333444"
},
{
"id":"+40744555666"
}
],
"IDFA":[
{
"id":"134GHU45-34HH-GHJ7-K0H8-LHN665998NN0"
}
],
"GAID":[
{
"id":"47bh00i9-8jv6-334n-lll8-nb7f24sghg76"
}
]
}
}
템플릿
input.aggregationKey.identityNamespaces이(가) 아래 템플릿에서 사용되고 있습니다.
{
"profiles": [
{% for profile in input.profiles %}
{
{% for ns in input.aggregationKey.identityNamespaces %}
"{{ns}}": [
{% for id in profile.identityMap[ns] %}
"{{id.id}}"{% if not loop.last %},{% endif %}
{% endfor %}
]{% if not loop.last %},{% endif %}
{% endfor %}
}{% if not loop.last %},{% endif %}
{% endfor %}
]
}
결과
프로필은 대상으로 내보낼 때 ID 네임스페이스에 따라 두 개의 그룹으로 분할됩니다. 이메일과 전화기는 한 그룹에 있고 GAID와 IDFA는 다른 그룹에 있습니다.
{
"profiles":[
{
"email":[
"e1@example.com",
"e2@example.com"
],
"phone":[
"+40744111222"
]
},
{
"email":[
"e3@example.com"
],
"phone":[
"+40744333444",
"+40744555666"
]
}
]
}
{
"profiles":[
{
"IDFA":[
"AEBE52E7-03EE-455A-B3C4-E57283966239"
],
"GAID":[
"e4fe9bde-caa0-47b6-908d-ffba3fa184f2"
]
},
{
"IDFA":[
"134GHU45-34HH-GHJ7-K0H8-LHN665998NN0"
],
"GAID":[
"47bh00i9-8jv6-334n-lll8-nb7f24sghg76"
]
}
]
}
URL 템플릿에서 집계 키 사용 aggregation-key-url-template
사용 사례에 따라 아래와 같이 URL에 여기에 설명된 집계 키를 사용할 수도 있습니다.
https://api.example.com/audience/{{input.aggregationKey.segmentId}}
참조: 변환 템플릿에 사용되는 컨텍스트 및 함수 reference
템플릿에 제공된 컨텍스트에는 input(이 호출에서 내보낸 프로필/데이터)과 destination(모든 프로필에 대해 유효한 Adobe이 데이터를 보내는 대상에 대한 데이터)이 포함됩니다.
아래 표는 위의 예에서 함수에 대한 설명을 제공합니다.
input.profilehasSegmentstrue을(를) 반환하고, 그렇지 않으면 false을(를) 반환합니다. 이 함수를 사용하여 대상자 맵을 반복할지 여부를 결정할 수 있습니다.hasSegments(input.profile.segmentMembership)destination.namespaceSegmentAliasesdestination.namespaceSegmentAliases["ups"]["seg-id-1"]destination.namespaceSegmentNamesdestination.namespaceSegmentNames["ups"]["seg-name-1"]destination.namespaceSegmentTimestampsdestination.namespaceSegmentTimestamps["ups"]["seg-id-1"].createdAt:ups네임스페이스에서 ID가seg-id-1인 세그먼트를 만든 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.namespaceSegmentTimestamps["ups"]["seg-id-1"].updatedAt:ups네임스페이스에서 ID가seg-id-1인 대상이 업데이트된 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.namespaceSegmentTimestamps["ups"]["seg-id-1"].mappingCreatedAt: ID가seg-id-1인 대상이ups네임스페이스에서 대상으로 활성화된 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.namespaceSegmentTimestamps["ups"]["seg-id-1"].mappingUpdatedAt: 대상에서 대상 활성화가 업데이트된 시간을 UNIX 타임스탬프 형식으로 반환합니다.
addedSegments(mapOfNamespacedSegmentIds)realized인 대상자만 반환합니다.addedSegments(input.profile.segmentMembership)removedSegments(mapOfNamespacedSegmentIds)exited인 대상자만 반환합니다.removedSegments(input.profile.segmentMembership)destination.segmentAliasesdestination.namespaceSegmentAliases맵으로 대체되었습니다.
destination.segmentAliases["seg-id-1"]destination.segmentNamesdestination.namespaceSegmentNames맵으로 대체되었습니다.
destination.segmentNames["seg-name-1"]destination.segmentTimestampsdestination.namespaceSegmentTimestamps(으)로 대체됨 대상을 만들거나 업데이트하거나 활성화한 시간을 UNIX 타임스탬프 형식으로 반환합니다.
destination.segmentTimestamps["seg-id-1"].createdAt: ID가seg-id-1인 대상이 만들어진 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.segmentTimestamps["seg-id-1"].updatedAt: ID가seg-id-1인 대상이 업데이트된 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.segmentTimestamps["seg-id-1"].mappingCreatedAt: ID가seg-id-1인 대상이 대상에 활성화된 시간을 UNIX 타임스탬프 형식으로 반환합니다.destination.segmentTimestamps["seg-id-1"].mappingUpdatedAt: 대상에서 대상 활성화가 업데이트된 시간을 UNIX 타임스탬프 형식으로 반환합니다.
다음 단계 next-steps
이 문서를 읽고 나면 이제 Experience Platform에서 내보낸 데이터가 어떻게 변환되는지 알 수 있습니다. 다음으로 다음 페이지를 읽고 대상에 대한 메시지 변환 템플릿 생성에 대한 지식을 완료하십시오.
다른 대상 서버 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.