[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\"]"
        }
      }
    ]
  }

다음을 참조하십시오. Adobe Recommendations API 설명서 게재 및 엔티티 저장 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입니다.

관련 항목: