Duplikatschutz für Nachrichten

Eine doppelte Nachricht ist die zweite und jede weitere Nachricht mit demselben Text an dieselbe Nummer. Absichtlich passiert das selten — häufiger entsteht sie durch einen wiederholten API-Aufruf nach einem Timeout, einen Doppelklick auf eine Schaltfläche oder dadurch, dass eine Nummer mehrfach in der Empfängerliste landet. BulkGate schützt Sie davor, aber die transaktionale und die werbliche Route gehen damit unterschiedlich um.

Wie sich die beiden Schutzmechanismen unterscheiden

Transaktionale Nachrichten: dieselbe Nachricht, wiederholt im Zeitverlauf

Sie aktivieren den Schutz mit dem Parameter duplicates_check in der transaktionalen oder der einfachen transaktionalen API. Er akzeptiert on und off (versteht auch true/false, 1/0, yes/no), der Standardwert ist off.

Ist er aktiviert, merkt sich BulkGate für jede gesendete Nachricht diese Kombination:

Kommt innerhalb von fünf Minuten eine Nachricht mit demselben Fingerabdruck, verwirft BulkGate sie und sie erreicht den Mobilfunkbetreiber nie.

Bei einer Kaskadennachricht verwendet der Fingerabdruck den Haupttext der Kaskade, nicht die Texte der einzelnen Kanäle.

Was Sie in der Antwort sehen

• Eine einzelne Nachricht — die API gibt den Fehler duplicity_message mit dem Code 400 zurück. Siehe die Liste der Fehlertypen.
• Eine transaktionale Massennachricht — die verworfene Nachricht erhält den Status duplicity_message und wird in total.status.duplicity_message gezählt. Der Rest des Stapels wird wie gewohnt gesendet.

Werbenachrichten: doppelte Empfänger innerhalb eines Stapels

Auf der werblichen Route wird zwischen Anfragen nichts gespeichert. BulkGate geht vor dem Versand einfach die Empfängerliste durch, die aus einer einzelnen Anfrage erstellt wurde, und behält das erste Vorkommen. Der Parameter duplicates_check in der werblichen oder der einfachen werblichen API hat drei Werte:

Zwei aufeinanderfolgende Anfragen sehen einander nicht. Senden Sie denselben Empfänger in zwei Stapeln, gehen beide Nachrichten hinaus.

Kampagnen im Portal

Eine Kampagne läuft über die werbliche Route und führt die Duplikatprüfung selbst durch — sobald die Empfängerliste erstellt ist, zeigt sie Ihnen unter der Überschrift Warnung für doppelte Nachrichten an, wie viele sie gefunden hat:

• Same number and same text (gleiche Nummer und gleicher Text) — diese entfernt die Kampagne immer, eine Wahl gibt es nicht.
• Same number, different text (gleiche Nummer, anderer Text) — hier entscheiden Sie selbst. Aktivieren Sie Doppelte Empfänger entfernen, erhält jede Nummer eine einzige Nachricht; lassen Sie es deaktiviert, gehen alle hinaus.

In einer Kampagne mit A/B-Test werden doppelte Empfänger immer entfernt, sonst würde eine Person mehrere getestete Varianten erhalten und das Testergebnis wäre wertlos.

Worauf Sie achten sollten

• Derselbe Parameter bedeutet zwei verschiedene Dinge. Auf der transaktionalen Route ist duplicates_check ein Schalter, der über Anfragen hinweg im Zeitverlauf schützt; auf der werblichen Route wählt er eine Methode und gilt nur innerhalb einer Anfrage.
• Ein gemeinsames Konto bedeutet ein gemeinsames Fenster. Mehrere Integrationen unter einem Wallet können gegenseitig ihre Nachrichten verwerfen, wenn sie dieselben Texte an dieselben Nummern senden.
• Eine verworfene Nachricht wird nicht gesendet, sie wird also weder zugestellt noch unter den gesendeten Nachrichten erfasst.
• Prüfen Sie die Zahlen in der Antwort. Die werbliche Route meldet keine Entfernungen — wenn Sie die Zustellungen mit Ihrer Eingabeliste vergleichen, rechnen Sie mit der Differenz.