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

대상 변경 로그 changelog

개요 overview

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

전제 조건 prerequisites

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

지원되는 대상자 supported-audiences

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

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

대상에 연결 connect

이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오.

연결 매개변수 parameters

이 대상을 설정하는 동안 다음 정보를 제공해야 합니다.

경고 활성화 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에서 데이터 거버넌스를 적용하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.