Skip to content

Algolia

Algolia ist eine Such- und Discovery-Plattform, die Entwickler:innen dabei unterstützt, schnelle, relevante und skalierbare Sucherlebnisse zu erstellen. Mit einem leistungsstarken API-First-Ansatz kombiniert Algolia fortschrittliche Ranking-Algorithmen mit KI-gestützten Insights für nahtlose Website-Suche, Navigation und personalisierte Inhaltsentdeckung.

Die Integration von Algolia und Braze nutzt Connected-Content, um Algolia-gestützte Suchergebnisse und Produktempfehlungen in Ihren Braze-Nachrichten bereitzustellen. Durch die Abfrage der Algolia-API zum Sendezeitpunkt können Sie personalisierte Inhalte liefern, die Nutzer:innen zu Produktdetail- oder Landing-Pages mit hoher Conversion führen.

Anwendungsfälle

  • Trendprodukte bewerben: Ziehen Sie automatisch trendige oder leistungsstarke Produkte aus Algolia in Braze-Nachrichten, um stark nachgefragte Artikel zu bewerben und das Engagement zu steigern.
  • Campaigns mit Suchintelligenz personalisieren: Personalisieren Sie Braze Campaigns mithilfe der Such- und Browsing-Intelligenz von Algolia, um Produkte oder Kategorien bereitzustellen, die auf die Interessen der einzelnen Nutzer:innen abgestimmt sind.

Voraussetzungen

Integration

1. Schritt: Algolia-API-Anfrage einrichten

Weitere Informationen zu Anfrageformaten, Antwortstrukturen und Nutzung finden Sie in der Dokumentation zur Algolia Search API und Algolia Recommend API. Wenn Sie Unterstützung bei der Einrichtung benötigen, kontaktieren Sie das Algolia-Team.

Beispiel einer Search-API-Anfrage

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}

Beispiel eines Abfrage-Payloads

1
2
3
4
5
6

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

In diesem Beispiel ruft die Abfrage die vier besten Ergebnisse von einer Seite ab, die einen Kategoriefilter basierend auf einem Attribut namens category_page_id verwendet. Der Parameter attributesToRetrieve begrenzt die Antwort, um den Payload in einer handhabbaren Größe zu halten.

Beispiel-Anwendungsfall: Um Suchergebnisse von https://www.yoursite.com/weekly-offers in einer wöchentlichen Angebots-Campaign in Braze zu präsentieren, fragen Sie den entsprechenden Algolia-Index ab und wenden Sie Filter an, um die besten Ergebnisse dieser Seite abzurufen.

Beispiel einer Recommend-API-Anfrage

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}

Beispiel eines Abfrage-Payloads

1
2
3
4
5
6
7
8
9
10

{
  "requests": [
    {
      "indexName": "prod_ECOM",
      "model": "trending-items",
      "threshold": 40,
      "maxRecommendations": 4
    }
  ]
}

Die Recommend API unterstützt mehrere Modelle, darunter Frequently Bought Together, Related Products, Trending Items, Trending Facet Values und Looking Similar. Dieses Beispiel verwendet das Modell Trending Items.

2. Schritt: Braze Connected-Content implementieren

Verwenden Sie das Connected-Content-Feature von Braze, um API-Aufrufe an Algolia-Endpunkte zu senden und die Antwort dynamisch in eine Nachricht einzuspeisen. Weitere Informationen zu Konfiguration, Anfrageformatierung und Best Practices finden Sie unter Connected-Content.

Beispiel einer Connected-Content-Suchanfrage

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

Beispiel einer Connected-Content-Empfehlungsanfrage

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. Schritt: Suchergebnisse in Braze-Nachrichten formatieren

Nachdem Sie Ergebnisse von Algolia abgerufen haben, verwenden Sie Liquid, um die API-Antwort zu parsen und die Ergebnisse dynamisch in Ihrer Nachricht darzustellen.

Beispiel eines Liquid-E-Mail-Templates für die Search 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 %}

Dies generiert eine Liste von Produkten aus den Search-API-Ergebnissen im Nachrichtentext. Jeder Produktlink leitet Nutzer:innen zu einer Produktdetailseite (PDP) oder einer Campaign-spezifischen Landing-Page weiter.

Beispiel eines Liquid-E-Mail-Templates für die Recommend API

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

Dies generiert eine Liste empfohlener Produkte aus den Recommend-API-Ergebnissen im Nachrichtentext. Jeder Produktlink leitet Nutzer:innen zu einer Produktdetailseite (PDP) oder einer Campaign-spezifischen Landing-Page weiter.

Hinweise

Eindeutige Abfragen vermeiden

Beachten Sie die in Ihrem Vertrag definierten Algolia-Rate-Limits. Vermeiden Sie nutzerspezifische Abfragen, da diese Ihr zugewiesenes Anfragekontingent schnell überschreiten können. Um Ergebnisse zu personalisieren, zielen Sie auf ein Segment statt auf eine einzelne Nutzer-ID ab, oder filtern Sie nach Kategorie oder Marke statt nach einer bestimmten objectID. Verwenden Sie Braze-Attribute, um die Empfehlungen weiter zu personalisieren.

Connected-Content-Ergebnisse cachen

Cachen Sie Connected-Content-Ergebnisse mit cache_max_age, um API-Anfragen an Algolia zu minimieren und die Performance zu verbessern. Weitere Informationen finden Sie unter Antworten cachen.
New Stuff!