Beispiel für eine Kampagnenveranstaltung Kampagnen-Ereignisattribute

Datenstream zu Kampagnenereignissen von Amazon Pinpoint

Wenn Sie Amazon Pinpoint verwenden, um Kampagnen über einen Kanal zu versenden, kann Amazon Pinpoint Ereignisdaten zu diesen Kampagnen streamen. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint die Eventdaten Ihrer App für E-Mails oder SMS Nachrichten ab, die Sie aus einer Kampagne von dem Ziel senden, das Sie bei der Einrichtung angegeben haben, damit Sie sie sich ansehen können. Ausführliche Informationen zu den Daten, die Amazon Pinpoint für E-Mails und SMS Nachrichten streamt, finden Sie unter E-Mail-Ereignisdatenstream von Amazon Pinpoint undSMS-Ereignisdatenstream von Amazon Pinpoint. Informationen zum Einrichten von Event-Streaming finden Sie unter Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen .

Beispiel für eine Kampagnenveranstaltung

Das JSON Objekt für ein Kampagnenereignis enthält die im folgenden Beispiel gezeigten Daten.


{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}

Kampagnen-Ereignisattribute

In diesem Abschnitt werden die Attribute definiert, die im Ereignis-Stream der Kampagne enthalten sind.

Attribut	Beschreibung
`event_type`	Der Ereignistyp. Die möglichen Werte sind: _campaign.send: Amazon Pinpoint hat die Kampagne ausgeführt. _campaign.opened_notification: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger auf die Benachrichtigung getippt hat, um sie zu öffnen. _campaign.received_foreground: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger die Nachricht als Vordergrundbenachrichtigung erhalten hat. _campaign.received_background: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger die Nachricht als Hintergrundbenachrichtigung erhalten hat. Anmerkung _campaign.opened_notification, _campaign.received_foreground und _campaign.received_background werden nur zurückgegeben, wenn Sie AWS Amplify verwenden. Weitere Informationen zur Integration Ihrer App mit AWS Amplify. Siehe Connect Ihre Frontend-Anwendung mithilfe von Amplify mit Amazon Pinpoint AWS.
`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 JSON Ereignisschemas. 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 über den Endpunkt, dem das Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle Client.
`device`	Informationen über das Gerät, das das Ereignis gemeldet hat. Bei Kampagnen- und Transaktionsnachrichten ist dieses Objekt leer.
`session`	Informationen über die Sitzung, die das Ereignis generiert hat. Bei Kampagnen 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).
`client_context`	Enthält ein `custom`-Objekt, das eine `endpoint`-Eigenschaft enthält. Die `endpoint`-Eigenschaft enthält den Inhalt des Endpunktdatensatzes für den Endpunkt, an den die Kampagne gesendet wurde.
`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.

Attribut	Beschreibung
`app_id`	Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat.
`sdk`	DieSDK, die verwendet wurde, um das Ereignis zu melden.

Attribute

Enthält Informationen über die Kampagne, die das Ereignis generiert hat.

Attribut	Beschreibung
`treatment_id`	Wenn die Nachricht mit einer A/B-Testkampagne gesendet wurde, stellt dieser Wert die Behandlungsnummer der Nachricht dar. Für Standardkampagnen ist dieser Wert `0`.
`campaign_activity_id`	Die eindeutige ID, die Amazon Pinpoint generiert, wenn das Ereignis eintritt.
`delivery_type`	Die Bereitstellungsmethode für die Kampagne. Verwechseln Sie dieses Attribut nicht mit dem `ChannelType`-Feld, das unter der `endpoint`-Eigenschaft von `client_context` angegeben ist. Das `ChannelType`-Feld basiert normalerweise auf dem Endpunkt, an den die Nachricht gesendet wird. Bei Kanälen, die nur einen Endpunkttyp unterstützen, haben die Felder `delivery_type` und `ChannelType` denselben Wert. Für den E-Mail-Kanal haben die `ChannelType` Felder `delivery_type` und beispielsweise den gleichen Wert vonEMAIL. Diese Bedingung gilt jedoch nicht immer für Kanäle, die unterschiedliche Endpunkttypen unterstützen, z. B. benutzerdefinierte Kanäle. Sie können einen benutzerdefinierten Kanal für verschiedene Endpunkte verwendenEMAIL, z. B. SMSCUSTOM,, usw. In diesem Fall `delivery_type` identifiziert der ein benutzerdefiniertes Zustellungsereignis und `ChannelType` gibt den Typ des Endpunkts an, an den die Kampagne gesendet wurde EMAILSMS, z. B.CUSTOM,, usw. CUSTOM Weitere Informationen zum Erstellen von benutzerdefinierten Kanälen finden Sie unter Erstellen Sie einen benutzerdefinierten Kanal in Amazon Pinpoint mithilfe einer Webhook- oder Lambda-Funktion. Die möglichen Werte sind: EMAIL SMS ADM APNS APNS_SANDBOX APNS_VOIP APNS_VOIP_SANDBOX VOICE GCM BAIDU PUSH CUSTOM
`campaign_id`	Die eindeutige ID der Kampagne, von der die Nachricht gesendet wurde.
`campaign_send_status`	Gibt den Status der Kampagne für den Zielendpunkt an. Mögliche Werte sind: SUCCESS— Die Kampagne wurde erfolgreich an den Endpunkt gesendet. FAILURE— Die Kampagne wurde nicht an den Endpunkt gesendet. DAILY_ CAP — Die Kampagne wurde nicht an den Endpunkt gesendet, da bereits die maximale Anzahl an täglichen Nachrichten an den Endpunkt gesendet wurde. EXPIRED— Die Kampagne wurde nicht an den Endpunkt gesendet, da das Senden die Einstellungen für die maximale Dauer oder Versandrate für die Kampagne überschreiten würde. QUIET_ TIME — Die Kampagne wurde aufgrund von Zeitbeschränkungen nicht an den Endpunkt gesendet. HOLDOUT— Die Kampagne wurde nicht an den Endpunkt gesendet, da der Endpunkt Mitglied der Holdout-Gruppe war. DUPLICATE_ ADDRESS — Das Segment enthält doppelte Endpunktadressen. Die Kampagne wurde einmal an die Endpunktadresse gesendet. QUIET_ TIME — Die Kampagne wurde aufgrund von Ruhezeiten nicht an den Endpunkt gesendet. CAMPAIGN_ CAP — Die Kampagne wurde nicht an den Endpunkt gesendet, da von dieser Kampagne bereits die maximale Anzahl von Nachrichten an den Endpunkt gesendet wurde. FAILURE_ PERMANENT — Beim Senden an den Endpunkt ist ein permanenter Fehler aufgetreten. TRANSIENT_ FAILURE — Beim Senden an den Endpunkt ist ein vorübergehender Fehler aufgetreten. THROTTLED— Das Senden wurde gedrosselt. UNKNOWN— Unbekannter Fehler. HOOK_ FAILURE — Der Kampagnen-Hook ist fehlgeschlagen. CUSTOM_ DELIVERY _ FAILURE — Die benutzerdefinierte Zustellung ist fehlgeschlagen. RECOMMENDATION_ FAILURE — Der Empfehlungsgeber ist fehlgeschlagen. UNSUPPORTED_ CHANNEL — Kanal wird nicht unterstützt.

Client

Enthält Informationen über den Endpunkt, auf den die Kampagne ausgerichtet war.

Attribut	Beschreibung
`client_id`	Die ID des Endpunkts, an den die Kampagne gesendet wurde.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

App-Event-Datenstream von Amazon Pinpoint

Reiseereignisdaten von Amazon Pinpoint