사용자 지정 개인화 연결 custom-personalization-connection

대상 변경 로그 changelog

릴리스 월
업데이트 유형
설명
2023년 5월
기능 및 설명서 업데이트
2023년 5월 현재 사용자 정의 개인화 연결 지원 속성 기반 개인화 및 는 일반적으로 모든 고객이 사용할 수 있습니다.
IMPORTANT
프로필 속성에 중요한 데이터가 포함될 수 있습니다. 이 데이터를 보호하려면 다음을 사용해야 합니다 Edge Network Server API 구성 시 사용자 정의 개인화 속성 기반 개인화를 위한 대상. 모든 서버 API 호출은 인증된 컨텍스트.
통합에 웹 SDK 또는 Mobile SDK를 이미 사용 중인 경우 서버측 통합을 추가하여 서버 API를 통해 속성을 검색할 수 있습니다.
위의 요구 사항을 따르지 않는 경우 개인화는 대상 멤버십만 기반으로 합니다.

개요 overview

외부 개인화 플랫폼, 컨텐츠 관리 시스템, 광고 서버 및 고객 웹 사이트에서 실행 중인 기타 애플리케이션이 Adobe Experience Platform에서 대상 정보를 검색할 수 있도록 하려면 이 대상을 설정하십시오.

전제 조건 prerequisites

이 통합은 Adobe Experience Platform 웹 SDK 또는 Adobe Experience Platform Mobile SDK. 이 대상을 사용하려면 다음 SDK 중 하나를 사용해야 합니다.

IMPORTANT
사용자 지정 개인화 연결을 만들기 전에 다음 방법에 대한 안내서를 참조하십시오 edge 개인화 대상에 대상 데이터 활성화. 이 안내서에서는 여러 Experience Platform 구성 요소에서 동일한 페이지 및 다음 페이지 개인화 사용 사례에 필요한 구성 단계를 안내합니다.

지원되는 대상자 supported-audiences

이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.

대상자 원본
지원됨
설명
Segmentation Service
✓ 덧신
Experience Platform을 통해 생성된 대상자 세분화 서비스.
사용자 정의 업로드
대상 가져옴 csv 파일에서 Experience Platform으로 변환했습니다.

내보내기 유형 및 빈도 export-type-frequency

항목
유형
참고
내보내기 유형
Profile request
단일 프로필에 대해 사용자 지정 개인화 대상에서 매핑된 모든 대상을 요청합니다. 서로 다른 사용자 정의 개인화 대상을 설정할 수 있습니다 Adobe 데이터 수집 데이터스트림.
내보내기 빈도
스트리밍
스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 자세한 내용 스트리밍 대상.

대상에 연결 connect

IMPORTANT
대상에 연결하려면 다음이 필요합니다. 대상 보기대상 관리 액세스 제어 권한. 읽기 액세스 제어 개요 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오.

이 대상에 연결하려면 다음과같이 하십시오. 대상 구성 자습서.

연결 매개변수 parameters

While 설정 중 이 대상에는 다음 정보를 제공해야 합니다.

  • 이름: 이 대상의 기본 이름을 입력합니다.
  • 설명: 대상에 대한 설명을 입력합니다. 예를 들어 이 대상을 사용하는 캠페인을 언급할 수 있습니다. 이 필드는 선택 사항입니다.
  • 통합 별칭: 이 값은 JSON 개체 이름으로 Experience Platform Web SDK에 전송됩니다.
  • 데이터 스트림 ID: 대상자가 페이지에 대한 응답에 포함될 데이터 수집 데이터스트림을 결정합니다. 드롭다운 메뉴에 대상 구성이 활성화된 데이터스트림만 표시됩니다. 다음을 참조하십시오 데이터스트림 구성 을 참조하십시오.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 다음 안내서를 참조하십시오. UI를 사용하여 대상 경고 구독.

대상 연결에 대한 세부 정보를 제공했으면 을 선택합니다. 다음.

이 대상으로 대상자 활성화 activate

IMPORTANT
데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기, 및 세그먼트 보기 액세스 제어 권한. 읽기 액세스 제어 개요 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오.

읽기 프로필 및 대상자 에지 개인화 대상 활성화 이 대상에 대한 대상자 활성화에 대한 지침을 참조하십시오.

내보낸 데이터 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.
  });

에 대한 응답 예 속성을 사용한 사용자 지정 개인화

사용 시 속성을 사용한 사용자 지정 개인화, 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 데이터 거버넌스 적용, 다음을 읽습니다. 데이터 거버넌스 개요.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6