SMS-Ereignisdatenstream von Amazon Pinpoint - Amazon Pinpoint
Beispiel für ein SMS-EreignisSMS-Ereignisattribute

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

SMS-Ereignisdatenstream von Amazon Pinpoint

Wenn der SMS-Kanal für ein Projekt aktiviert ist, kann Amazon Pinpoint Ereignisdaten über SMS-Nachrichtenzustellungen für das Projekt streamen. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint Ihre Veranstaltungsdaten von dem Ziel ab, das Sie bei der Einrichtung angegeben haben, damit Sie sie sich ansehen können. Informationen zum Einrichten des Event-Streamings finden Sie unter. Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen

Anmerkung

Es kann bis zu 72 Stunden dauern, bis SMS-Ereignisse empfangen werden, die von Mobilfunkanbietern generiert werden. Sie sollten daher nicht verwendet werden, um festzustellen, ob es bei der Zustellung ausgehender Nachrichten zu Verzögerungen gekommen ist. Wenn Amazon Pinpoint nach 72 Stunden kein letztes Ereignis von einem Transporteur erhalten hat, gibt der Service automatisch einen UNKNOWN record_status zurück, da Amazon Pinpoint nicht weiß, was mit dieser Nachricht passiert ist.

Beispiel für ein SMS-Ereignis

Das JSON-Objekt für ein SMS-Ereignis enthält die Daten wie im folgenden Beispiel.

{
  "event_type": "_SMS.SUCCESS",
  "event_timestamp": 1553104954322,
  "arrival_timestamp": 1553104954064,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "123456789012"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
    "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
    "origination_phone_number": "+12065550142",
    "destination_phone_number": "+14255550199",
    "record_status": "DELIVERED",
    "iso_country_code": "US",
    "treatment_id": "0",
    "number_of_message_parts": "1",
    "message_id": "1111-2222-3333",
    "message_type": "Transactional",
    "campaign_id": "52dc44b35c4742c98c5935269example"
    "customer_context": "{\"userId\":\"user-id-4\"}"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}

SMS-Ereignisattribute

In diesem Abschnitt werden die Attribute definiert, die im vorherigen Beispiel für die Event-Stream-Daten enthalten sind, die Amazon Pinpoint generiert, wenn Sie SMS-Nachrichten senden.

Ereignis
Attribut Beschreibung
event_type

Der Ereignistyp. Die möglichen Werte sind:

  • _SMS.BUFFERED: Die Nachricht wird noch an den Empfänger zugestellt.

  • _SMS.SUCCESS: Die Nachricht wurde vom Mobilfunkanbieter erfolgreich angenommen/an den Empfänger zugestellt.

  • _SMS.FAILURE: Amazon Pinpoint konnte die Nachricht nicht an den Empfänger zustellen. Weitere Informationen über den Fehler, aufgrund dessen die Nachricht nicht zugestellt werden konnte, finden Sie unter attributes.record_status.

  • _SMS.OPTOUT: Der Kunde hat die Nachricht erhalten und mit dem Senden des Opt-Out-Schlüsselworts (normalerweise „STOP“) geantwortet.

event_timestamp

Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden.
arrival_timestamp

De Zeitpunkt, zu dem das Ereignis von Amazon Pinpoint empfangen wurde, angezeigt als Unix-Zeit in Millisekunden.
event_version

Die Version des Ereignis-JSON-Schemas.

Tipp

Prüfen Sie diese Version in der Anwendung, mit der Ihr Ereignis verarbeitet wird, damit Sie wissen, wann die Anwendung infolge eines Schema-Updates aktualisiert werden soll.
application

Informationen über das Amazon-Pinpoint-Projekt, das dem Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle Application (Anwendung).
client

Informationen zum App-Client, der auf dem Gerät installiert ist, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle Client.
device

Informationen über das Gerät, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle Device (Gerät).

Bei SMS-Ereignissen ist dieses Objekt leer.
session Bei SMS-Ereignissen ist dieses Objekt leer.
attributes

Attribute, die dem Ereignis zugeordnet sind. Bei Ereignissen, die von einer Ihrer Apps gemeldet werden, kann dieses Objekt benutzerdefinierte Attribute enthalten, die von der App definiert werden. Bei Ereignissen, die beim Senden einer Kampagne erstellt werden, enthält dieses Objekt Attribute, die der Kampagne zugeordnet sind. Bei Ereignissen, die generiert werden, wenn Sie Transaktionsnachrichten senden, enthält dieses Objekt Informationen, die sich auf die Nachricht selbst beziehen.

Weitere Informationen finden Sie in der Tabelle Attributes (Attribute).
metrics

Zusätzliche Metriken, die dem Ereignis zugeordnet sind. Weitere Informationen finden Sie in der Tabelle Metrics (Metriken).
awsAccountId

Die ID des AWS Kontos, das zum Senden der Nachricht verwendet wurde.

Anwendung

Enthält Informationen über das Amazon-Pinpoint-Projekt, dem das Ereignis zugeordnet ist, und gegebenenfalls das SDK, das zum Melden des Ereignisses verwendet wurde.

Attribut Beschreibung
app_id

Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat.
sdk

Das SDK, das zum Melden des Ereignisses verwendet wurde. Wenn Sie eine Transaktions-SMS-Nachricht durch einen direkten Amazon-Pinpoint-API-Aufruf oder über die Amazon-Pinpoint-Konsole senden, ist dieses Objekt leer.

Attribute

Enthält Informationen zu den Attributen, die dem Ereignis zugeordnet sind.

Attribut Beschreibung
sender_request_id

Eine eindeutige ID, die der Anforderung zum Senden der SMS-Nachricht zugeordnet ist.
campaign_activity_id Die eindeutige ID der Aktivität innerhalb der Kampagne.
origination_phone_number

Die Telefonnummer, von der die Nachricht gesendet wurde.
destination_phone_number

Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden.
record_status

Zusätzliche Informationen über den Status der Nachricht. Mögliche Werte sind:

  • SUCCESSFUL/DELIVERED: Die Nachricht wurde erfolgreich zugestellt.

  • PENDING: Die Nachricht wurde noch nicht an das Gerät des Empfängers zugestellt.

  • INVALID: Die Zieltelefonnummer ist ungültig.

  • UNREACHABLE: Das Gerät des Empfängers ist derzeit nicht erreichbar oder nicht verfügbar. Beispielsweise könnte das Gerät ausgeschaltet oder vom Netzwerk getrennt sein. Sie können versuchen, die Nachricht später erneut zu senden.

  • UNKNOWN: Es ist ein Fehler aufgetreten, der die Zustellung der Nachricht verhindert hat. Dieser Fehler ist in der Regel vorübergehend und Sie können versuchen, die Nachricht später erneut zu senden.

  • BLOCKED Das Gerät des Empfängers blockiert SMS-Nachrichten von der ursprünglichen Nummer.

  • CARRIER_UNREACHABLE: Ein Problem mit dem Mobilfunknetz des Empfängers verhinderte die Zustellung der Nachricht. Dieser Fehler ist in der Regel vorübergehend und Sie können versuchen, die Nachricht später erneut zu senden.

  • SPAM: Der Mobilfunkanbieter des Empfängers hat den Inhalt der Nachricht als Spam identifiziert und die Zustellung der Nachricht blockiert.

  • INVALID_MESSAGE: Der Text der SMS-Nachricht ist ungültig und kann nicht zugestellt werden.

  • CARRIER_BLOCKED: Der Mobilfunkanbieter des Empfängers hat die Zustellung dieser Nachricht blockiert. Dies tritt häufig auf, wenn der Anbieter den Inhalt der Nachricht als unerwünscht oder böswillig identifiziert.

  • TTL_EXPIRED: Die SMS-Nachricht konnte innerhalb eines bestimmten Zeitraums nicht zugestellt werden. Dieser Fehler ist in der Regel vorübergehend und Sie können versuchen, die Nachricht später erneut zu senden.

  • MAX_PRICE_EXCEEDED: Das Senden der Nachricht hätte zu einer Gebühr geführt, die das monatliche SMS-Ausgabenkontingent für Ihr Konto überschritten hätte. Sie können eine Erhöhung dieses Kontingents anfordern, indem Sie das Verfahren unter Anfordern von Erhöhungen Ihres monatlichen SMS-Ausgabenkontingents im Amazon-Pinpoint-Benutzerhandbuch ausführen.

  • OPTED_OUT: Die SMS-Nachricht wurde nicht gesendet, weil der Empfänger keine Nachrichten von Ihnen empfangen möchte.

  • NO_QUOTA_LEFT_ON_ACCOUNT: Auf Ihrem Konto ist nicht mehr genügend Ausgabenkontingent vorhanden, um die Nachricht zu senden. Sie können eine Erhöhung dieses Kontingents beantragen, indem Sie das Verfahren unter Beantragung einer Erhöhung Ihres monatlichen SMS-Ausgabenkontingents im SMS-Benutzerhandbuch für AWS Endbenutzer durchführen.

  • NO_ORIGINATION_IDENTITY_AVAILABLE_TO_SEND: Ihr Konto enthält keine Telefonnummer, mit der die Nachricht an das Ziel gesendet werden kann.

  • DESTINATION_COUNTRY_NOT_SUPPORTED: Das Zielland ist gesperrt. Informationen zu allen unterstützten Ländern finden Sie unter Unterstützte Länder und Regionen (SMS-Kanal) im SMS-Benutzerhandbuch für AWS Endbenutzer.

  • ACCOUNT_IN_SANDBOX: Ihr Konto befindet sich in der Sandbox und kann nur an verifizierte Zielnummern senden. Sie können die Zielnummer in der Amazon Pinpoint Pinpoint-Konsole überprüfen oder den Vorgang starten, um das Konto aus der Sandbox zu verschieben. Weitere Informationen finden Sie unter Über die SMS/MMS- und Voice-Sandbox im SMS-Benutzerhandbuch für AWS Endbenutzer-Messaging.

  • RATE_EXCEEDED: Sie haben versucht, die Nachricht zu schnell zu senden, und wurden gedrosselt. Sie müssen Ihre Anrufrate verringern. Einzelheiten zu unseren Grenzwerten finden Sie unter Grenzwerte für MPS-Nachrichten (Message Parts per Second) im SMS-Benutzerhandbuch für AWS Endbenutzer.

  • INVALID_ORIGINATION_IDENTITY: Die angegebene Ursprungsidentität ist ungültig.

  • ORIGINATION_IDENTITY_DOES_NOT_EXIST: Die angegebene Ursprungsidentität existiert nicht.

  • INVALID_DLT_PARAMETERS: Ungültige DLT-Parameter (erforderlich für Ziele in Indien) wurden angegeben.

  • INVALID_PARAMETERS: Es wurden ungültige Parameter angegeben.

  • ACCESS_DENIED: Ihr Konto ist für das Senden von Nachrichten gesperrt. Wenden Sie sich an den Kundensupport, um die Ursache herauszufinden und das Problem zu lösen.

  • INVALID_KEYWORD: Das angegebene Schlüsselwort ist ungültig. Das Schlüsselwort hat möglicherweise ein falsches Format oder ist in Ihrem Konto nicht festgelegt.

  • INVALID_SENDER_ID: Die angegebene Absender-ID ist ungültig. Die Absender-ID hat möglicherweise ein falsches Format oder eine falsche Länge.

  • INVALID_POOL_ID: Die angegebene Pool-ID ist ungültig. Die Pool-ID hat möglicherweise ein falsches Format oder gehört nicht zu Ihrem Konto.

  • SENDER_ID_NOT_SUPPORTED_FOR_DESTINATION: Das Zielland unterstützt die Sender-ID nicht. Sie müssen eine Telefonnummer oder eine andere Ursprungsidentität für das Senden verwenden.

  • INVALID_PHONE_NUMBER: Die angegebene Ursprungstelefonnummer ist ungültig. Die Telefonnummer hat möglicherweise ein falsches Format oder eine falsche Länge.
iso_country_code

Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format.
treatment_id

Die ID der Nachrichtenbehandlung, wenn die Nachricht in einer A/B-Kampagne gesendet wurde.
treatment_id

Wenn die Nachricht mit einer A/B-Testkampagne gesendet wurde, stellt dieser Wert die Behandlungsnummer der Nachricht dar. Für Transaktions-SMS-Nachrichten ist dieser Wert 0.
number_of_message_parts

Die Anzahl der Mitteilungsteile, die Amazon Pinpoint erstellt hat, um die Nachricht zu senden.

Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7-Zeichen oder 67 Nicht-GSM-Zeichen enthalten, obwohl diese Limits je nach Land variieren können. Wenn Sie eine Nachricht senden, die diese Limits überschreitet, teilt Amazon Pinpoint die Nachrichten automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden.
message_id

Die eindeutige ID, die Amazon Pinpoint generiert, wenn die Nachricht akzeptiert wird.
message_type

Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. Sie geben diesen Wert an, wenn Sie eine Kampagne erstellen oder wenn Sie Transaktionsnachrichten mithilfe des SendMessagesVorgangs in der Amazon Pinpoint Pinpoint-API versenden.
campaign_id

Die eindeutige ID der Amazon-Pinpoint-Kampagne, die die Nachricht gesendet hat.
customer_context

Eine JSON-Zeichenfolge mit dem Inhalt der Context Map, die in einem Amazon Pinpoint SendMessagesPinpoint-Vorgang gesendet wurde.

Client

Enthält Informationen zum App-Client, der auf dem Gerät installiert ist, das das Ereignis gemeldet hat.

Attribut Beschreibung
client_id

Bei Ereignissen, die von Apps generiert werden, ist dieser Wert die eindeutige ID des App-Clients, der auf dem Gerät installiert ist. Diese ID wird automatisch von der AWS Mobile SDK for iOS und der AWS Mobile SDK for Android generiert.

Bei Ereignissen, die generiert werden, wenn Sie Kampagnen und Transaktionsnachrichten senden, entspricht dieser Wert der ID des Endpunkts, an den Sie die Nachricht gesendet haben.
cognito_id Die eindeutige ID, die dem App-Client im Amazon-Cognito-Identitätspool zugewiesen ist, der von Ihrer App genutzt wird

Gerät

Enthält Informationen über das Gerät, das das Ereignis gemeldet hat.

Attribut Beschreibung
locale Der Gerätestandort
make Der Gerätehersteller, beispielsweise Apple oder Samsung
model Das Gerätemodell, z. B. iPhone
platform Die Geräteplattform, z. B. ios oder android

Metriken

Enthält Informationen zu Metriken, die dem Ereignis zugeordnet sind.

Attribut Beschreibung
price_in_millicents_usd

Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 $).

Anmerkung

Diese Eigenschaft wird nicht für Nachrichten mit dem event_type _SMS.BUFFERED angezeigt.