하이터치 개인화 API

Hightouch의 개인화 API는 클라우드 데이터 웨어하우스에 있는 모든 데이터 세트를 기반으로 지연 시간이 짧은 데이터 API를 호스팅할 수 있는 관리형 서비스입니다.

Braze와 Hightouch의 통합을 통해 API를 Braze 연결된 콘텐츠와 함께 사용하면 전송 시점에 최신 고객 또는 오브젝트 데이터를 캠페인이나 캔버스로 가져올 수 있습니다.

Hightouch의 개인화 API는 Braze 구성 내에서 사용할 수 있는 REST 엔드포인트를 제공합니다. 특히 Braze의 연결된 콘텐츠 오퍼링을 사용하여 개인화 API에 GET 요청을 보내 특정 식별자와 관련된 모든 정보를 검색할 수 있습니다. 이 API를 통해 공개되는 데이터는 고객, 제품 또는 기타 오브젝트 데이터를 나타낼 수 있습니다.

전제 조건

• 사용 사례
• 데이터 세트

통합

1단계: Hightouch에 데이터 소스 연결

Hightouch 소스는 조직의 비즈니스 데이터가 있는 위치입니다. 이 경우 사용자 데이터가 저장되는 곳이면 어디든 가능합니다.

1. Hightouch에서 소스 개요 > 소스 추가로 이동합니다. 데이터 웨어하우스를 소스로 선택합니다.
   
   
2. 관련 자격 증명을 입력합니다(출처에 따라 다를 수 있음).

자세한 내용은 관련 소스 설명서를 참조하세요.

2단계: 모델 데이터

하이터치 모델은 소스에서 가져올 데이터를 정의합니다. 새 모델을 설정하려면 다음 단계를 따르세요:

1. Hightouch에서 모델 개요 > 모델 추가로 이동하여 방금 연결한 소스를 선택합니다.
   
   
2. 다음으로 모델링 방법을 선택합니다. 모든 정보가 하나의 테이블에 조인되어야 하므로 시각적 테이블 선택기를 사용하여 정의할 수 있습니다. 또는 원하는 열만 포함하도록 SQL을 작성하거나 기존 dbt 모델, Looker Look 또는 Sigma 통합 문서에 의존할 수 있습니다.
   
   
3. 계속하기 전에 모델을 미리 보고 관심 있는 데이터를 쿼리하고 있는지 확인합니다. 기본적으로 Braze는 미리 보기를 처음 100개의 레코드로 제한합니다. 데이터 유효성을 검사한 후 계속을 클릭합니다.
   
   
4. 모델 이름(예: “사용자 추천”)을 지정합니다.
   
   
5. 마지막으로, 기본 키를 선택하고 마침을 클릭합니다. 기본 키는 고유 식별자가 있는 열이어야 합니다. 개인화 API를 호출하여 특정 사용자의 추천을 검색하는 데 사용할 필드이기도 합니다.

3단계: 개인화 API 구성

요청을 받기 위한 API 준비는 두 단계로 이루어집니다:

• 인프라에서 가장 가까운 지역에서 개인화 API 활성화하기
• 동기화를 생성하여 하이터치 관리 캐시에서 구체화할 모델 정의하기

두 가지를 모두 완료하려면 다음 지침을 따르세요:

1. Hightouch에서 대상으로 이동하여 생성된 Hightouch 개인화 API를 선택합니다. 이 대상을 활성화하지 않은 경우 Hightouch 지원에 문의하세요.
   
   
2. 다음으로 적절한 지역을 선택합니다. 인프라에서 가장 가까운 지역을 선택하면 응답 시간을 줄일 수 있습니다. 인프라에서 가까운 지역이 표시되지 않는 경우 Hightouch 지원에 문의하세요.
   
   
3. 동기화 개요 페이지로 이동하여 동기화 추가 버튼을 클릭합니다. 그런 다음 관련 모델과 이전에 설정한 대상을 선택합니다.
   
   
4. 영숫자로 된 컬렉션 이름을 입력합니다. 컬렉션은 개념적으로 데이터베이스 테이블과 유사합니다. 각각 고객 또는 인보이스와 같은 특정 데이터 유형을 나타내야 합니다. 컬렉션 이름은 영숫자이어야 하며 개인화 API 엔드포인트의 일부가 됩니다.
   
   
5. 다음으로, 모델에서 레코드 조회를 위한 기본 인덱스로 사용할 열을 지정합니다. 이 필드는 모음의 각 레코드를 고유하게 식별해야 하며 종종 모델의 기본 키와 동일합니다. 개인화 API는 여러 인덱스에 대한 조회를 지원합니다. 예를 들어 user_id, anonymous_id 또는 email_address를 사용하여 고객 프로필을 검색할 수 있습니다. 여러 인덱스를 활성화하려면 Hightouch 지원에 문의하세요.
   
   
6. 필드 매퍼를 사용하여 모델의 어떤 열을 API 응답 페이로드에 포함할지 지정합니다. 이러한 필드의 이름을 변경하고 고급 매퍼를 사용하여 Liquid 템플릿 언어를 사용하여 변환을 적용할 수 있습니다.
   
   
7. 사용 사례에 적합한 삭제 동작을 선택합니다.
   
   
8. 마지막으로, 계속을 클릭한 다음, 동기화 스케줄을 선택합니다.

이제 Hightouch는 웨어하우스의 데이터를 관리형 데이터베이스에 동기화하여 개인화 API를 통해 공개합니다.

4단계: Braze 커넥티드 콘텐츠를 통한 개인화 API 호출

개인화 API 인스턴스를 설정한 후에는 Braze 연결된 콘텐츠 엔드포인트로 사용할 수 있습니다.

API는 https://personalization.{region}.hightouch.com 에서 액세스할 수 있습니다(예: https://personalization.us-west-2.hightouch.com).

이 엔드포인트 /v1/collections/:collection_name/records/:index_key/:index_value를 사용하여 정보를 사용할 수 있습니다.

예를 들어, 캠페인이나 캔버스에 이 스니펫을 포함할 수 있습니다:

1
2
3
4
5
6
7
8
9
{% connected_content
     https://personalization.us-west-2.hightouch.com/v1/collections/customer/records/id/12345
     :method get
     :headers {
       "Authorization": "Bearer {{YOUR-API-KEY}}"
  }
     :content_type application/json
     :save customer
%}

Liquid 템플릿을 사용하여 JSON 페이로드에서 반환된 속성정보를 참조하고 메시징에 사용할 수 있습니다.

다음은 페이로드 예제입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "user_id": 12345,
    "full_name": "Jane Doe",
    "lifetime_value": 1492.18,
    "churn_risk": 0.04,
    "90_day_summary": {
        "num_songs_listened": 813,
        "top_genres": [
            "house",
            "techno",
            "ambient"
        ],
        "top_artists": [
            "deadmau5",
            "Marsh",
            "Enamour"
        ],
    },
    "recommendations": {
        "concerts": [
            {
                "artist": "Aphex Twin",
                "location": "San Francisco, CA",
                "event_date": "2023-01-31"
            },
            {
                "artist": "Sultan + Shepard",
                "location": "San Francisco, CA",
                "event_date": "2023-02-25"
            }
        ],
        "upcoming_album_release": {
            "title": "Universal Language",
            "artist": "Simon Doty",
            "label": "Anjunadeep",
            "release_date": "2023-04-28"
        }
    },
}

다음 Liquid 참조는 이 예제 데이터를 반환합니다:

문제 해결

궁금한 점이 있으면 하이터치 지원팀에 문의하여 도움을 받으세요.