Algolia

Algolia는 개발자가 빠르고 관련성 높으며 확장 가능한 검색 경험을 구축할 수 있도록 돕는 검색 및 디스커버리 플랫폼입니다. 강력한 API 우선 접근 방식을 통해 Algolia는 고급 랭킹 알고리즘과 AI 기반 인사이트를 결합하여 원활한 사이트 검색, 내비게이션 및 개인화된 콘텐츠 디스커버리를 제공합니다.

Algolia와 Braze 통합은 연결된 콘텐츠를 사용하여 Algolia 기반 검색 결과와 제품 추천을 Braze 메시지에 채웁니다. 발송 시점에 Algolia의 API를 쿼리하여 사용자를 높은 전환율의 제품 상세 페이지 또는 랜딩 페이지로 유도하는 개인화된 콘텐츠를 전달할 수 있습니다.

활용 사례

• 인기 제품 홍보: Algolia에서 인기 또는 최고 성과 제품을 자동으로 가져와 Braze 메시지에 포함시켜 관심도가 높은 아이템을 홍보하고 참여를 높입니다.
• 검색 인텔리전스로 캠페인 개인화: Algolia 검색 및 브라우징 인텔리전스를 활용하여 Braze Campaign을 개인화하고, 각 사용자의 관심사에 맞는 제품이나 카테고리를 전달합니다.

필수 조건

통합

1단계: Algolia API 요청 설정

요청 형식, 응답 구조 및 사용법에 대한 자세한 내용은 Algolia Search API 및 Algolia Recommend API 설명서를 참조하세요. 설정에 도움이 필요하면 Algolia 팀에 문의하세요.

• search api
• recommend api

Search API 요청 예시

1
2
3
4
POST https://{ALGOLIA_APP_ID}-dsn.algolia.net/1/indexes/{INDEX_NAME}/query
Content-Type: application/json
X-Algolia-API-Key: {ALGOLIA_API_KEY}
X-Algolia-Application-Id: {ALGOLIA_APP_ID}

쿼리 페이로드 예시

1
2
3
4
5
6
{
  "query": "",
  "hitsPerPage": 4,
  "filters": "category_page_id:'this week's offers'",
  "attributesToRetrieve": ["name", "price", "image", "url"]
}

이 예시에서 쿼리는 category_page_id라는 속성을 기반으로 카테고리 필터를 사용하는 페이지에서 상위 4개 결과를 가져옵니다. attributesToRetrieve 파라미터는 페이로드를 관리 가능한 크기로 유지하기 위해 응답을 제한합니다.

사용 사례 예시: 주간 특가 Braze Campaign에 https://www.yoursite.com/weekly-offers의 검색 결과를 포함하려면, 해당 Algolia 인덱스를 쿼리하고 필터를 적용하여 해당 페이지의 상위 결과를 가져옵니다.

팁

attributesToRetrieve를 사용하여 평점, 리뷰 또는 할인 등의 추가 필드를 가져와 개인화를 강화하세요.

Recommend API 요청 예시

1
2
3
4
POST https://{ALGOLIA_APP_ID}.algolia.net/1/indexes/*/recommendations
Content-Type: application/json
X-Algolia-API-Key: {ALGOLIA_API_KEY}
X-Algolia-Application-Id: {ALGOLIA_APP_ID}

쿼리 페이로드 예시

1
2
3
4
5
6
7
8
9
10
{
  "requests": [
    {
      "indexName": "prod_ECOM",
      "model": "trending-items",
      "threshold": 40,
      "maxRecommendations": 4
    }
  ]
}

Recommend API는 Frequently Bought Together, Related Products, Trending Items, Trending Facet Values, Looking Similar 등 여러 모델을 지원합니다. 이 예시에서는 Trending Items 모델을 사용합니다.

중요

추천이 사용자별 속성이나 objectID에 의존하는 경우, Algolia 계약에 정의된 사용량 제한에 유의하세요. 모범 사례는 고려 사항 섹션을 참조하세요.

2단계: Braze 연결된 콘텐츠 구현

Braze의 연결된 콘텐츠 기능을 사용하여 Algolia 엔드포인트에 API 호출을 수행하고 응답을 메시지에 동적으로 삽입합니다. 구성, 요청 형식 및 모범 사례에 대한 자세한 내용은 연결된 콘텐츠를 참조하세요.

• search api
• recommend api

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{% capture request_body %}
{
  "query": "",
  "hitsPerPage": 4,
  "filters": "category_page_id:'this week's offers'",
  "attributesToRetrieve": ["name", "price", "image", "url"]
}
{% endcapture %}

{% connected_content https://{{ALGOLIA_APP_ID}}-dsn.algolia.net/1/indexes/{{INDEX_NAME}}/query
  :method post
  :headers {"X-Algolia-API-Key":"{{ALGOLIA_API_KEY}}", "X-Algolia-Application-Id":"{{ALGOLIA_APP_ID}}", "Content-Type": "application/json"}
  :body {{request_body}}
  :save algolia_search
%}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{% capture request_body %}
{
  "requests": [
    {
      "indexName": "prod_ECOM",
      "model": "trending-items",
      "threshold": 40,
      "maxRecommendations": 4
    }
  ]
}
{% endcapture %}

{% connected_content https://{{ALGOLIA_APP_ID}}.algolia.net/1/indexes/*/recommendations
  :method post
  :headers {"X-Algolia-Application-Id":"{{ALGOLIA_APP_ID}}", "X-Algolia-API-Key":"{{ALGOLIA_API_KEY}}", "Content-Type": "application/json"}
  :body {{request_body}}
  :save algolia_recommendations
%}

3단계: Braze 메시지에서 검색 결과 포맷 지정

Algolia에서 결과를 가져온 후 Liquid를 사용하여 API 응답을 구문 분석하고 메시지 내에서 결과를 동적으로 렌더링합니다.

• search api
• recommend api

1
2
3
4
5
6
7
8
{% for item in algolia_search.hits %}
  <div style="margin-bottom: 10px;">
    <img src="{{ item.image }}" alt="{{ item.name }}" width="100"/>
    <p><strong>{{ item.name }}</strong></p>
    <p>Price: ${{ item.price }}</p>
    <a href="{{ item.url }}">View Product</a>
  </div>
{% endfor %}

1
2
3
4
5
6
7
8
{% for item in algolia_recommendations.hits %}
  <div style="margin-bottom: 10px;">
    <img src="{{ item.image }}" alt="{{ item.name }}" width="100"/>
    <p><strong>{{ item.name }}</strong></p>
    <p>Price: ${{ item.price }}</p>
    <a href="{{ item.url }}">View Product</a>
  </div>
{% endfor %}

고려 사항

고유 쿼리 방지

Algolia 계약에 정의된 사용량 제한에 유의하세요. 사용자별 쿼리는 할당된 요청 수를 빠르게 초과할 수 있으므로 피하세요. 결과를 개인화하려면 개별 사용자 ID 대신 Segment를 타겟팅하거나, 특정 objectID 대신 카테고리 또는 브랜드로 필터링하세요. Braze 속성을 사용하여 추천을 추가로 개인화할 수 있습니다.

연결된 콘텐츠 결과 캐싱

cache_max_age를 사용하여 연결된 콘텐츠 결과를 캐싱하면 Algolia에 대한 API 요청을 최소화하고 성능을 향상시킬 수 있습니다. 자세한 내용은 응답 캐싱을 참조하세요.