Einstein Recommendations

Einstein Recommendations API에는 활동을 수신하고 추천 제품을 출력하는 2가지 기본 기능이 있습니다. 고객은 영역 구성요소를 사용하여 코드를 변경하지 않고도 Recommender를 유연하게 전환할 수도 있습니다.

이 API 설명서는 기본적으로 Salesforce Commerce Cloud 고객을 대상으로 합니다.

Einstein Recommendations API에 대한 액세스를 활성화하려면 Einstein Configurator로 이동하고 API 페이지에서 Commerce Cloud Account Manager 클라이언트 ID를 입력합니다. 사이트 관리자 액세스를 사용하여 Account Manager 페이지에서 필요한 클라이언트 ID를 생성할 수 있습니다. 자세한 내용은 API 클라이언트 ID 추가를 참조하십시오.

활성화된 시점에 올바른 클라이언트 ID가 전달되면 프로덕션, 스테이징, 개발 및 샌드박스 인스턴스를 포함한 모든 환경에서 API가 작동합니다.

각 API 호출은 API 키 인증을 위해 x-cq-client-id 헤더를 전달해야 합니다.

클라이언트 측 또는 서버 측에서 API를 구현할 경우 몇 가지 절충되는 부분이 있습니다. 클라이언트 ID를 보안할 수 있도록 보안을 강화하기 위해 서버 측에서 API를 구현하는 것이 좋습니다. 클라이언트 측에서 구현할 경우 클라이언트 ID가 악의적인 사용자에게 노출된 위험이 있습니다.

추천을 가져오는 요청과 viewProduct, viewReco 및 clickReco와 같은 특정 사용자 활동에서는 서버 측에서 구현할 경우에 캐싱을 고려해야 합니다. 예를 들어, 사용자가 캐시된 제품 페이지를 보는 경우 viewProduct 활동은 계속 보내야 합니다. 이때 Einstein이 모든 이벤트를 수신하고 추천은 캐시되지 않아야 합니다.

이 Einstein Recommendations API는 이메일 추천 사용 사례를 위해 제작되지 않았습니다. 따라서 Einstein Recommendations를 이메일에 포함하는 기능을 지원하지 않습니다.

자사 서비스는 전 세계적으로 분산되어 있으며 수평적으로 확장 가능합니다. 그리고 트래픽에 기반하여 자동으로 확장 및 축소되기 때문에 부하 테스트가 필요하지 않습니다. 부하 테스트는 추천 결과에 영향을 주므로 피하는 것이 좋습니다.

각 구매자에 대한 관련 제품 추천을 생성하는 데 도움을 주기 위해 Einstein Recommendations API는 구매자 식별을 위한 매개변수를 제공합니다.

잠재적으로 악의적인 활동을 피하기 위해 사용자 식별자 매개변수는 순차적으로 정렬되지 않아야 합니다. 매개변수에는 시퀀스, 패턴, IP 주소, 이메일 주소, 이름 또는 특정 사람과 연관시킬 수 있는 기타 정보가 포함되어서는 안 됩니다. 모든 사용자 식별자 매개변수는 해싱 또는 기타 방법을 통해 GDPR(General Data Protection Regulation)을 준수해야 합니다.
  • cookieId(필수) - 익명 구매자의 고유한 식별자입니다. 일반적으로 cookieId는 퍼스트 파티 쿠키의 값입니다.
    • 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록 cqcid 쿠키 값을 전달합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오.
    • Salesforce Commerce API를 사용하는 경우 토큰 검색 프로세스의 일부로 제공되는 USID 값을 전달합니다. 자세한 내용은 Shopper Login 및 API Access Service 설명서를 참조하십시오.
    • OCAPI를 사용하는 경우에는 자동 활동과 일치하도록 게스트 로그인 응답에서 visit_id 값을 전달합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.
  • userId(권장) - 로그인한 구매자의 고유한 식별자입니다. 이 매개변수를 사용하면 Einstein이 여러 기기에서 로그인한 동일한 사용자를 링크할 수 있습니다.
    • 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록 cquid 쿠키 값을 전달합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오.
    • Salesforce Commerce API를 사용하는 경우에는 자동 활동과 일치하도록 등록된 로그인 응답에서 hashed_login 값을 전달합니다. 자세한 내용은 Shopper Login 및 API Access Service 설명서를 참조하십시오.
    • OCAPI를 사용하는 경우에는 자동 활동과 일치하도록 등록된 로그인 응답에서 hashed_login 값을 전달합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.

Einstein API를 통해 사용하는 Recommender에 대한 표준 성능 보고는 디지털 사이트에서 사용하는 기타 Recommender의 보고 기능과 동일합니다. Einstein Reports and Dashboard에서 보고를 확인할 수 있습니다(Einstein Reports and Dashboard에 대한 자세한 내용은 이 문서 참조).

별도로 보고 및 문제 해결을 보다 쉽게 수행하려면 Einstein API에 대한 별도의 Recommender를 생성하는 것이 좋습니다. 예를 들어, Recommender 이름을 "pdp-mobile-API"로 지정하면 모바일 앱의 제품 세부 정보 페이지에서 Recommender가 사용됨을 나타냅니다.

보고 지표는 활동에 기반합니다. Einstein Recommendations API를 사용하는 애플리케이션이 활동을 보내지 못하면 API Recommender의 모든 지표가 영(0)으로 표시됩니다.

Rights of ALBERT EINSTEIN are used with permission of The Hebrew University of Jerusalem. Represented exclusively by Greenlight.