Tenjin integrieren

Begriffserläuterung

Tenjin

Plattform für Attribuierung und Marketing-Analytics, auf der Anwendungsentwickler und Marketingfachleute Marketingkampagnen über verschiedene Kanäle und Geräte hinweg tracken, messen und optimieren können.

Ausführliche Informationen zur Plattform finden Sie in der Tenjin-Dokumentation.

Anwendungs-ID

ID der mobilen App. Die ID wird automatisch generiert, wenn in Tenjin eine Anwendung hinzugefügt wird. Die ID entspricht der Bundle ID. So finden Sie die ID:

1. Navigieren Sie in Ihrem Tenjin-Konto zu Configure > All apps.
2. Öffnen Sie die Seite der gewünschten App.
3. Kopieren Sie im Abschnitt Add details die Bundle ID.

SDK-Schlüssel

ID der mobilen App. Die ID wird automatisch generiert, wenn in Tenjin eine Anwendung hinzugefügt wird. Die ID entspricht der Bundle ID. So finden Sie die ID:

1. Navigieren Sie in Ihrem Tenjin-Konto zu Configure > All apps.
2. Öffnen Sie die Seite der gewünschten App.
3. Kopieren Sie im Abschnitt Add details die Bundle ID.

Hinweis

Wenn Ihre App sowohl für iOS als auch für Android veröffentlicht ist, benötigen Sie einen Schlüssel auf Kontoebene. Wenden Sie sich dazu an Ihren Kundenbetreuer bei Tenjin.

Schlüssel auf Kontoebene

Token, der dazu dient, S2S-Aufrufe (Server-zu-Server) zu autorisieren, wenn Ihre App sowohl für iOS als auch für Android veröffentlicht ist. Der Token wird manuell von Tenjin generiert. Wenden Sie sich dazu an Ihren Kundenbetreuer bei Tenjin.

Beachten Sie, dass die Bundle-IDs für jede Plattform (iOS, Android) einzigartig sind.

Tenjin ID

Von Tenjin generierte Benutzer-ID (analytics_installation_id).

Lifetime Value (LTV)

Durchschnittlicher Erlös, den ein Nutzer während der Nutzung Ihrer App generiert. Ausführliche Informationen zum LTV finden Sie in der Tenjin-Dokumentation.

Return on Advertising Spend (ROAS)

Kennzahl, die die Effektivität einer Werbekampagne misst, indem der generierte Umsatz pro Werbeausgaben-Einheit berechnet wird. Ausführliche Informationen zum ROAS finden Sie in der Tenjin-Dokumentation.

Return on Investment (ROI)

Kennzahl, die den Return on Investment misst, indem der Prozentsatz des erzielten Gewinns im Verhältnis zu den Gesamtkosten berechnet wird. Ausführliche Informationen zum ROI finden Sie in der Tenjin-Dokumentation.

In-App-Ereignis

Nutzeraktion innerhalb der App. Die Aktionen der Nutzer im Web Shop werden im Falle einer S2S-Integration auch als In-App-Ereignisse betrachtet und vom Xsolla-Backend an Tenjin gesendet.

Nutzergewinnung

Der Vorgang, durch Marketingaktivitäten neue Nutzer für eine Website, einen Dienst, eine Plattform oder eine Anwendung zu gewinnen.

Customer User ID (CUID)

Benutzer-ID, die vom App-Inhaber bei der Registrierung des Nutzers generiert und festgelegt wird. Die СUID muss für Web Shop und für Tenjin identisch sein. Dieser Parameter ermöglicht die Nutzerzuordnung und ‑attribution.

Achtung

Wenn die CUIDs im Web Shop und in Ihrer App nicht übereinstimmen, wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, um den Webhook Benutzervalidierung im Web Shop oder die Authentifizierung über einen Deep Link zu implementieren.

Rückruf

Prozess, bei dem Daten zu In-App-Ereignissen empfangen werden. Ausführliche Informationen finden Sie in der Tenjin-Dokumentation.

Integrationsszenario

Tenjin und Xsolla unterstützen die S2S-Integration für Apps. Dadurch ist es möglich, den LTV, den ROAS und den ROI für in der App und im Web Shop getätigte Käufe zu messen. Xsolla sendet Informationen über im Web Shop getätigte Käufe als In-App-Ereignisse an Tenjin, und Tenjin ordnet diese dann der Anzahl der App-Installationen und der jeweiligen Nutzergewinnungskampagne zu.

Sie können die App-Integration so konfigurieren, dass Sie erweiterte Ereignisanalysen erhalten, sofern Sie:

• über eine Android-/iOS-App verfügen
• Tenjin verwenden
• die Lösung Web Shop zum Verkauf von Ingame-Items verwenden

Das folgende Ereignis ist über die Xsolla- und Tenjin-S2S-Integration verfügbar:

So funktioniert's

Die Integration ermöglicht einen bidirektionalen Datenfluss zwischen Xsolla und Tenjin. Im Folgenden ist erläutert, wie das System interagiert, wenn ein Nutzer etwas kauft.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Tenjin: 7. Sends xsolla-billing-payment event

1. Der Nutzer registriert sich bei der App oder meldet sich an.
2. Ihre App sendet ein In-App-Ereignis, in dem die CUID enthalten ist, an Tenjin.
3. Tenjin sendet einen Rückruf an Xsolla – darin enthalten sind die Anwendungs-ID, die Tenjin ID, die CUID und andere zugehörige Datenparameter.
4. Der Nutzer meldet sich mit der CUID im Web Shop an.
5. Der Nutzer kauft etwas im Web Shop.
6. Das Kaufereignis wird an den Xsolla-Server gesendet und mit den von Tenjin empfangenen Daten abgeglichen.
7. Xsollas Server sendet ein S2S-In-App-Ereignis an Tenjin – darin enthalten sind die Tenjin ID, die Anwendungs-ID und andere von Tenjin empfangene Parameter.

Tenjin weist ein neue Ereignis, den Kauf und den Umsatz der Medienquelle zu.

Einrichtung im Kundenportal

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Integrationen.
2. Klicken Sie auf Tenjin.

3. Klicken Sie bei S2S-Integration von Mobile Apps auf Konfigurieren.
4. Aktivieren Sie das Kontrollkästchen Diese Integration aktivieren.
5. Geben Sie die folgenden Daten ein:
   • SDK-Schlüssel. Wird aufseiten von Tenjin für jede Plattform (iOS, Android) generiert. Wenn Ihre Anwendung sowohl für iOS als auch für Android veröffentlicht ist, müssen Sie einen von Tenjin erhaltenen Schlüssel auf Kontoebene angeben.
   • Anwendungs-ID.
6. Klicken Sie auf Speichern.
7. Aktivieren Sie die Integration in Tenjin.

Sobald Sie die Einstellungen gespeichert haben, wird im S2S-Integrationsfenster ein grüner Punkt angezeigt.

So nehmen Sie Änderungen an der aktiven Integration vor:

1. Klicken Sie auf Tenjin.
2. Daraufhin öffnet sich ein Fenster, nehmen Sie darin die erforderlichen Änderungen vor.
3. Klicken Sie auf Speichern.

Einrichtung in Tenjin

In Tenjin müssen Sie:

1. die Übermittlung der CUID an Tenjin konfigurieren,
2. Xsolla als Werbekanal hinzufügen,
3. einen Rückruf konfigurieren.

CUID übermitteln

Konfigurieren Sie mithilfe der Methode setCustomerUserId, dass die CUID von Ihrer App an Tenjin übermittelt wird:

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

Xsolla als Werbekanal hinzufügen

1. Melden Sie sich bei Ihrem Tenjin-Konto an.
2. Navigieren Sie zu Configure > Channels.
3. Klicken Sie auf Add a channel.

4. Geben Sie in der Suchleiste die Bezeichnung “Xsolla” ein, und wählen Sie den Eintrag aus.
5. Klicken Sie auf Xsolla.

6. Klicken Sie auf Add ad account.

Rückruf konfigurieren

1. Melden Sie sich bei Ihrem Tenjin-Konto an.
2. Navigieren Sie zu Configure > Channels.
3. Naivigieren Sie zur Seite der gewünschten App.
4. Wechseln Sie zur Registerkarte Callbacks.
5. Wählen Sie in der Drop-down-Liste für Werbekanäle die Option Xsolla aus.

6. Klicken Sie im Abschnitt Channel callbacks auf Add events, und wählen Sie Xsolla login aus.

7. Wählen Sie im Modalfenster das Ereignis aus, in dem die CUID enthalten ist, und klicken Sie auf Save.

Ereigniswert-Struktur

Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie ein bestimmtes Ereignis einrichten möchten oder die aktuellen Integrationsoptionen für Ihre Anforderungen nicht ausreichen.

Artikelkauf

Wenn ein Nutzer etwas im Web Shop kauft, sendet Xsolla das Ereignis xsolla-billing-payment an Tenjin. Die folgenden Kaufinformationen werden in den Ereignisparametern übermittelt:

Zusätzliche Daten

Darüber hinaus können Sie die folgenden Parameter im Rückruf übermitteln: