Amplitude: Event tracken

Verwenden Sie Amplitude: Event tracken, um ein Event von einem Journey-Schritt an ein Amplitude-Projekt über die HTTP API V2 zu senden, mit den von Ihnen aufgelisteten Eigenschaften.

Pushwoosh setzt die insert_id von Amplitude für Sie aus dem Reisenden und diesem Schritt. Das bedeutet, dass derselbe Reisende, der diesen exakten Punkt zweimal durchläuft, zum Beispiel bei einem zweiten Durchlauf einer sich wiederholenden Journey, als ein dedupliziertes Event in Amplitude landet, nicht als zwei.

Typische Anwendungsfälle:

• Journey-Meilensteine protokollieren: Senden Sie ein Event, wenn ein Reisender einen Schritt erreicht, damit es neben Ihren Produktereignissen in Amplitude-Funnels erscheint.
• Einen Cross-Channel-Funnel speisen: Protokollieren Sie Push-, E-Mail- oder SMS-Meilensteine neben In-App-Events für eine einzige Funnel-Ansicht in Amplitude.
• Eine sich wiederholende Journey sicher verfolgen: Die integrierte Deduplizierung bedeutet, dass ein Reisender, der zu diesem Schritt zurückkehrt, immer noch als ein Event und nicht als mehrere erfasst wird.

Den Punkt konfigurieren

1. Ziehen Sie Amplitude: Event tracken aus dem Abschnitt Integrationen auf den Canvas.
2. Doppelklicken Sie auf den Punkt und geben Sie einen Schrittnamen ein.
3. Geben Sie unter API-Schlüssel den Projekt-API-Schlüssel aus Amplitude ein: Einstellungen > Projekte > Ihr Projekt > Allgemein. Er wird maskiert gespeichert, wie ein geheimer Webhook-Header. Pushwoosh zeigt ihn nach dem Speichern niemals an oder gibt ihn zurück, und er erscheint niemals in der gespeicherten Anfrage des Punktes oder im Anrufprotokoll.

4. Wählen Sie unter Amplitude-Endpunkt die Region aus, in der das Amplitude-Projekt erstellt wurde: api2.amplitude.com für ein US-Projekt, api.eu.amplitude.com für ein EU-Projekt. Ein Schlüssel aus einer Region wird von der anderen abgelehnt.

5. Geben Sie unter Event-Name das Event so ein, wie es in Amplitude erscheinen soll, zum Beispiel journey_welcome_push_sent. Es akzeptiert dieselben Makros wie Event-Eigenschaften.

6. Fügen Sie unter Event-Eigenschaften eine Zeile pro Eigenschaft hinzu, die mit dem Event gesendet werden soll. Geben Sie den Eigenschaftsnamen und den Wert ein. Namen müssen nicht leer und eindeutig sein. Ein Wert, der ein einzelnes Reisenden-Makro ist, behält seinen eigenen Typ in Amplitude ({{tag:Age}} kommt als Zahl an, {{tag:Trial Ends}} als Datum). Jeder andere Text wird als String gesendet. Makros verwenden dieselbe Syntax wie der Body eines Webhooks. Oder klicken Sie auf Dynamischen Wert einfügen, um ein Attribut auszuwählen, das ein früherer Schritt in dieser Journey erzeugt hat, zum Beispiel eine LLM-Antwort oder einen zugeordneten Webhook-Wert.

Beispiel

Wenn Sie die Event-Eigenschaften auf plan mit der Tarifstufe des Reisenden ({{tag:Plan}}) setzen, wird diese Eigenschaft mit dem Event an Amplitude gesendet.

7. Klicken Sie auf Speichern.

Antwort

Der Reisende fährt mit dem nächsten Schritt fort, den Sie auf dem Canvas verbinden.

Attribute nach Ausführung des Schritts

Attribut	Was es enthält
amplitude_events_ingested	Die Anzahl der von Amplitude aufgenommenen Events

Wie man es in späteren Schritten verwendet

Der Reisende ist bereits unabhängig von diesem Attribut zum nächsten Schritt weitergegangen. Speichern Sie es in einem Tag mit Benutzerprofil aktualisieren, wenn Sie bestätigen müssen, dass das Event aufgenommen wurde, oder verzweigen Sie darauf mit Bedingte Aufteilung.

Fehler und unerwartete Antworten

Eine fehlgeschlagene Anfrage entfernt den Reisenden aus der Journey. Siehe Fehler und fehlgeschlagene Anfragen.

Beispielszenario: Protokollierung von Journey-Sends in einem Amplitude-Funnel

Ein Team möchte, dass das Senden einer Willkommens-Push-Nachricht im selben Amplitude-Funnel wie ihre anderen Produktereignisse erscheint.

1. Fügen Sie Amplitude: Event tracken an dem Punkt in der Journey hinzu, an dem das Event ausgelöst werden soll. Setzen Sie den Event-Namen auf journey_welcome_push_sent.
2. Klicken Sie auf Speichern.

Sobald dies ausgeführt wird, erscheint der Sendevorgang in Amplitude neben den restlichen Produktereignissen, sodass der Funnel das Gesamtbild widerspiegelt, anstatt einer Lücke, in der der Journey-Schritt nicht berichtet.