Protokoll und Einstellungen des SMS-Connectors sms-connector-protocol

Übersicht overview

SMS ist zwar auf das Senden kurzer Textnachrichten ohne Formatierung beschränkt, aber ihre Einfachheit macht sie zu einem wertvollen Kommunikationskanal.

Es gibt zwei Möglichkeiten, eine SMS zu senden:

In diesem Dokument erhalten Sie Informationen zur Einrichtung einer Verbindung zwischen Adobe Campaign und einem SMPP-Provider.

SMPP-Provider können manchmal von der offiziellen Spezifikation abweichen. Der SMS-Connector in Adobe Campaign bietet aber viele Optionen zum Anpassen seines Verhaltens, um die Kompatibilität mit den meisten Providern sicherzustellen.

SMS-Typen sms-types

Beim Senden von Massen-SMS über einen SMS-Provider kommen drei verschiedene Arten von SMS-Nachrichten vor:

Sie müssen zwischen Quittungen (RESP PDU, Teil des SMPP-Protokolls) und SR unterscheiden: SR ist eine Art SMS, die über das Netzwerk gesendet wird, während eine Quittung nur bestätigt, dass eine Übertragung erfolgreich war.

Sowohl Quittungen als auch SR können Fehler auslösen, wobei die Unterscheidung zwischen den beiden bei der Fehlerbehebung hilft.

Von einer SMS übertragene Informationen information-sms

Eine SMS enthält mehr Informationen als Text. Hier ist eine Liste der Informationen, die Sie in einer SMS erwarten können:

SMPP-Protokoll smpp-protocol

Adobe Campaign Standard unterstützt das SMPP-Protokoll Version 3.4. Dies ist ein weit verbreitetes Protokoll, das den Versand von SMS an einen Provider (SMSC) sowie den Empfang von SMS und Quittungen ermöglicht. Weitere Informationen finden Sie in der SMPP-Dokumentation.

Die Netzwerkgeräte auf der Seite des SMS-Dienstleisters werden oft als SMSC bezeichnet.

SMPP-Verbindungen smpp-connections

Adobe Campaign verbindet sich über TCP mit den Netzwerkgeräten des SMS-Dienstleisters. Das SMPP-Protokoll stellt permanente TCP-Verbindungen von Adobe Campaign zum Provider her. Die TCP-Verbindungen werden immer von Adobe Campaign initiiert, auch wenn es um den Empfang von Nachrichten geht.
SMPP öffnet je nach Modus 1 oder 2 TCP-Verbindungen. Alle Verbindungen werden immer von Adobe Campaign initiiert.

Das SMPP-Protokoll kann in zwei Modi verwendet werden:

SMPP-PDU smpp-pdu

SMPP-Übertragungseinheiten ("Pakete") werden PDUs genannt. Eine PDU enthält einen Befehl, einen Status, eine Sequenznummer und Daten.

Jede PDU muss durch eine SMPP RESP PDU (synchrone Antwort) quittiert werden. Anfragen können in einer Pipeline zusammengefasst werden: Der Absender kann viele Befehle senden, ohne auf RESP zu warten. Die Anzahl der Anfragen, die zu einem beliebigen Zeitpunkt in einer Pipeline zusammengefasst werden können, wird als Fenster bezeichnet. RESP PDU können in jeder beliebigen Reihenfolge eintreffen und sind unabhängig von der Reihenfolge ihrer Initiator-PDU.

Im getrennten Transmitter + Receiver-Modus hängt die verwendete Verbindung von der Art der gesendeten Nachricht ab. Die Senderverbindung wird für MT verwendet, und die Empfängerverbindung wird für MO und SR verwendet. Anfragen und Antworten für jede Art von Nachricht werden über dieselbe TCP-Verbindung gesendet.

Wenn beispielsweise ein MT gesendet wird, wird die Senderverbindung verwendet und die RESP, die den MT quittiert, wird auch über den Senderkanal gesendet. Wenn Sie einen MO (oder einen SR) erhalten, wird die Empfängerverbindung verwendet, um den MO zu empfangen und die RESP zu senden, die den MO quittiert.

In Adobe Campaign Standard ist die Abstimmung von MT und SR nativ im MTA enthalten, es gibt also keinen eigenen SMS-Prozess.

Eine erfolgreiche SUBMIT_SM_RESP PDU löst im Versandprotokoll den Nachrichtenstatus "gesendet" aus, während eine erfolgreiche DELIVER_SM (SR) PDU den Nachrichtenstatus "empfangen" auslöst.

Sicherheitsaspekte security-aspects

Das Protokoll selbst ist nicht verschlüsselt. Die meisten Provider implementieren eine Variante von "IP auf Zulassungsliste", sodass die IP-Adressen der Adobe Campaign-Server dem Provider mitgeteilt werden müssen.

Adobe Campaign unterstützt die Übergabe von Anmelde- und Kennwortdaten während der Bindungsphase. SMPP über TLS wird ebenfalls unterstützt. Es ist zu beachten, dass für die Gewährleistung eines ordnungsgemäßen Schutzes Zertifikate erforderlich sind. Obwohl der SMPP-Connector das Umgehen von Zertifikatprüfungen erlaubt, sollte dies nur zum Testen verwendet werden, da TLS ohne Zertifikate einen wesentlich geringeren Schutz bietet.

Der Connector verwendet die Standardzertifikate, die von der Systembibliothek openssl bereitgestellt werden. Normalerweise wird diese vom /etc/ssl/certs-Verzeichnis auf Debian bereitgestellt. Dieses Verzeichnis wird standardmäßig durch das Package "ca-certificates" bereitgestellt, kann aber angepasst werden.

Informationen in den verschiedenen PDU-Arten information-pdu

Jede Art von PDU verfügt über verschiedene Felder, die unterschiedliche Informationen enthalten. Diese PDUs sind in der Spezifikation von SMPP Version 3.4 aufgeführt.

In jedem der folgenden Abschnitte werden die PDU und ihre synchrone Antwort (*_RESP PDU) beschrieben. Alle PDUs müssen mit einer entsprechenden RESP quittiert werden. Dies ist ein obligatorischer Teil der Spezifikation.

PDUs können optionale Felder haben. Hier werden nur die gebräuchlichsten Felder beschrieben. Weitere Informationen finden Sie in der Spezifikation von SMPP Version 3.4.

BIND_TRANSMITTER / BIND_RECEIVER / BIND_TRANSCEIVER bind-transmitter

Mit dieser PDU wird eine Verbindung zum SMSC initiiert. Die Modi Transmitter, Receiver und Transceiver ändern nur die Art der SMS, die über diese Verbindung übertragen werden darf:

Wichtige Felder in einer BIND_* PDU:

BIND_*_RESP hat kein bestimmtes Feld; bestätigt, ob die Verbindung erfolgreich war oder nicht.

UNBIND unbind

Diese PDU muss vom System gesendet werden, bevor die Verbindung getrennt wird. Es muss auf die passende UNBIND_RESP PDU warten, bevor die Verbindung geschlossen wird.

Das konforme SMSC darf die Verbindung nicht schließen, die TCP-Verbindung wird über den Adobe Campaign-Connector gesteuert.

SUBMIT_SM submit-sm

Diese PDU sendet einen MT an das SMSC. Seine Antwort-PDU gibt die ID des MT an.

Wichtige Felder in einer SUBMIT_SM PDU:

Adobe Campaign unterstützt die folgenden optionalen Felder:

SUBMIT_SM_RESP submit-sm-resp

Diese PDU enthält die ID des MT. Dies ist nützlich, um sie mit dem eingehenden SR abzugleichen.

Einige Provider senden SUBMIT_SM_RESP nach dem Versand des SR. Um dieses Verhalten zu berücksichtigen, wartet Adobe Campaign 30 Sekunden, bevor mit Ungültige Nachrichten-ID auf einen SR mit einer unbekannten ID geantwortet wird.

DELIVER_SM delivery-sm

Diese PDU wird vom SMSC an Adobe Campaign gesendet. Sie enthält entweder einen MO oder einen SR.

Die meisten Felder haben dieselbe Bedeutung wie ihr SUBMIT_SM-Gegenstück. Hier ist die Liste nützlicher Felder:

Adobe Campaign kann die Nachrichtenkennung im optionalen Feld receipted_message_id mit einer Konfigurationseinstellung lesen.

DELIVER_SM_RESP deliver-sm-resp

Diese PDU wird von Adobe Campaign gesendet, um SR und MO zu quittieren.

Adobe Campaign Standard sendet nur dann eine DELIVER_SM_RESP, wenn alle Verarbeitungsschritte erfolgreich waren. Damit ist sichergestellt, dass kein SR oder MO quittiert wird, solange noch die Gefahr von Verarbeitungsfehlern besteht.

ENQUIRE_LINK enquire-links

Diese PDU wird nur verwendet, um zu überprüfen, ob die Verbindung live ist. Ihre Häufigkeit sollte entsprechend den Bedürfnissen des Providers festgelegt werden.

Die Standardeinstellung von 60 Sekunden entspricht den meisten im externen Konto festgelegten Konfigurationen.

ENQUIRE_LINK_RESP enquire-links-resp

Diese PDU quittiert, dass die Verbindung aktiv ist.

Mehrteilige SMS (lange SMS) multipart

Mehrteilige SMS oder lange SMS sind SMS, die in mehreren Teilen gesendet werden. Aufgrund technischer Einschränkungen im Mobilfunknetzprotokoll kann eine SMS nicht größer als 140 Byte sein. Andernfalls muss sie aufgeteilt werden. Weitere Informationen zur Anzahl der Zeichen, die in eine SMS passen, finden Sie im Abschnitt SMS-Textkodierung.

Jeder Teil einer langen Nachricht ist eine individuelle SMS. Diese Teile bewegen sich unabhängig voneinander durch das Netzwerk und werden vom empfangenden Mobiltelefon zusammengesetzt. Um zusätzliche Zustellversuche und Verbindungsprobleme zu verarbeiten, sendet Adobe Campaign diese Teile in umgekehrter Reihenfolge und fordert nur einen SR für den ersten Teil der Nachricht an, der zuletzt gesendet wurde. Da das Mobiltelefon eine Nachricht nur anzeigt, wenn der erste Teil empfangen wurde, führen zusätzliche Zustellversuche für weitere Teile nicht zu Duplikaten auf dem Mobiltelefon.

Die maximale Anzahl an SMS pro Nachricht kann pro Versand mithilfe der Einstellung Maximale Anzahl an SMS pro Nachricht in der Versandvorlage eingestellt werden. Nachrichten, die diesen Grenzwert überschreiten, schlagen beim Versand mit der Fehlermeldung "SMS zu lang" fehl.

Es gibt zwei Möglichkeiten, lange SMS zu senden:

Weitere Informationen zum Protokoll und den Formaten finden Sie in der Beschreibung der Felder esm_class, short_message und message_payload der SUBMIT_SM PDU.

Durchsatzbegrenzung und Fenster throughput-capping

Die meisten Provider verlangen eine Durchsatzbegrenzung für jede SMPP-Verbindung. Dies kann durch die Festlegung einer Anzahl von SMS im externen Konto erreicht werden. Beachten Sie, dass die Durchsatzdrosselung pro Verbindung erfolgt. Der gesamte effektive Durchsatz ist die Grenze pro Verbindung multipliziert mit der Anzahl Verbindungen insgesamt. Dies wird im Abschnitt Simultane Verbindungen beschrieben.

Um den maximal möglichen Durchsatz zu erreichen, müssen Sie eine Feinabstimmung des maximalen Übertragungsfensters vornehmen. Das Übertragungsfenster ist die Anzahl der SUBMIT_SM PDUs, die gesendet werden können, ohne auf eine SUBMIT_SM_RESP zu warten. Weitere Informationen finden Sie im Abschnitt zum Übertragungsfenster.

SR und Umgang mit Fehlern ("Anhang B") sr-error-management

Das SMPP-Protokoll definiert standardmäßige synchrone Fehler in RESP PDUs, definiert jedoch keine Fehler-Codes für SRs. Jeder Provider verwendet eigene Fehler-Codes mit der entsprechenden Bedeutung.

Eine Empfehlung finden Sie im Anhang B der SMPP-Protokollspezifikation (Seite 167), wobei die eigentlichen Fehler-Codes und deren Bedeutung nicht aufgeführt werden.

Zur Anpassung an den Umgang mit Fehlern wurde das Broadlog-Meldungssystem von Adobe Campaign genutzt, um Fehler und deren Schweregrad (hart, weich usw.) ordnungsgemäß bereitzustellen.

Wie bereits erwähnt, gibt es zwei Arten von Fehlern:

Wenn ein SR empfangen wird, befinden sich Status und Fehler in seinem short_message-Feld (Beispiel für Implementierungen, die mit Anhang B übereinstimmen). Das Feld short_message der PDU wird häufig als Textfeld bezeichnet, da es den Text im MT enthält. Bei einem SR enthält es technische Informationen sowie ein Unterfeld mit dem Namen Text. Diese beiden Felder unterscheiden sich, wobei short_message das Feld Text und andere Informationen enthält.

SR-Textfeldformat sr-text-field-format

Die Spezifikation empfiehlt die Verwendung dieses Formats für das SR-Textfeld. Es handelt sich dabei um eine Liste von Unterfeldern, die durch Leerzeichen voneinander getrennt sind, um den Feldnamen und den zugehörigen Wert zu trennen. Bei Feldnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Beispiel eines SR-Textfelds, das der Empfehlung in Anhang B entspricht:

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Das ID-Feld ist die im SUBMIT_SM_RESP PDU empfangene ID, die Bestätigung des MT.

sub und dlvrd sollen die Anzahl der gelieferten Teile und zugestellten Nachrichten zählen. Dies wird jedoch von Adobe Campaign nicht verwendet, da das Broadlog-System bessere und stärker integrierte Informationen liefert.

Die Felder submit date und done date enthalten Zeitstempel, die angeben, wann der MT gesendet wurde und wann der SR vom Mobiltelefon gesendet wurde. Hierbei sind einige Probleme mit Zeitzonen oder sogar falschen Zeitstempeln zu erwarten, die von Mobiltelefonen mit falschen Datumsangaben ausgegeben werden.

Das Feld "stat" ist wichtig, da es den Status der Nachricht angibt. Die einzigen wichtigen Status sind DELIVRD, UNDELIV und REJECTD. Der Status DELIVRD zeigt einen Erfolg an, die beiden anderen einen Fehler. Andere Werte sind möglich, aber es handelt sich in der Regel um Zwischenbenachrichtigungen, z. B. wenn der MT den Mobilnetzbetreiber erreicht, aber nicht das Mobiltelefon. Diese Zwischenbenachrichtigungen werden von Adobe Campaign ignoriert.

Das Feld "err" enthält den Provider-spezifischen Fehler-Code. Um die Interpretation der Werte zu ermöglichen, muss der Provider eine Tabelle möglicher Fehler-Codes und deren Bedeutung bereitstellen.

Schließlich enthält das Textfeld normalerweise den Anfang des Textes des MT. Dies wird von Adobe Campaign ignoriert und von einigen Providern nicht übertragen, um Lecks personenbezogener Daten und den Verbrauch von Netzwerkbandbreite zu vermeiden. Bei der Fehlersuche kann man durch das Auslesen dieses Felds den zu einem Test-MT passenden SR leichter erkennen.

Beispiel für die SR-Verarbeitung in Adobe Campaign Standard – Erweitertes allgemeines SMPP sr-processing

In diesem Beispiel werden eine Implementierung nach der Empfehlung in Anhang B, die Standardwerte im externen Konto und ein erfolgreicher SMS MT gezeigt.

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Zunächst wird Regex id extraction angewendet, um die ID zu extrahieren und mit dem entsprechenden MT abzustimmen.

Dann werden Regex status extraction und Regex error code extraction angewendet, um diese Felder zu extrahieren und an die Zeichenfolge anzuhängen.

Die Broadlog-Meldung wird mit folgenden Informationen erstellt und die ursprüngliche unveränderte Zeichenfolge wird als Referenz angehängt:

SR ExampleProvider DELIVRD 000|MESSAGE=id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

Die Nachricht wird dann normalisiert, wobei der MESSAGE-Teil entfernt wird, um mehrere Nachrichten mit demselben Status- und Fehler-Code abgleichen zu können.

SR ExampleProvider DELIVRD 000|#MESSAGE#

Wenn die Nachricht nicht bereits in der Tabelle mit den Broadlog-Meldungen bereitgestellt wurde, wird ein neuer Eintrag erstellt, der die gesamte Nachricht als firstText und die normalisierte Nachricht verwendet. Dann verwendet der Connector den Regex "success" und error, um festzustellen, ob es sich um einen Erfolg oder einen Fehler handelt:

Standardmäßig werden alle Fehler als weiche Fehler bereitgestellt. Das bedeutet, dass harte Fehler von Hand bereitgestellt werden müssen.

SMS-Textkodierung sms-text-encoding

Bei Kodierungsproblemen sollten Sie sich immer an den SMSC-Provider wenden. Nur die SMSC-Provider verfügen über genaue Kenntnisse der von ihnen unterstützten Kodierung und über spezielle Regeln, die aufgrund von Einschränkungen in ihrer technischen Plattform gelten können.

SMS-Nachrichten verwenden eine spezielle 7-Bit-Kodierung, die oft GSM7-Kodierung genannt wird.

Im SMPP-Protokoll wird der GSM7-Text auf 8 Bit pro Zeichen erweitert, um die Fehlerbehebung zu erleichtern. Das SMSC packt ihn in 7 Bit pro Zeichen, bevor er an das Mobilgerät gesendet wird. Das bedeutet, dass das Feld short_message der SMS im SMPP-Frame bis zu 160 Byte lang sein kann, während es beim Senden im Mobilfunknetz auf 140 Byte begrenzt ist.

Bei Kodierungsproblemen sollten Sie Folgendes überprüfen:

Das Feld data_coding gibt an, welche Kodierung verwendet wird. Ein Hauptproblem besteht darin, dass der Wert 0 die standardmäßige SMSC-Kodierung in der Spezifikation bedeutet, die sich normalerweise auf GSM7 bezieht. Erkundigen Sie sich beim SMSC-Partner, welche Kodierung mit data_coding = 0 verknüpft ist, die nur von Adobe Campaign unterstützt wird. Andere data_coding-Werte folgen in der Regel der Spezifikation. Sie müssen dies aber vom SMSC-Provider bestätigen lassen.

Die maximale Größe einer Nachricht hängt von ihrer Kodierung ab. In dieser Tabelle sind alle relevanten Informationen zusammengefasst:

SMPP-Parameter für externe Konten SMPP-parameters-external

Jede Implementierung des SMPP-Protokolls weist viele Variationen auf. Um die Kompatibilität und Anpassungsfähigkeit zu verbessern, stehen viele Einstellungen zur Verfügung, um das Verhalten des SMPP-Connectors zu ändern. In diesem Abschnitt werden alle Parameter und ihre Auswirkungen auf den Connector beschrieben.

Allgemeine Parameter und Routing general-parameters-routing

MTA-Instanzen für dieses Konto beschränken

Es ist möglich, die Anzahl der MTA-Instanzen festzulegen, die eine Verbindung zum SMPP-Provider herstellen dürfen. Wenn diese Option aktiviert ist, können Sie angeben, wie viele MTAs maximal verwendet werden können.

Diese Option ermöglicht eine genauere Kontrolle über die Anzahl der Verbindungen, siehe Simultane Verbindungen.

Wenn Sie einen höheren Wert als die Anzahl der ausgeführten MTAs festlegen, werden alle MTAs wie gewohnt ausgeführt: Diese Option ist nur eine Begrenzung und kann keine zusätzlichen MTAs erzeugen.

Wenn Sie die Anzahl der Verbindungen genau steuern müssen, z. B. aufgrund von Provider-Anforderungen, empfiehlt es sich, diese Option immer zu setzen, auch wenn in der aktuellen Bereitstellung die richtige Anzahl von MTAs ausgeführt wird. Wenn anschließend weitere MTAs hinzugefügt werden, wird die Verbindungsgrenze weiterhin eingehalten.

Verbindungsparameter connection-settings

SMPP-Verbindungsmodus smpp-connection-mode

Legt die Verbindung im Modus Transceiver oder im getrennten Modus Transmitter + Receiver fest. Wenn Sie zum getrennten Modus Transmitter + Receiver wechseln, gelten die Einstellungen im Abschnitt SMPP-Verbindungsmodus für den Transmitter und die Einstellungen im Abschnitt Verbindungsparameter des Receivers nur, wenn Sie das Kontrollkästchen Andere Parameter für den Receiver verwenden aktiviert haben.

Name der SMSC-Implementierung smsc-implementation-name

Legt den Namen der SMSC-Implementierung fest. Sollte auf den Namen Ihres Providers eingestellt werden. Wenden Sie sich an den Administrator oder das Zustellbarkeitsteam, um zu erfahren, was in diesem Feld hinzugefügt werden muss. Die Rolle dieses Felds wird im Abschnitt Umgang mit SR-Fehlern beschrieben.

Server server

Der DNS-Name oder die IP-Adresse des Servers, mit dem eine Verbindung hergestellt werden soll.

Port port

Der TCP-Port, zu dem eine Verbindung hergestellt werden soll.

Konto account

Die Anmeldedaten der Verbindung. Im Feld system_id der BIND PDU übergeben.

Passwort password

Passwort der SMPP-Verbindung. Im Passwortfeld der BIND PDU übergeben.

Systemtyp system-type

Wert, der im Feld system_id der BIND PDU übergeben wird. Einige Provider benötigen hier einen bestimmten Wert.

Simultane Verbindungen simultaneous-connections

In Adobe Campaign Standard wird die Anzahl der Verbindungen pro SMS-Thread und MTA-Prozess definiert.
Die Anzahl der MTA-Prozesse wird durch die Bereitstellung bestimmt: in der Regel gibt es 2 MTAs und 1 Thread. Die Anzahl der Threads kann in der Datei config-instance.xml mithilfe der Einstellung smppConnectorThreads geändert werden. Normalerweise gibt es 1 MTA-Prozess pro Container und 1 Thread pro MTA-Prozess.

Formel für die Gesamtanzahl der Verbindungen für Adobe Campaign Standard:

Simultane Verbindungen werden im externen Konto festgelegt, die Anzahl der Threads wird in der Datei config-instance.xml (smppConnectorThreads) festgelegt und die Anzahl der MTAs kann im externen Konto begrenzt werden.

Im getrennten Modus Transmitter/Receiver entspricht die oben angegebene Anzahl der Verbindungen der Anzahl der Sender/Empfänger-Paare, was bedeutet, dass es insgesamt die doppelte Anzahl von Verbindungen geben wird.

TLS über SMPP aktivieren enable-TLS

Verwenden Sie TLS, um eine Verbindung zum Provider herzustellen. Die Verbindung wird verschlüsselt. Die TLS-Verbindung wird von der OpenSSL-Bibliothek verwaltet. Alles, was für OpenSSL gilt, gilt auch für diese Verbindung.

Ausführliche SMPP-Verfolgung in Logdatei aktivieren enable-verbose-log-file

Mit dieser Einstellung wird der gesamte SMPP-Traffic in Logdateien abgelegt. Parameter müssen häufig während der ersten Einrichtung angepasst werden. Dies muss aktiviert werden, um Fehler beim Connector zu beheben und mit dem Traffic auf der Provider-Seite zu vergleichen.

Verbindungsparameter des Receivers receiver-connection

Dieser Abschnitt ist nur im getrennten Modus Transmitter + Receiver sichtbar.

Andere Parameter für den Receiver verwenden receiver-parameters

Wenn das Kontrollkästchen deaktiviert ist, werden für Sender und Empfänger dieselben Einstellungen verwendet.

Wenn das Kontrollkästchen aktiviert ist, gelten die Einstellungen im Abschnitt Verbindungsparameter für den Sender und die Verbindungsparameter des Receivers gelten für den Empfänger.

Receiver-Server, Port, Konto, Passwort, Systemtyp

Diese Einstellungen gelten für den Empfänger im Modus Transmitter + Receiver. Sie funktionieren wie im Transmitter-Modus. Weitere Informationen finden Sie weiter oben.

Parameter des SMPP-Kanals smpp-channel-settings

Transliteration der Zeichen zulassen allow-character-transliteration

Bei der Transliteration werden äquivalente Zeichen zu fehlenden Zeichen gefunden. Beispielsweise fehlt das französische Zeichen "ê" (e mit Zirkumflex-Akzent) in der GSM-Kodierung, es kann jedoch durch "e" ersetzt werden, ohne die Lesbarkeit zu beeinträchtigen.

Wenn dieses Kontrollkästchen deaktiviert ist, schlägt die Textkodierung fehl, wenn die Zeichenfolge nicht exakt kodiert werden kann.

Wenn dieses Kontrollkästchen aktiviert ist, versucht die Textkodierung, die Zeichenfolge in eine ungefähre Version zu konvertieren, anstatt fehlzuschlagen. Wenn einige Zeichen in der Zielkodierung keine Entsprechung haben, schlägt die Textkodierung fehl.

Eine allgemeinere Erläuterung des Kodierungsprozesses finden Sie unter dem Parameter Definieren eines bestimmten Kodierungs-Mapping.

Eingehende MO in Datenbank speichern incoming-mo-storing

Bei Aktivierung wird der eingehende MO in der inSMS-Tabelle der Datenbank gespeichert. Diese Tabelle kann mithilfe der Abfrageaktivität eines beliebigen Workflows abgefragt werden.

Echtzeit-KPI-Aktualisierungen während SR-Verarbeitung aktivieren real-time-kpi

Wenn diese Option aktiviert ist, werden die KPIs in Echtzeit auf der Hauptseite für den Versand aktualisiert, wenn ein Fehler-SR empfangen wird.

Der Nachteil kann eine niedrige Performance aufgrund der dadurch erzeugten Datenbankinhalte sein. Wenn diese Option deaktiviert ist, werden Statistiken vom syncfromexec-Workflow aktualisiert, der alle 20 Minuten ausgeführt wird.

Anrufernummer source-number

Definiert die Standardquelladresse für Nachrichten. Diese Einstellung gilt nur, wenn die Anrufernummer im Versand leer gelassen wurde.

Standardmäßig wird das Feld für die Anrufernummer nicht übergeben, sodass der Provider es durch die Kurzwahlnummer ersetzt.

Damit wird die Funktion zum Überschreiben der Absenderadresse/oADC aktiviert.

Kurzwahlnummer short-code

Gibt die Hauptkurzwahlnummer des Kontos an. Wenn für dieses Konto mehrere Kurzwahlnummern verwendet werden oder wenn die Kurzwahlnummer unbekannt ist, lassen Sie dieses Feld leer.

Die Angabe von Kurzwahlnummern ist für zwei Funktionen hilfreich:

Anrufer-TON/-NPI, Empfänger-TON/-NPI ton-npi

TON (Type of Number = Nummerntyp) und NPI (Numbering Plan Indicator = Nummerierungsplanindikator) werden in Abschnitt 5.2.5 der Spezifikation von SMPP Version 3.4 (Seite 117) beschrieben. Diese Werte sollten entsprechend den Anforderungen des Providers eingestellt werden.

Sie werden unverändert in den Feldern source_addr_ton, source_addr_npi, dest_addr_ton und dest_addr_npi der SUBMIT_SM PDU übertragen.

Diensttyp service-type

Dieses Feld wird unverändert im Feld service_type der SUBMIT_SM PDU übertragen. Stellen Sie den Wert entsprechend den Anforderungen des Providers ein.

Durchsatz und Zeitüberschreitung throughput-timeouts

Diese Einstellungen steuern alle Zeitaspekte des SMPP-Kanals. Einige Provider erfordern eine sehr genaue Steuerung der Nachrichtenrate sowie der Fenster- und Wiederholungszeiten. Diese Einstellungen sollten auf Werte gesetzt werden, die der Kapazität des Providers und den in seinem Vertrag angegebenen Bedingungen entsprechen.

Übertragungsfenster sending-window

Das Fenster entspricht der Anzahl der SUBMIT_SM PDUs, die gesendet werden können, ohne auf eine passende SUBMIT_SM_RESP zu warten.

Beispiel einer Übertragung mit einem maximalen Fenster von 4:

Das Fenster hilft, den Durchsatz zu erhöhen, wenn die Netzwerkverbindung eine hohe Latenz aufweist. Der Wert des Fensters muss mindestens der Anzahl der SMS entsprechen, multipliziert mit der Latenz des Links in Sekunden, damit der Connector nie auf ein SUBMIT_SM_RESP wartet, bevor die nächste Nachricht gesendet wird.
Wenn das Fenster zu groß ist, kann es passieren, dass Sie bei Verbindungsproblemen mehr doppelte Nachrichten senden. Außerdem haben die meisten Provider ein sehr strenges Limit für das Fenster und lehnen Nachrichten ab, die das Limit überschreiten.

Berechnung der optimalen Formel für das Übertragungsfenster:

Beispiel: Wenn Sie für den maximalen Durchsatz an MT 300 SMS/s eingestellt haben und die Latenz zwischen SUBMIT_SM und SUBMIT_SM_RESP im Durchschnitt 100 ms beträgt, wäre der optimale Wert 300×0.1 = 30.

Maximaler Durchsatz an MT max-mt-throughput

Maximale Anzahl an MT pro Sekunde und pro Verbindung. Diese Einstellung wird genau eingehalten. Der MTA wird beim Nachrichtenversand diese Grenze nie überschreiten. Diese Einstellung ist nützlich für Provider, die eine genaue Drosselung benötigen.

Um die Gesamtdurchsatzgrenze zu ermitteln, multiplizieren Sie diese Gesamtanzahl von Verbindungen, wie in der obigen Formel angegeben.

0 bedeutet keine Begrenzung, der MTA sendet MT so schnell wie möglich.

Im Allgemeinen wird empfohlen, diese Einstellung unter 1.000 zu halten, da es unmöglich ist, einen genauen Durchsatz oberhalb dieser Zahl zu garantieren, es sei denn, es wurde mit der endgültigen Architektur ordnungsgemäß ein Benchmark durchgeführt. Wenn Sie einen Durchsatz von über 1.000 benötigen, kontaktieren Sie Ihren Provider. Möglicherweise ist es besser, die Anzahl der Verbindungen auf über 1.000 MT/s zu erhöhen.

Dauer bis zu einer erneuten Verbindung time-reconnection

Wenn die TCP-Verbindung verloren geht, wartet der Connector diese Anzahl von Sekunden, bevor er versucht, eine Verbindung herzustellen.

Gültigkeitsdauer der MT expiration-period

Zeitüberschreitung zwischen SUBMIT_SM und der zugehörigen SUBMIT_SM_RESP. Wenn die RESP nicht rechtzeitig empfangen wird, gilt die Nachricht als fehlgeschlagen und die globale Wiederholungsrichtlinie des MTA wird angewendet.

Bind-Timeout bind-timeout

Zeitüberschreitung zwischen dem TCP-Verbindungsversuch und der BIND_*_RESP-Antwort. Nach Ablauf des Zeitlimits wird die Verbindung durch den Adobe Campaign-Connector geschlossen. Erst nach Ablauf der Dauer bis zu einer erneuten Verbindung wird versucht, die Verbindung wiederherzustellen.

enquire_link-Zeitraum enquire-link-period

enquire_link ist eine spezielle Art von PDU, die gesendet wird, um die Verbindung aktiv zu halten. Dieser Zeitraum wird in Sekunden angegeben. Der Connector sendet nur enquire_link, wenn die Verbindung inaktiv ist, um Bandbreite zu sparen. Wenn nach der doppelten Zeitdauer keine RESP empfangen wird, wird die Verbindung als unterbrochen betrachtet und ein Wiederverbindungsprozess ausgelöst.

SMSC-Besonderheiten SMSC-specifics

Bei diesen Einstellungen handelt es sich um erweiterte Einstellungen, mit denen der Adobe Campaign-Connector an die meisten SMPP-Implementierungseigenschaften angepasst wird.

Definieren eines bestimmten Kodierungs-Mappings encoding-specific-mapping

Einzelheiten zur Textkodierung finden Sie im Abschnitt SMS-Textkodierung.

Mit dieser Einstellung können Sie ein benutzerdefiniertes Kodierungs-Mapping definieren, das von der Spezifikation abweicht. Sie können eine Liste von Kodierungen zusammen mit ihrem data_coding-Wert deklarieren.

Der MTA versucht, die Kodierung mit der ersten Kodierung in der Liste durchzuführen. Schlägt dies fehl, wird versucht, die nächste Kodierung in der Liste zu verwenden, usw. Wenn keine Kodierung zum Verschlüsseln der Nachricht verwendet werden kann, tritt ein Fehler auf. Sobald die Kodierung gefunden wurde, erstellt der MTA die SUBMIT_SM PDU mit dem kodierten Text und dem data_coding-Feld mit dem in der Tabelle angegebenen Wert.

Die Reihenfolge der Elemente in der Tabelle ist wichtig: Kodierungen werden von oben nach unten ausprobiert. Sie sollten die günstigste oder am meisten empfohlene Kodierung ganz oben auf die Liste setzen, gefolgt von immer teureren Kodierungen.

Bitte beachten Sie, dass UCS-2 niemals fehlschlagen wird, da es alle in Adobe Campaign unterstützten Zeichen kodieren kann und die maximale Länge einer UCS-2-SMS viel kleiner ist: nur 70 Zeichen.

Sie können diese Einstellung auch verwenden, um zu erzwingen, dass eine bestimmte Kodierung immer verwendet wird, indem Sie in der Mapping-Tabelle nur eine Zeile deklarieren.

Das standardmäßige Mapping, das verwendet wird, wenn das Kontrollkästchen nicht aktiviert ist, entspricht der folgenden Tabelle:

Dies bedeutet, dass der MTA versucht, die Nachricht in GSM zu kodieren. Wenn dies gelingt, wird die Nachricht mit data_coding = 0 gesendet.

Wenn die Nachricht nicht in GSM kodiert werden kann, wird sie in UCS-2 kodiert und data_coding auf 8 gesetzt.

message_payload aktivieren enable-message-payload

Wenn diese Option deaktiviert ist, werden lange SMS vom MTA aufgeteilt und in mehreren SUBMIT_SM PDUs mit UDH gesendet. Die Nachricht wird vom Mobiltelefon entsprechend den UDH-Daten neu zusammengesetzt.

Wenn diese Option aktiviert ist, werden lange SMS in einer einzigen SUBMIT_SM PDU gesendet, wobei der Text in das optionale Feld message_payload eingefügt wird. Weitere Informationen dazu finden Sie in der SMPP-Spezifikation.

Wenn diese Funktion aktiviert ist, kann Adobe Campaign die SMS-Teile nicht einzeln zählen: alle Nachrichten werden als in einem Teil gesendet gezählt.

Vollständige Telefonnummer senden send-full-phone-number

Wenn dieses Kontrollkästchen nicht aktiviert ist, werden nur Ziffern der Telefonnummer an den Provider gesendet (destination_addr-Feld des SUBMIT_SM-Felds). Dies ist das Standardverhalten, da das internationale Rufnummernkennzeichen, normalerweise ein "+"-Präfix, in SMPP durch TON- und NPI-Felder ersetzt wird.

Wenn das Kontrollkästchen aktiviert ist, wird die Telefonnummer unverändert gesendet, also ohne Vorverarbeitung und potenzielle Leerzeichen, "+"-Präfix oder Pfund-/Hash-/Sternzeichen.

Diese Funktion wirkt sich auch auf das Verhalten der Blockierungslistenfunktion für automatische Antworten aus: Wenn das Kontrollkästchen nicht aktiviert ist, wird den in die Quarantänetabelle eingefügten Telefonnummern ein "+"-Präfix hinzugefügt, um das "+"-Präfix zu kompensieren, das vom SMPP-Protokoll selbst aus der Telefonnummer entfernt wird.

TLS-Zertifikatsprüfung überspringen skip-tls

Wenn TLS aktiviert ist, werden alle Zertifikatsprüfungen übersprungen.

Wenn diese Option aktiviert ist, ist die Verbindung nicht mehr sicher. Sie sollte nicht in der Produktion aktiviert werden.

Dies kann für Debugging- oder Testzwecke nützlich sein.

Bind TON/NPI bind-ton-npi

TON (Type of Number = Nummerntyp) und NPI (Numbering Plan Indicator = Nummerierungsplanindikator) werden in Abschnitt 5.2.5 der Spezifikation von SMPP Version 3.4 (Seite 117) beschrieben. Diese Werte sollten entsprechend den Anforderungen des Providers eingestellt werden.

Sie werden unverändert in den Feldern addr_ton und addr_npi der BIND PDU übertragen.

Adressenbereich address-range

Wird im Feld address_range der BIND PDU unverändert gesendet. Dieser Wert sollte entsprechend den Anforderungen des Providers eingestellt werden.

Anzahl ungültiger ID-Quittierungen invalid-id

Begrenzt die Anzahl der ungültigen Nachrichten-IDs DELIVER_SM_RESP, die für einen einzelnen SR gesendet werden können.

Dies sollte nur zur Fehlerbehebung als Problemumgehung verwendet und unter normalen Bedingungen auf 0 gesetzt werden.

Beispiel: die Einstellung lautet 2:

Wenn dieses Feld auf 0 gesetzt wird, wird der Mechanismus deaktiviert, bei dem Nachrichten-ID ungültig immer zurückgegeben wird. Dies ist das normale Verhalten.

Wenn Sie dieses Feld auf 1 setzen, antwortet der Connector immer mit "OK", auch wenn die ID ungültig ist. Es sollte nur unter Aufsicht, zur Fehlerbehebung und für eine minimale Zeitdauer, z. B. zur Behebung eines Problems auf Provider-Seite, auf 1 gesetzt werden.

Regex zur ID-Extraktion im SR regex-extraction

Das SR-Format wird von der SMPP-Protokollspezifikation nicht strikt durchgesetzt. Es handelt sich lediglich um eine Empfehlung, die in Anhang B (Seite 167) der Spezifikation beschrieben ist. Einige SMPP-Implementierer formatieren dieses Feld unterschiedlich, sodass Adobe Campaign eine Möglichkeit benötigt, das richtige Feld zu extrahieren.

Standardmäßig werden bis zu 10 alphanumerische Zeichen nach id: erfasst.

Der Regex muss über genau eine Erfassungsgruppe mit einem Teil in Klammern verfügen. Der ID-Teil muss in Klammern eingeschlossen sein. Das Regex-Format ist PCRE.

Achten Sie beim Anpassen dieser Einstellung darauf, so viel Kontext wie möglich einzubeziehen, um Fehlauslösungen zu vermeiden. Wenn bestimmte Präfixe vorhanden sind, z. B. id: im standardisierten Präfix, müssen Sie sie in den Regex aufnehmen. Verwenden Sie außerdem so weit wie möglich Worttrennzeichen (\b), um zu vermeiden, dass Text in der Mitte eines Wortes erfasst wird.

Wenn nicht genügend Kontext in den Regex aufgenommen wird, kann dies zu einer kleinen Sicherheitslücke führen: Der tatsächliche Inhalt der Nachricht kann in den SR aufgenommen werden. Wenn Sie nur ein bestimmtes ID-Format ohne Kontext verwenden, z. B. eine UUID, wird möglicherweise der eigentliche Textinhalt analysiert, z. B. eine UUID, die in das Textfeld eingebettet ist, anstatt der ID.

Regex angewendet, um den Erfolgs-/Fehlerstatus zu ermitteln regex-applied

Wenn Meldungen mit einer unbekannten stat/err-Feldkombination auftreten, werden diese Regex auf das stat-Feld angewendet, um zu bestimmen, ob der SR erfolgreich oder fehlerhaft war. SR mit stat-Werten, die mit keinem Regex übereinstimmen, werden ignoriert.

Standardmäßig werden stat-Werte, die mit DELIV beginnen, z. B. DELIVRD in Anhang B, als erfolgreich betrachtet und stat-Werte, die Fehler aufweisen, z. B. REJECTED, UNDELIV, werden als Fehler betrachtet.

ID-Format in der MT-Quittierung (resp) id-format-mt

Dies zeigt das Format der ID an, die im Feld message_id der SUBMIT_SM_RESP PDU zurückgegeben wird.

ID-Format im SR id-format-sr

Dies gibt das Format der ID an, die vom Extraction-Regex der ID im SR erfasst wird. Die Werte haben die gleiche Bedeutung und das gleiche Verhalten wie das Format im MT oben.

SR-Kennung oder Fehler-Code in einem optionalen Feld speichern

Wenn diese Option aktiviert ist, wird der Inhalt der optionalen Felder an den Text angehängt, der durch die oben genannten Regex verarbeitet wird. Der Text hat das Format 0xTAG:VALUE, wobei 0xTAG der 4-stellige Hexadezimalwert des Tags in Großbuchstaben ist, z. B. 0x002E.

Sie können beispielsweise die ID im Feld receipted_message_id erfassen. Aktivieren Sie dazu dieses Kontrollkästchen, und dem Status wird folgender Text hinzugefügt:

0x001E:05e3299e-8d37-49d0-97c6-8e4fe60c7739

In diesem Beispiel ist 0x001E das Tag des optionalen Felds und die UUID der Wert des Felds.

Um diesen Wert zu erfassen, können Sie jetzt den folgenden Regex im Feld "Regex zur ID-Extraktion im SR" festlegen:

\b0x001E:([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b

SR-Kennung oder Fehler-Code in einem Textfeld speichern

Wenn diese Option aktiviert ist, wird das Feld Text während der Verarbeitung des Statustextes des SR beibehalten.

Dies ist nützlich, wenn der Provider wichtige Daten wie die ID oder den Status in dieses Feld eingibt. Normalerweise kann dieses Feld sicher verworfen werden, da es Text mit einer Nicht-ASCII-Kodierung enthalten und die Regex-Verarbeitung stören kann.

Das Aktivieren dieser Option kann zu einer sehr kleinen Sicherheitslücke führen, wenn der Extraction-Regex der ID im SR-Feld nicht spezifisch genug ist. Der Inhalt des Felds Text kann als ID geparst werden, und ein Angreifer kann es verwenden, um gefälschte IDs einzuschleusen, was zu einer teilweisen Dienstverweigerung führen kann.

Dienst-ID-Tag

Ermöglicht das Hinzufügen eines benutzerdefinierten TLV. Dieses Feld legt den Tag-Teil fest. Der Wert kann pro Versand im Wert Dienst- oder Programm-ID in den erweiterten Parametern des Versands angepasst werden.

Diese Einstellung erlaubt nur das Hinzufügen einer TLV-Option pro Nachricht.

Automatische Antwort auf MO automatic-reply

Mit dieser Funktion können Sie schnell einen Antworttext an ein MO senden und das Senden pro Kurzwahlnummer an die Blockierungsliste handhaben.

Die Spalten Schlüsselwort und Kurzwahlnummer definieren Bedingungen, um die automatische Antwort auszulösen. Wenn beide Felder übereinstimmen, wird der MO gesendet und die zusätzliche Aktion ausgelöst. Um einen Platzhalter festzulegen, sollten Sie das Feld leer lassen. Das Schlüsselwort wird mit dem ersten alphanumerischen Wort im MO-Text abgeglichen, wobei Interpunktion und führende Leerzeichen ignoriert werden. Das bedeutet, dass das Feld Schlüsselwort keine Leerzeichen enthalten darf und ein einzelnes Wort sein muss.

Die Einstellung Schlüsselwort ist ein Präfix. Wenn Sie beispielsweise "AD" angeben, entspricht dies "AD", "ADAPT" und "ADOBE". Wenn Sie mehrere Schlüsselwörter mit einem gemeinsamen Präfix haben, müssen Sie auf die Reihenfolge achten, da Schlüsselwörter von oben nach unten verarbeitet werden.

Die Spalte Antwort enthält den Antworttext. In diesem Bereich ist keine Personalisierung möglich. Wenn Sie dieses Feld leer lassen, wird keine Nachricht als Antwort gesendet, aber die zusätzliche Aktion wird trotzdem ausgelöst.

Die Spalte Zusätzliche Aktion enthält eine zusätzliche Aktion, wenn sowohl Schlüsselwort als auch Kurzwahlnummer übereinstimmen. Eine leere Kurzwahlnummer stimmt mit allen Kurzwahlnummern überein. Sie können unter Quarantäne stellen oder aus der Quarantäne holen. Mit dem Wert "Keine" wird auf den Text geantwortet. Wenn Sie eine Zusätzliche Aktion angeben, aber das Feld Antwort leer lassen, wird die Aktion ausgeführt, aber es wird keine Antwort gesendet. Quarantäne wird nur für die angegebene Kurzwahlnummer oder alle Kurzwahlnummern angewendet, wenn das Feld leer gelassen wird.

Alle Einträge in der Tabelle werden in der angegebenen Reihenfolge verarbeitet, bis eine Regel übereinstimmt. Wenn mehrere Regeln mit einem MO übereinstimmen, wird nur die oberste Regel angewendet.

Optionale Parameter für die automatische Antwort (TLV) automatic-reply-tlv

Ab Version 21.1 können Sie dem automatischen Antwort-MT optionale Parameter hinzufügen. Sie werden als optionale TLV-Parameter zur SUBMIT_SM PDU der Antwort hinzugefügt, wie in Abschnitt 5.3 der SMPP-Spezifikation(Seite 131) beschrieben.

Weitere Informationen zu optionalen Parametern finden Sie in diesem Abschnitt.

SMS-Versandvorlagenparameter sms-delivery-template-parameters

Einige Parameter können pro Versandvorlage festlegt werden.

Feld "Von" from-field

Dieses Feld ist optional. Es ermöglicht das Überschreiben der Absenderadresse (oADC). Der Inhalt dieses Felds wird im Feld source_addr der SUBMIT_SM PDU eingefügt.

Das Feld ist durch die SMPP-Spezifikation auf 21 Zeichen begrenzt, einige Provider können jedoch längere Werte zulassen. Beachten Sie auch, dass in einigen Ländern sehr strenge Einschränkungen gelten können, z. B. für Länge, Inhalt, zulässige Zeichen.

Versandparameter delivery-parameters

Maximale Anzahl an SMS pro Nachricht maximum-sms

Diese Einstellung funktioniert nur, wenn die Einstellung Nachrichten-Payload deaktiviert ist. Weiterführende Informationen dazu finden Sie auf dieser Seite. Wenn die Nachricht mehr SMS als diesen Wert erfordert, wird ein Fehler ausgelöst.

Das SMS-Protokoll begrenzt SMS auf 255 Teile. Allerdings haben einige Mobiltelefone Probleme, lange Nachrichten mit mehr als zehn Teilen zusammenzustellen. Die Begrenzung hängt vom genauen Modell ab. Wir empfehlen Ihnen, nicht mehr als fünf Teile pro Nachricht zu verwenden.

Aufgrund der Funktionsweise personalisierter Nachrichten in Adobe Campaign kann die Größe der Nachrichten variieren. Eine große Anzahl langer Nachrichten könnte die Versandkosten erhöhen.

Übermittlungsmodus transmission-mode

Dieses Feld gibt die Art der SMS an, die Sie übertragen möchten: Normale oder Flash-Nachrichten, die auf dem Mobilgerät oder der SIM-Karte gespeichert werden.

Diese Einstellung wird im optionalen Feld dest_addr_subunit in der SUBMIT_SM PDU übertragen.

Gültigkeitszeitraum validity-period

Der Gültigkeitszeitraum wird im Feld validity_period der SUBMIT_SM PDU übertragen. Das Datum wird immer im absoluten UTC-Zeitformat formatiert (das Datumsfeld endet mit "00+").

Optionale SMPP-Parameter (TLV) smpp-optional-parameters

Ab Version 21.1 können Sie jedem für diesen Versand gesendeten MT mehrere optionale Parameter hinzufügen. Diese optionalen Parameter werden zur SUBMIT_SM PDU der Antwort hinzugefügt, wie in Abschnitt 5.3 der SMPP-Spezifikation (Seite 131) beschrieben.

Jede Tabellenzeile stellt einen optionalen Parameter dar:

Wenn die Tag-ID eines optionalen Parameters und die im externen Konto definierte Dienst-Tag-ID identisch sind, hat der in dieser Tabelle definierte Wert Vorrang.

SMPP-Connector ACS-SMPP-connector

Die Pfeile stellen den Datenfluss dar.

Beachten Sie, dass es mehrere SMPP-Connector-Threads gibt. Diese Threads sind alle identisch und verwenden dieselbe Konfiguration. Deshalb wird die Anzahl der Verbindungen immer mit der Anzahl der Threads multipliziert.

Die Anzahl der Threads kann vom Kunden nicht geändert werden, da Konfigurationsdateien geändert werden müssen.

Beschreibung des Verhaltens des SMPP-Connectors behavior-smpp-connector

Abgleichen von MT-, SR- und broadLog-Einträgen matching-mt-sr

In Adobe Campaign ist eine Nachricht ein Broadlog-Eintrag. In Adobe Campaign Standard müssen externe Connectoren nur die funktionierende Broadlog-Arbeitstabelle kennen: nmsBroadLogExec. Ein Workflow ist dafür zuständig, Broadlog-Einträge wieder in ihre jeweiligen Zielgruppendimensionen zurückzukopieren (nmsBroadLogXXX).

Leider erlaubt SMPP nicht, eine ID zusammen mit einer Nachricht zu senden: Der Provider versieht jeden MT mit einer MT-ID und stellt dann einen oder mehrere SR mit derselben ID zur Verfügung.

Die vom Provider angegebene ID wird in der Spalte sProviderId der Tabelle nmsBroadLogExec gespeichert. SR treffen immer ein, nachdem der MT erfolgreich gesendet und quittiert wurde, können aber manchmal außer der Reihe eintreffen, was in Adobe Campaign als ausstehende SR bezeichnet wird. Der Verarbeitungs-Thread speichert diese SR vorübergehend im RAM, bis die vollständigen Informationen eingehen.

Wenn ein MT quittiert wird (SUBMIT_SM_RESP), wird sProviderId sofort in der Datenbank aktualisiert.

Jeder SR wird einzeln von SMPP-Verarbeitungs-Threads verarbeitet. Dieser Prozess ist pseudosynchron: Er wird von außen als synchron angesehen, intern aber ereignisgesteuert implementiert. SR werden nur quittiert, wenn das Broadlog erfolgreich aktualisiert wurde. Bei einem Fehler wird der SR zurückgewiesen.

Im Folgenden finden Sie den Prozess, der auf die einzelnen SR angewendet wird:

Zum Überprüfen der obigen Schritte ist es erforderlich, die ausführliche SMPP-Verfolgung zu aktivieren, um manuell zu überprüfen, ob alle Schritte korrekt angewendet werden. Dies ist jedes Mal erforderlich, wenn Adobe Campaign mit einem neuen SMPP-Provider verbunden wird.

Vor der Live-Schaltung checklist

Diese Checkliste enthält eine Liste der Dinge, die Sie vor der Live-Schaltung überprüfen sollten. Eine unvollständige Einrichtung kann zu vielen Problemen führen.

Prüfen auf Konflikte mit externen Konten external-account-conflict

Vergewissern Sie sich, dass Sie keine alten externen SMS-Konten haben. Wenn Sie das Testkonto deaktiviert lassen, besteht das Risiko, dass es auf dem Produktionssystem wieder aktiviert wird und potenzielle Konflikte entstehen.

Vergewissern Sie sich, dass keine andere Instanz eine Verbindung zu diesem Konto herstellt. Achten Sie insbesondere darauf, dass die Staging-Umgebung keine Verbindung zum Konto herstellt. Einige Provider unterstützen dies, aber es erfordert eine sehr spezifische Konfiguration sowohl auf der Seite von Adobe Campaign als auch auf der Plattform des Providers.

Wenn Sie mehrere Konten in derselben Adobe Campaign-Instanz haben müssen, die eine Verbindung zu demselben Provider herstellen, wenden Sie sich an den Provider, um sicherzustellen, dass tatsächlich zwischen den Verbindungen dieser Konten unterschieden wird. Für mehrere Konten mit denselben Anmeldedaten ist eine zusätzliche Konfiguration erforderlich.

Aktivieren der ausführlichen SMPP-Verfolgung während der Prüfungen enable-verbose

Sie sollten während der Prüfungen immer die ausführliche SMPP-Verfolgung aktivieren.
Auch wenn Sie die Logs nicht selbst überprüfen können, kann der Support Ihnen leichter helfen.

Testen Ihrer SMS test

Überprüfen der PDUs check-pdus

Auch wenn die Nachrichten erfolgreich aussehen, ist es wichtig, zu prüfen, ob die PDUs richtig formatiert sind.

Dieser Schritt ist erforderlich, wenn eine Verbindung zu einem Provider hergestellt wird, der zuvor nicht mit Adobe Campaign verbunden war.

BIND bind

Vergewissern Sie sich, dass die BIND_* PDUs korrekt gesendet wurden. Am wichtigsten ist es zu prüfen, dass der Provider immer erfolgreiche BIND_*_RESP PDUs zurückgibt (command_status = 0).

Vergewissern Sie sich, dass nicht zu viele BIND_* PDUs vorhanden sind. Wenn es zu viele sind, kann das darauf hinweisen, dass die Verbindung instabil ist. Weitere Informationen finden Sie im Abschnitt Probleme mit instabilen Verbindungen.

ENQUIRE_LINK enquire-link-pdus

Vergewissern Sie sich, dass ENQUIRE_LINK PDUs regelmäßig ausgetauscht werden, wenn die Verbindung inaktiv ist.

SUBMIT_SM / DELIVER_SM submit-sm-deliver-sm

Senden Sie eine Nachricht und suchen Sie dann in den Logs nach den zugehörigen SUBMIT_SM, SUBMIT_SM_RESP, DELIVER_SM und DELIVER_SM_RESP PDUs.

Mit der SUBMIT_SM PDU:

Mit der SUBMIT_SM_RESP PDU:

Mit der DELIVER_SM PDU:

Mit der DELIVER_SM_RESP PDU:

Nachfragen beim Provider, ob alles in Ordnung ist provider

Auch wenn Ihre SMS erfolgreich ist, sollten Sie beim Provider nachfragen, ob alles in Ordnung ist.

Deaktivieren der ausführlichen SMPP-Verfolgung disable-verbose

Sobald alle Überprüfungen abgeschlossen sind, müssen Sie die ausführliche SMPP-Verfolgung deaktivieren, um nicht zu viele Logs zu generieren. Sie können sie auch in Produktionssystemen zur Fehlerbehebung erneut aktivieren.