Algolia

Algolia est une plateforme de recherche et de découverte qui aide les développeurs à créer des expériences de recherche rapides, pertinentes et évolutives. Grâce à une approche API-first, Algolia combine des algorithmes de classement avancés avec des informations basées sur l’intelligence artificielle pour offrir une recherche fluide sur site, une navigation et une découverte de contenu personnalisée.

L’intégration d’Algolia et de Braze utilise le Contenu connecté pour alimenter les résultats de recherche et les recommandations produit propulsés par Algolia dans vos messages Braze. En interrogeant l’API d’Algolia au moment de l’envoi, vous pouvez fournir du contenu personnalisé qui dirige les utilisateurs vers des pages de détail produit ou des pages d’accueil à fort taux de conversion.

Cas d’utilisation

• Promouvoir les produits tendance : Intégrez automatiquement les produits tendance ou les plus performants d’Algolia dans les messages Braze pour promouvoir les articles à fort intérêt et augmenter l’engagement.
• Personnaliser les campagnes avec l’intelligence de recherche : Personnalisez les Campaigns Braze en utilisant l’intelligence de recherche et de navigation d’Algolia pour proposer des produits ou des catégories alignés sur les intérêts de chaque utilisateur.

Conditions préalables

Intégration

Étape 1 : Configurer votre requête API Algolia

Pour plus d’informations sur les formats de requête, les structures de réponse et l’utilisation, consultez la documentation de l’API Algolia Search et de l’API Algolia Recommend. Si vous avez besoin d’aide pour la configuration, contactez l’équipe 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
    }
  ]
}

Étape 2 : Implémenter le Contenu connecté Braze

Utilisez la fonctionnalité Contenu connecté de Braze pour effectuer des appels API vers les endpoints Algolia et injecter dynamiquement la réponse dans un message. Pour plus d’informations sur la configuration, le formatage des requêtes et les bonnes pratiques, consultez Contenu connecté.

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

Étape 3 : Formater les résultats de recherche dans les messages Braze

Après avoir récupéré les résultats d’Algolia, utilisez Liquid pour analyser la réponse de l’API et afficher dynamiquement les résultats dans votre message.

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

Considérations

Éviter les requêtes uniques

Soyez attentif aux limites de débit Algolia définies dans votre contrat. Évitez d’effectuer des requêtes spécifiques à l’utilisateur, car celles-ci peuvent rapidement dépasser le nombre de requêtes allouées. Pour personnaliser les résultats, ciblez un segment plutôt qu’un ID utilisateur individuel, ou filtrez par catégorie ou marque plutôt que par un objectID spécifique. Utilisez les attributs Braze pour personnaliser davantage les recommandations.

Mise en cache des résultats du Contenu connecté

Mettez en cache les résultats du Contenu connecté à l’aide de cache_max_age pour minimiser les requêtes API vers Algolia et améliorer les performances. Pour plus d’informations, consultez Mise en cache des réponses.