Wiederholungslogik für Connected-Content verwenden

Auf dieser Seite erfahren Sie, wie Sie Wiederholungsversuche zu Ihren Connected-Content-Aufrufen hinzufügen.

Funktionsweise von Wiederholungsversuchen

Da Connected-Content auf den Empfang von Daten aus APIs angewiesen ist, kann eine API vorübergehend nicht verfügbar sein, während Braze den Aufruf durchführt. In diesem Fall unterstützt Braze eine Wiederholungslogik, um die Anfrage mit exponentiellem Backoff erneut zu versuchen.

Hinweis

Connected-Content :retry ist für In-App Messages und Banner nicht verfügbar.

Wiederholungsverhalten in Canvas-Schritten

Connected-Content-Aufrufe in einem Canvas werden nur dann wiederholt, wenn der Aufruf :retry enthält. Das Verhalten unterscheidet sich je nach Schritttyp:

• Nachrichtenschritte: Connected-Content mit :retry verwendet weiterhin die Messaging-Pipeline. Empfänger:innen werden in der Sendewarteschlange verzögert, während Braze den Aufruf bis zu fünfmal wiederholt. Wenn jeder Wiederholungsversuch fehlschlägt, wird die Nachricht abgebrochen und die Nutzer:innen gehen zum nächsten Schritt weiter. Weitere Details finden Sie unter Wenn der API-Aufruf fehlschlägt und Wiederholungsversuche aktiviert sind.
• Kontext- und Nutzer:innen-Update-Schritte: Braze wiederholt den Connected-Content-Aufruf auf Schrittebene (bis zu fünfmal). Wenn jeder Wiederholungsversuch fehlschlägt, verlassen die Nutzer:innen das Canvas.

Bei Kontext- und Nutzer:innen-Update-Schritten können bestimmte wiederholbare Schrittfehler – wie ein fehlgeschlagener Abruf eines Aktionscodes oder ein unerwarteter Schrittfehler – zusätzliche Wiederholungsversuche auf Schrittebene mit exponentiellem Backoff (ca. 13 Mal) auslösen, bevor Braze die Nutzer:innen aus dem Canvas entfernt.

Weitere Informationen finden Sie unter Wiederholungsverhalten.

Retry-Logik verwenden

Um Retry-Logik zu verwenden, fügen Sie dem Connected-Content-Aufruf das :retry-Tag hinzu, wie im folgenden Code-Snippet gezeigt:

1
2

{% connected_content https://yourwebsite.com/api/endpoint :retry %}
{% connected_content https://www.braze.com :save my_content :basic_auth auth_name :retry %}

Wenn ein :retry-Tag im Connected-Content-Aufruf enthalten ist, versucht Braze den Aufruf bis zu fünfmal zu wiederholen.

Vorschauverhalten

Die Retry-Logik gilt nur für Live-Sendungen (einschließlich Testsendungen), nicht für Vorschauen. Wenn ein Connected-Content-Aufruf mit :retry während der Vorschau fehlschlägt, zeigt die Vorschau möglicherweise die Nachricht „This message would not have been shown because retry functionality was triggered“ an, anstatt den Inhalt zu rendern. Dies ist erwartetes Verhalten und weist nicht auf ein Problem innerhalb von Braze hin.

Ergebnisse der Wiederholungsversuche

Wenn ein Wiederholungsversuch erfolgreich ist

Wenn ein Wiederholungsversuch erfolgreich ist, wird die Nachricht gesendet und es werden keine weiteren Wiederholungsversuche für diese Nachricht unternommen.

Wenn der API-Aufruf fehlschlägt und Wiederholungsversuche aktiviert sind

Wenn der API-Aufruf fehlschlägt und diese Funktion aktiviert ist, wiederholt Braze den Aufruf unter Einhaltung des Rate-Limits, das Sie für jeden erneuten Versand festgelegt haben. Braze verschiebt fehlgeschlagene Nachrichten ans Ende der Warteschlange und fügt bei Bedarf zusätzliche Minuten zur Gesamtzeit hinzu, die für den Versand Ihrer Nachricht benötigt wird.

Wenn der Connected-Content-Aufruf mehr als fünfmal fehlschlägt, wird die Nachricht abgebrochen, ähnlich wie bei Auslösung eines Abort-Message-Tags.

Connected-Content-Aufrufe mit Abbruch- und Wiederholungslogik

Wenn ein Connected-Content-Aufruf Abbruchlogik für dieselbe Bedingung wie die Wiederholungslogik verwendet, hat die Abbruchlogik Vorrang. Dadurch werden keine Wiederholungsversuche unternommen. Die Wiederholungslogik sendet den Aufruf bereits erneut, bevor sie ihn abbricht, wenn der Statuscode nicht erfolgreich ist. Da beide auf dasselbe Statuscode-Verhalten abzielen, können Sie die Abbruchlogik entfernen, und der Aufruf wird trotzdem abgebrochen, wenn alle Wiederholungsversuche fehlschlagen.