사용자 지정 개인화 연결 custom-personalization-connection
대상 변경 로그 changelog
개요 overview
외부 개인화 플랫폼, 컨텐츠 관리 시스템, 광고 서버 및 고객 웹 사이트에서 실행 중인 기타 애플리케이션이 Adobe Experience Platform에서 대상 정보를 검색할 수 있도록 하려면 이 대상을 설정하십시오.
전제 조건 prerequisites
이 대상은 구현에 따라 다음 데이터 수집 방법 중 하나를 사용해야 합니다.
- 웹 사이트에서 데이터를 수집하려면 Adobe Experience Platform Web SDK를 사용하십시오.
- 모바일 애플리케이션에서 데이터를 수집하려면 Adobe Experience Platform Mobile SDK를 사용하십시오.
- Web SDK 또는 Mobile SDK를 사용하지 않거나 프로필 특성을 기반으로 Edge Network 환경을 개인화하려는 경우 User Server API를 사용하십시오.
지원되는 대상자 supported-audiences
이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.
내보내기 유형 및 빈도 export-type-frequency
대상에 연결 connect
이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오.
연결 매개변수 parameters
이 대상을 설정하는 동안 다음 정보를 제공해야 합니다.
- 이름: 이 대상의 기본 이름을 입력하십시오.
- 설명: 대상에 대한 설명을 입력하십시오. 예를 들어 이 대상을 사용하는 캠페인을 언급할 수 있습니다. 이 필드는 선택 사항입니다.
- 통합 별칭: 이 값은 JSON 개체 이름으로 Experience Platform Web SDK에 전송됩니다.
- 데이터 스트림 ID: 페이지 응답에 대상이 포함될 데이터 수집 데이터 스트림을 결정합니다. 드롭다운 메뉴에 대상 구성이 활성화된 데이터스트림만 표시됩니다. 자세한 내용은 데이터 스트림 구성을 참조하십시오.
경고 활성화 enable-alerts
경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.
대상 연결에 대한 세부 정보를 모두 제공했으면 다음 을 선택합니다.
이 대상으로 대상자 활성화 activate
이 대상에 대한 대상자 활성화에 대한 지침은 프로필 및 대상자 에지 개인화 대상 활성화를 참조하십시오.
내보낸 데이터 exported-data
Adobe Experience Platform의 태그를 사용하여 Experience Platform Web SDK를 배포하는 경우 완료 보내기 기능을 사용하면 사용자 지정 코드 작업에 event.destinations
변수가 포함되며, 이 변수를 사용하여 내보낸 데이터를 볼 수 있습니다.
다음은 event.destinations
변수의 샘플 값입니다.
[
{
"type":"profileLookup",
"destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
"alias":"personalizationAlias",
"segments":[
{
"id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
태그를 사용하여 Experience Platform Web SDK를 배포하지 않는 경우 명령 응답을 사용하여 내보낸 데이터를 봅니다.
Adobe Experience Platform의 JSON 응답을 구문 분석하여 Adobe Experience Platform과 통합 중인 애플리케이션의 해당 통합 별칭을 찾을 수 있습니다. 대상 ID는 타깃팅 매개 변수로 애플리케이션의 코드에 전달될 수 있습니다. 다음은 대상 응답에만 적용되는 예제입니다.
alloy("sendEvent", {
"renderDecisions": true,
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
if(result.destinations) { // Looking to see if the destination results are there
// Get the destination with a particular alias
var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
if(personalizationDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to personalizationAlias
}
var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
if(adServerDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
특성이 있는 사용자 지정 Personalization에 대한 응답 예
특성이 있는 사용자 지정 Personalization 을(를) 사용하는 경우 API 응답은 아래 예와 비슷합니다.
특성이 있는 사용자 지정 Personalization 과(와) 사용자 지정 Personalization 의 차이점은 API 응답에 attributes
섹션이 포함되어 있다는 것입니다.
[
{
"type": "profileLookup",
"destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
"alias": "personalizationAlias",
"attributes": {
"countryCode": {
"value" : "DE"
},
"membershipStatus": {
"value" : "PREMIUM"
}
},
"segments": [
{
"id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
데이터 사용 및 관리 data-usage-governance
데이터를 처리할 때 모든 Adobe Experience Platform 대상이 데이터 사용 정책을 준수합니다. Adobe Experience Platform에서 데이터 거버넌스를 적용하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.