표준 엔진 동작 수정 hooks

상호 작용의 후크를 사용하면 표준 엔진 동작 ​을 수정할 수 있습니다.

Target loadingProposition post-processing 후크가 Adobe Campaign에서 오퍼 공간에 구성되어 있습니다.

Dynamic offer 후크가 Adobe Campaign에서 오퍼 가중치로 구성되었습니다.

대상 로드 중 target-loading

이 후크를 사용하면 기본 제공 쿼리로 로드한 연락처의 프로필을 외부 시스템의 추가 데이터로 보강할 수 있습니다.

수집된 데이터는 호출 데이터 노드(상호 작용 노드)에 삽입되어야 합니다. 통합자는 수집된 데이터의 구조를 정의하기 위해 미리 호출 데이터 스키마를 확장해야 합니다. 사용자는 표준 호출 데이터와 동일한 방식으로 (자격 규칙 및 개인화 수준에서) 이 데이터에 액세스할 수 있습니다.

입력 매개 변수:

  • xmlInteraction(xml 유형): 상호 작용 노드
  • aTargetId(테이블 유형): 타겟 식별자
  • sUuid230 (문자열 유형): uuid230 영구 쿠키의 값
  • sNlid(문자열 유형): nlid 세션 쿠키의 값입니다.

반환 매개 변수:

  • 보강된 상호 작용 노드(이 후크의 첫 번째 매개 변수)
NOTE
xmlInteraction 매개 변수에는 기본 제공 쿼리로 로드한 연락처의 프로필과 호출 데이터가 모두 포함되어 있습니다.

예:

// Call an external system to get additional data for the target
  var additionalData  = getUrl("https://EXTERNAL_SYSTEM?target=" + encodeURIComponent(aTargetId.join("|")));
  // Enrich the context with this data
  interaction.@additionalData = additionalData;

제안 후 처리 proposition-post-processing-

이 후크를 사용하면 주어진 상호 작용에서 적격 제안에 대한 일관성과 호환성을 확인할 수 있습니다. 또한 새 채점 또는 확률 계산 기능을 정의할 수 있습니다.

일관성 규칙 사용의 예:

  • 동일한 호출, 동일한 제품 또는 동일한 범주에 연결된 제안 수 제한.
  • 동일한 상호 작용에서 제품과 관련된 오퍼만 표시합니다.

사후 처리는 유형화 규칙 적용과 적격 제안 정렬 후 우선순위 지정 단계 전에 실행됩니다.

입력 매개 변수:

  • 제안: 적격 제안 테이블 다음은 이 테이블의 요소 구조 예입니다

    code language-none
    { offer_id:1234,
      weight:2}
    
  • dicOffer(xml 유형): 적격 오퍼의 모든 속성(오퍼 코드, 범주 id, 범주 전체 이름, 시작 날짜, 종료 날짜, 레이블, 내부 이름, 오퍼 id, 추가 오퍼 필드)에 대한 사전입니다. 예

    code language-none
    { "1242": <offer category-id="61242" categoryFullName="/FULL/PATH/TO/CATEGORY/" code="CODE" endDate="" id="62473" label="LABEL" name="OFR38_OE4" product-id="43" startDate=""/>,
      "1243": ...}
    
  • xmlTarget(xml 유형): 프로필 데이터 노드

  • xmlInteraction(xml 유형): 데이터 노드 호출

  • iPropNumber(정수 유형): 예상 오퍼 수

반환 매개 변수:

  • 수정된 제안 목록(후크의 첫 번째 매개 변수)
  • 수정된 상호 작용 노드

예:

var aReturnedProps = [];

if( aProposition.length > 0 )
{
  var iReturnedProps = 0;
  for( var iPropIdx = 0; iPropIdx < aProposition.length && iReturnedProps < iPropNumber; iPropIdx ++ )
  {
    // Check a consistency rule for instance
    if( true )
    {
      aReturnedProps.push(aProposition[iPropIdx]);
      iReturnedProps++;
    }
  }
}

return aReturnedProps;

동적 오퍼 dynamic-offer

이 후크를 사용하면 외부 엔진을 호출하여 오퍼에 연결된 제품 목록을 선택할 수 있습니다. 자격 규칙 뒤, 유형화 규칙 적용 전에 오퍼에 구성됩니다.

먼저 통합자는 제품에 대한 추가 정보로 제안 PropositionRcp 스키마를 확장해야 합니다. 이 데이터를 저장할 위치를 지정하려면 스페이스의 Storage 탭에서 Proposition being processed 링크를 사용할 수 있습니다

입력 매개 변수:

  • xmlOffer(xml 유형): 오퍼(오퍼 코드, 범주 ID, 범주 전체 이름, 시작 날짜, 종료 날짜, 레이블, 내부 이름, 오퍼 ID, 추가 오퍼 필드)
  • dWeight: 컨텍스트 가중치 (이중 유형)
  • xmlTarget(xml 유형): 프로필 데이터 노드
  • xmlInteraction(xml 유형): 데이터 노드 호출

반환 매개 변수:

생성할 제안 테이블이 반환됩니다. 이 테이블의 각 요소는 다음 정보로 구성됩니다.

  • 오퍼 식별자
  • 추가 제품 데이터(예: 제품 코드)
  • 두께
NOTE
시스템은 오퍼 ID가 입력 및 반환 매개 변수 모두에 대해 동일한지 확인합니다.

예:

var product = getUrl("https://EXTERNAL_SYSTEM?offerCode=" + encodeURIComponent(xmlOffer.@code));
if( product )
  return [{offer_id: parseInt(String(xmlOffer.@id)), weight: dWeight, productId: product}];
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1