[Premium]{class="badge positive" title="Target Premium에 포함된 내용을 확인합니다."}

사용자 지정 엔티티 속성

Adobe Target Recommendations에서 단일 및 다중 값 사용자 지정 엔터티 특성을 사용하여 카탈로그에 있는 항목에 대한 추가 정보를 정의합니다.

제한 limits

카탈로그에 있는 항목에 대한 추가 정보를 정의하는 데 최대 100개의 사용자 지정 엔티티 속성을 포함할 수 있습니다. 예를 들어, 책 또는 동영상을 정의하기 위해 entity.genre라는 사용자 지정 속성을 만들 수 있습니다. 또는 티켓 공급업체는 스포츠 경기의 원정 팀이나 콘서트의 서막 같이, 보조 참여자를 포함하도록 행사가 열리는 장소에 대한 속성을 만들 수 있습니다.

단일 값 엔티티 사용자 지정 속성의 최대 길이는 15,000자(영어 및 기타 라틴어 스크립트 알파벳과 같은 1바이트 및 2바이트 UTF-8 인코딩 언어인 경우) 또는 10,000자(중국어, 일본어 및 한국어와 같은 3바이트 UTF-8 인코딩 언어인 경우)입니다.

다중 값 엔티티 사용자 지정 속성은 최대 500개의 값을 포함할 수 있습니다. 각 개별값은 100자로 제한됩니다. 모든 값에 걸친 총 문자 수는 단일 값 엔티티 사용자 지정 속성의 최대 길이에 대한 제한을 준수해야 합니다(위 참조).

사용자 지정 엔티티 속성 값 section_313331A9F8194A89B5EDD89363018651

사용자 지정 엔티티 속성은 단일 값 또는 다중 값을 포함할 수 있습니다. 엔티티 속성 값은 제품 보기에 표시됩니다.

단일 값을 사용하는 사용자 지정 엔티티 속성은 단일 값 사전 정의 엔티티 속성과 동일한 방식으로 형성됩니다.

entity.genre=genre1

다중 값 사용자 지정 엔티티 속성은 올바른 JSON 배열로 전송해야 합니다.

entity.genre=["genre1", "genre2"]

Recommendations에서 지원하는 올바른 JSON 배열의 예:

사용자 지정 속성이 유효한 JSON 배열로 전송되면 이 속성은 카탈로그의 모든 제품에 대한 다중 값 속성으로 처리됩니다.

제한 사항:

다중 값 속성 구현 section_80FEFE49E8AF415D99B739AA3CBA2A14

다중 값 사용자 지정 엔티티 속성은 피드(CSV), targetPageParams 및 배달 API를 사용하여 제품을 업로드할 때 지원됩니다. 새 값이 현재 값을 대체하며, 추가되지 않습니다. 빈 배열([])은 값이 없는 것으로 처리됩니다.

큰따옴표는 이스케이프 처리를 해야 합니다. 예를 들어, "[""test"", ""value""]"는 CSV로 사용할 수 있는 올바른 JSON 배열입니다.

다중 값 속성에는 최대 500개의 값을 포함할 수 있습니다.

targetPageParams 사용

다음 예는 targetPageParams를 사용하는 방법을 보여줍니다.

function targetPageParams() {
  return {
    'entity.id':                   '123',
    'entity.categoryId':            '["A", "A:B", "A:B:C", "A:B:C:D"]',
    'entity.MultiValueAttribute':   '["X", "Y", "Z"]',
    'entity.event.detailsOnly':     'true',
    'excludedIds":                  '[123, 3232, 2323, 4344]',
    'orderId":                      '123456',
    'orderTotal":                   '195.32',
    'productPurchaseId":            '[001,002,003]'
  };
}

CSV 사용

텍스트 편집기를 사용하여 CSV 파일을 원시 형식으로 관리하거나 스프레드시트 소프트웨어를 사용할 수 있습니다.

원시 CSV의 모습은 다음과 유사합니다.

동일한 카탈로그를 스프레드시트에서 볼 때는 다음과 같습니다.

.csv 형식으로 변환할 때 스프레드시트 소프트웨어는 셀 컨텐츠 둘레에 큰따옴표를 추가하여 셀 내의 쉼표가 셀 구분 기호로 작동하지 않도록 합니다. 또한 사용자 지정 다중 값 속성에 포함하는 JSON 문자열 값의 둘레에도 큰 따옴표를 추가합니다. 이는 원시 파일에서 바로 작업하는 것을 불편하게 할 수 있습니다. 예:

원시 카탈로그 CSV 파일을 직접 편집할 때는 주의하십시오.

API 사용

mbox 매개 변수의 배달 API를 이스케이프 처리된 JSON 배열을 포함하는 문자열 값으로 사용하여 다중 값 속성을 전달할 수 있습니다.

"execute": {
    "mboxes": [
      {
        "index": 0,
        "name": "first-mbox",
        "parameters": {
          "entity.id": "32323",
          "entity.categoryId": "My Category",
          "entity.MultiValueAttribute": "[\"X\", \"Y\", \"Z\"]"
        }
      }
    ]
  }

배달 및 엔티티 저장 API 사용에 대한 자세한 내용은 Adobe Recommendations API 설명서를 참조하십시오.

다중 값 속성에 연산자 사용 section_83C2288A805242D9A02EBC4F07DEE945

알고리즘 포함 규칙, 카탈로그 규칙 및 제외 규칙의 다중 값 사용자 지정 속성에 연산자를 적용할 때, 목록에 있는 하나 이상의 값이 연산(부울 or)을 통과하는 경우 결과는 true ​가 됩니다.

다음 예제에서는 규칙이 message contains abc입니다.

부정 연산자의 경우, 모든 속성 값이 연산을 통과해야 합니다(부울 and). 예를 들어 연산자가 notEquals이면 값이 일치하는 경우 결과는 false ​가 됩니다.

알고리즘 포함 규칙, 카탈로그 규칙 및 제외 규칙의 연산자 비헤이비어에 대해서는 다음 섹션을 참조하십시오.

다음과 같음

어떤 속성 값이든 입력 값과 같으면 결과는 true가 됩니다.

예: genre equals abc

다음과 같지 않음

입력 값과 같은 속성 값이 없으면 결과는 true가 됩니다.

예: genre not equals abc

다음 포함

속성 중 어떤 값이든 입력 값을 포함하면 결과는 true가 됩니다.

예: genre contains abc

다음을 포함하지 않음

속성 중 입력 값을 포함하는 값이 없으면 결과는 true가 됩니다.

예: genre does not contain abc

다음으로 시작

속성 중 어떤 값이든 입력 값으로 시작하면 결과는 true가 됩니다.

예: genre starts with abc

다음으로 끝남

속성 중 어떤 값이든 입력 값으로 끝나면 결과는 true가 됩니다.

예: genre ends with abc

다음보다 크거나 같음(숫자 값만 해당)

속성 값이 double로 변환됩니다. 규칙을 실행하는 동안 변환할 수 없는 속성은 건너뜁니다.

처리 후, 어떤 속성 값이든 입력 값보다 크거나 같으면 결과는 true가 됩니다.

예: price greater than or equal to 100

다음보다 작거나 같음(숫자 값만 해당)

속성 값이 double로 변환됩니다. 규칙을 실행하는 동안 변환할 수 없는 속성은 건너뜁니다.

처리 후, 어떤 속성 값이든 입력 값보다 작거나 같으면 결과는 true가 됩니다.

예: price less than or equal to 100

동적으로 일치(항목 기반 알고리즘에서만 사용 가능)

어떤 속성 값이든 입력 값과 일치하면 결과는 true가 됩니다.

예: genre matches abc

동적으로 일치하지 않음(항목 기반 알고리즘에서만 사용 가능)

어떤 속성 값이든 입력 값과 일치하면 결과는 false가 됩니다.

예: genre does not match abc

동적 범위(항목 기반 알고리즘에서만 사용 가능, 숫자 값만 해당)

숫자 속성 값이 지정된 범위 내에 있으면 결과는 true가 됩니다.

예: price dynamically ranges in 80% to 120% of 100

디자인의 다중 값 속성 section_F672E4F6E1D44B3196B7ADE89334ED4A

다중 값 속성은 디자인에서 참조할 때 쉼표로 구분된 목록으로 표시됩니다.

예:

디자인에서 entity.genre=["genre1","genre2"]가 $entity<N>.genre로 참조되는 경우 결과는 genre1, genre2입니다.

관련 항목: