Senden von Ereignissen an die Driftrock Events API

Erfahren Sie, wie Sie Ereignisse über die Driftrock Events API an Driftrock senden können

Erstellung der POST-Anforderung

Sie können POST-Anforderungen an diese URLs stellen:

Wenn Sie an eine Driftrock-Webhook-Erfassung senden, verwenden Sie bitte https://external-apis.driftrock.com/v2/event

Wenn Sie an eine Driftrock-Partnererfassung senden, verwenden Sie bitte https://external-apis.driftrock.com/v2/affiliate_event

Wenn Sie sich nicht sicher sind, welche Sie verwenden sollen, wenden Sie sich bitte an Ihren CSM oder unser Support-Team.

Überschriften:

Content-Type: application/json
Accept: application/json
Authorization: Bearer xxxx-xxxx-xxxx-xxxx

wobei xxxx-xxxx-xxxx-xxxx ein Api-Schlüssel ist, den Sie unter Einstellungen -> Sicherheit erhalten. Sie können einen zuvor erstellten Schlüssel verwenden oder einen neuen Schlüssel erstellen.

Body:
Der Body muss JSON-formatiert sein und die erforderlichen oder empfohlenen Felder enthalten:

  • event_type [string] ( erforderlich): Dies sollte auf Lead, Conversion oder Action gesetzt werden.
  • event_name [string] ( erforderlich) : Geben Sie uns an, welche Bezeichnung Sie diesem Ereignis geben möchten (z. B.: Benutzer angemeldet, Seitenansicht, Kauf)
  • source_id [string] (erforderlich): Dies wird benötigt, um das Ereignis mit dem von Ihnen erstellten Capture zu verknüpfen. Sie finden dies im Schritt "Verbinden" (Schritt 2) Ihres Captures
  • fields [json]  (required) : this is a json field, where you send us the attributes of this event (eg: "fields": {"email": "test@driftrock.com", "question_1": "test answer"} )
  • event_id [string] (optional): Dies kann eine beliebige ID sein, die in Ihrem System zur eindeutigen Identifizierung dieses Ereignisses verwendet wird. Wenn Sie zwei Ereignisse mit derselben event_id senden, werden sie in unserem System mit derselben Person verknüpft.
  • person_id [string] (optional): Dies kann eine beliebige ID sein, die in Ihrem System zur eindeutigen Identifizierung einer Person verwendet wird. Beachten Sie, dass wenn Sie zwei Ereignisse mit der gleichen person_id senden, diese in unserem System mit der gleichen Person verknüpft werden.
  • ga_client_id [string] (optional) : Dies ist die Google Analytics ID, die Sie uns zur Verfügung stellen können, damit wir Marketinginformationen extrahieren können.
  • created_at [string] (optional): wenn Sie einen genaueren Zeitstempel für das Eintreten des Ereignisses angeben möchten. Wenn Sie keinen Zeitstempel angeben, wird dieser auf den Zeitpunkt gesetzt, zu dem Driftrock das Ereignis empfängt; dies ist ein feiner Unterschied, kann aber für Ihren Geschäftsfall wichtig sein. Der Zeitstempel sollte im ISO8601-Format übergeben werden (z. B. 2019-12-02T10:00:00.000Z).


Hier ein Beispiel dafür, wie ein einfacher Körper aussehen könnte

{
 "event_type": "lead",
 "event_name": "User signed up",
 "source_id": "034feb07-0cd7-4d44-bbdb-ae18a8a4132f",
 "fields": {
   "email": "test@driftrock.com",
   "first_name": "First name",
   "last_name": "Last name",
   ...
 }
}


Senden Sie Ihre erste Probeleitung.

Wenn Ihr Test erfolgreich war, sollten Sie die folgende Antwort erhalten:

  • Status: 200
  • payload: {"data": "ok"}

Wenn Ihr Test fehlgeschlagen ist, erhalten Sie die folgende Antwort:

  • Status: 400
  • payload: {"error": "..."}