Tracking Analytics

So funktioniert's

Tracking Analytics ermöglicht Ihnen, nutzergenerierte Ereignisse zu sammeln, um die Programmleistung und die Anzahl der Überweisungen zu evaluieren. Die gesammelten Daten können auch dazu verwendet werden, Affiliate-Netzwerke anzulocken. Gute Statistiken machen jedes Angebot überzeugender.

Die folgenden Ereignisse können verarbeitet werden:

  • Weiterleitung an die Landing-Page
  • Weiterleitung von der Landing-Page an den Online-Shop

Für wen ist es

  • Partner, die das Partnernetzwerk integriert und ein Affiliate-Netzwerk konfiguriert haben.
  • Partner, die das Partnernetzwerk integriert haben und kostenlose Spiele anbieten

Wie komme ich dazu

Gehen Sie folgendermassen vor, um Tracking Analytics zu integrieren:

  1. Abrufen Sie sich ein JSON Web Token (JWT).
  2. Speichern Sie die tracking_id aus dem Anfrageparameter in deine Webseiten-Cookies. Beispiel einer Anfrage mit tracking_id: https://playnewz.com?utm_source=n6LI9yVu&utm_campaign=5b9bff5f9d31b&tracking_id=19e2DLjNTk2YOdXA4d8J3NReNkXNafhC.
  3. Nachdem ein neuer Benutzer erstellt wurde, senden Sie user_id und tracking_id über die Methode Senden des Registrierungsereignisses.
    • Es wird empfohlen, die Anfragen asynchron zu senden, damit die Benutzerregistrierung während der Wartezeit auf die Antwort der Xsolla Tracking API nicht beeinträchtigt wird.
    • Ansonsten nutze Timeout. Beachten Sie, dass neue Benutzer nicht nachverfolgt werden, wenn die Antwort der Xsolla Tracking API länger als vorgegeben dauert.
  4. Um benutzerdefinierte Ereignisse zu erstellen und zu verwalten, implementieren Sie folgende Tracking-API-Methoden: erstellen, initialisieren und senden.
  5. Implementieren Sie das Tracking-Script auf Ihrer Website.

Token abrufen

HTTP-ANFRAGE

POST https://tracking-api.xsolla.com/v1/tokens

Parameter Beschreibung
Authorization API_KEY. Sie erhalten den API-Schlüssel in Ihrem Kundenportal
sourceType Datenquellentyp. Kann "client" oder "server" sein. Kundenquellen gelten als nicht vertrauenswürdig und alle relevanten Ereignisse haben im Speicher den Eintrag "trusted: false". Serverquellen gelten als vertrauenswürdig und alle relevanten Ereignisse haben im Speicher den Eintrag "trusted: true".
sourceName Name der Datenquelle.
projectId Projekt-ID.

BEISPIEL: EINEN TOKEN ERHALTEN

POST https://tracking-api.xsolla.com/v1/tokens
Authorization: Basic 12kj3hlk1j2hlkjhlk1j2h3lkj
{
  "sourceType": "client",
  "sourceName": "landing",
  "projectId": 1
}

HTTP/1.1 201 Token created
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2 g_dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du"
}

Antwortcode Beschreibung
201 Token erstellt
400 Abfrageparameter sind nicht gültig
401 Der Produktschlüssel ist ungültig

Senden des Registrierungsereignisses

Sie müssen dafür ein Token erhalten haben.

HTTP-ANFRAGE

POST https://tracking-api.xsolla.com/v1/events

Parameter Beschreibung
Authorization Zuvor erhaltenes Token.
type Ereignistyp (hier: 'registration').
traits Objekt. Benutzeridentifikationsdaten:
  • trackingIdtracking_id der Benutzer, die auf die Spielwebseite weitergeleitet wurden. Xsolla sendet es im Anfrageparameter gleich nach der Weiterleitung.
  • userId - Benutzer-ID wird nach der Erstellung des Tokens zugewiesen.
context Das Objekt muss leer sein.
properties Das Objekt muss leer sein.

BEISPIEL

curl -X POST \
https://tracking-api.xsolla.com/v1/events \
-H 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzb3VyY2VUeXBlIjoiY2xpZW50Iiwic291cmNlIjoicHVibGlzaGVySWRfMjM0MF9wcm9qZWN0SWRfMjAyMDFfbXVsdGkiLCJpYXQiOjE1NDMyMzAxODN9.0LheoQnDKJHIHWNMSIrhcrBEu_th3xUHykhLby1nik4' \
-H 'content-type: application/json' \
-d '{ "type": "registration", "traits": { "trackingId": "19e2DLjNTk2YOdXA4d8J3NReNkXNafhC", "userId": "20181126" }, "properties": {}, "context": {} }'

Ereignis erstellen

Sie müssen dafür ein Token erhalten haben.

HTTP-ANFRAGE

POST https://tracking-api.xsolla.com/v1/events

Parameter Beschreibung
Authorization Zuvor erhaltenes Token.
type Ereignistyp.
traits Objekt. Benutzeridentifikationsdaten: Telefon, E-Mail, In-Game-ID usw.
context Objekt. Kontextdaten.
properties Objekt. Ereigniseigenschaften.
createdAt Datum. Format: Datetime nach RFC 3339 oder ISO 8601.

BEISPIELEREIGNIS ÜBERLEITUNG ZUR LANDING-PAGE

POST https://tracking-api.xsolla.com/v1/events
Authorization: Bearer
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU
{
  "type": "landing_visit",
  "traits":{
    },
  "properties":{
    },
  "context": {
    "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "user_locale":"ru"
  }
}

BEISPIELEREIGNIS: ÜBERLEITUNG ZUR BEZAHLSTATION

POST https://tracking-api.xsolla.com/v1/events
Authorization: Bearer
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU
{
  "type": "buy_btn",
  "traits":{
    },
  "properties":{
    "pkg_type":"bronze"
    },
  "context": {
    "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "user_locale":"ru"
  }
}

Antwortcode Beschreibung
204 Ereignis hinzugefügt
400 Ereignis ist ungültig
401 Token ist ungültig

Ereignis initialisieren

Sie müssen dafür ein Token erhalten haben.

xnt("init", YOUR_TOKEN);

Ereignis senden

xnt("sendEvent", EVENT_TYPE, EVENT_PROPERTIES);

Parameter Beschreibung
EVENT_TYPE Ereignisname (String). Z.B., "landing_visit".
EVENT_PROPERTIES Ereigniseigenschaften (JS-Objekt).

BEISPIEL

xnt("sendEvent", "landing_visit");
xnt("sendEvent", "buy_btn", { pkg_type: $(this).data('id') });

EREIGNISPARAMETER

Parameter Beschreibung
source Ereignisquelle (Bezahlstation, landing_page, usw.).
type Ereignistyp (user_visit, Treffer, usw.).
traits Benutzerdaten (E-Mail, user_id, Spitzname, usw.).
context Ereigniskontext (IP, gaClientId, usw.).
properties Ereigniseigenschaften (Summe, aufleveln, usw.).
createdAt Ereigniszeit, wie von de Quelle übergeben.
timestamp Time of event receipt by the system.

Um das Ereignis mit 'context' & 'traits' Parametern zu ergänzen, folgende Methoden nutzen:

xnt("putContext", CONTEXT_OBJECT);
xnt("putTraits", TRAITS_OBJECT);

Parameter Beschreibung
CONTEXT_OBJECT Ereigniskontext (JS-Objekt).
TRAITS_OBJECT Benutzerdaten (JS-Objekt)
Note: 'userAgent' und 'userLocale' des Kontextes werden automatisch hinzugefügt. Die von diesen beiden Methoden hinzugefügten Daten werden mit den Ereignisdaten kombiniert.

Script implementieren

Implementieren Sie das folgende Skript auf der Landing-Page:

<script>
(function(i,s,o,g,r,a,m){i['XsollaNetworkTrackingObject']=r;i[r]=i[r]||function(){(i[r].q=i[r].q||[]).push(ar guments)},i[r].l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.inse rtBefore(a,m)})(window,document,'script','https://cdn.xsolla.net/network/xtracking-0.1.js','xnt');
xnt("init", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_ dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du");
xnt("sendEvent", "buy_btn", { pkg_type : "gold" });
</script>