Algolia

Algolia es una plataforma de búsqueda y descubrimiento que ayuda a los desarrolladores a crear experiencias de búsqueda rápidas, relevantes y escalables. Con un potente enfoque API-first, Algolia combina algoritmos de clasificación avanzados con información impulsada por IA para una búsqueda fluida en el sitio, navegación y descubrimiento de contenido personalizado.

La integración de Algolia y Braze utiliza Contenido conectado para rellenar resultados de búsqueda y recomendaciones de productos impulsados por Algolia en tus mensajes de Braze. Al consultar la API de Algolia en el momento del envío, puedes entregar contenido personalizado que dirige a los usuarios a páginas de detalle de producto o páginas de inicio de alta conversión.

Casos de uso

• Promocionar productos en tendencia: Extrae automáticamente productos en tendencia o de alto rendimiento de Algolia en los mensajes de Braze para promocionar artículos de alto interés y aumentar la interacción.
• Personalizar campañas con inteligencia de búsqueda: Personaliza las campañas de Braze utilizando la inteligencia de búsqueda y navegación de Algolia para entregar productos o categorías alineados con los intereses de cada usuario.

Requisitos previos

Integración

Paso 1: Configura tu solicitud de API de Algolia

Para más información sobre formatos de solicitud, estructuras de respuesta y uso, consulta la documentación de la API de búsqueda de Algolia y la API de recomendaciones de Algolia. Si necesitas ayuda con la configuración, ponte en contacto con el equipo de Algolia.

• search api
• recommend 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"]
}

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
    }
  ]
}

Paso 2: Implementa Contenido conectado de Braze

Usa la característica de Contenido conectado de Braze para realizar llamadas a la API de los puntos de conexión de Algolia e inyectar dinámicamente la respuesta en un mensaje. Para más información sobre configuración, formato de solicitudes y mejores prácticas, consulta Contenido conectado.

• 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
%}

Paso 3: Da formato a los resultados de búsqueda en los mensajes de Braze

Después de obtener los resultados de Algolia, usa Liquid para analizar la respuesta de la API y renderizar dinámicamente los resultados dentro de tu mensaje.

• 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 %}

Consideraciones

Evitar consultas únicas

Ten en cuenta los límites de velocidad de Algolia definidos en tu contrato. Evita realizar consultas específicas por usuario, ya que pueden exceder rápidamente tus solicitudes asignadas. Para personalizar los resultados, apunta a un segmento en lugar de un ID de usuario individual, o filtra por categoría o marca en lugar de un objectID específico. Usa atributos de Braze para personalizar aún más las recomendaciones.

Almacenar en caché los resultados de Contenido conectado

Almacena en caché los resultados de Contenido conectado usando cache_max_age para minimizar las solicitudes de API a Algolia y mejorar el rendimiento. Para más información, consulta Almacenamiento en caché de respuestas.