Abfrageparameter verwenden

Wenn Sie in den sozialen Medien oder in E-Mail-Kampagnen auf eine Website verweisen möchten, können Sie im Website-Link Abfrageparameter angeben. So gelangen Nutzer schneller zum entsprechenden Abschnitt im Web Shop. Mithilfe von Abfrageparametern können Sie die folgenden Aktionen konfigurieren, die ausgeführt werden, wenn ein Nutzer auf den Link klickt:

• Automatische Authentifizierung mithilfe der Benutzer-ID oder eines Deep Links
• Weiterleitung zur Karte eines bestimmten Artikels. Wenn der Nutzer bereits auf der Website angemeldet ist, wird er zum Bezahlvorgang weitergeleitet.
• Öffnen des Zahlungsportals, um einen Artikel zu kaufen oder ein Abonnement abzuschließen. Auch über diesen Link wird der Nutzer automatisch auf der Website angemeldet.
• Überschreiben des Landes des Nutzers, ganz gleich, welches Land anhand der IP-Adresse ermittelt wurde.
• Automatische Anwendung eines Promocodes auf den Katalog oder Einlösen eines Gutscheine zum Erhalt einer Belohnung.

Autorisierung einrichten

Autorisierung über die Benutzer-ID

Für die automatische Benutzerautorisierung beim Aufruf der Website können Sie einen Link samt Abfrageparameter verwenden. Diese Option eignet sich, wenn Ihre Website so konfiguriert ist, dass sich die Nutzer über ihre Benutzer-ID authentifizieren.

So können Sie einen Nutzer über dessen ID automatisch authentifizieren:

1. Kopieren Sie den Website-Link.
2. Hängen Sie am Ende des Links den Abfrageparameter ?user-id=<UserID> an, wobei <UserID> die ID des Nutzers ist, dem Sie den Link senden.

• Beispiel: https://webshop-external-demo.xsolla.site/?user-id=12345

3. Senden Sie den Nutzern individuelle Links.

Nachdem der Nutzer auf den Link geklickt hat, wird er zur Website weitergeleitet und automatisch authentifiziert.

Autorisierung über Deep-Links

Für die automatische Benutzerautorisierung beim Aufruf der Website können Sie einen Link samt Abfrageparameter verwenden. Diese Option eignet sich, wenn Ihre Website so konfiguriert ist, dass sich die Nutzer über einen Deep-Link authentifizieren.

So können Sie einen Nutzer über einen Deep-Link automatisch authentifizieren:

1. Kopieren Sie den Website-Link.
2. Hängen Sie am Ende des Links den Abfrageparameter ?deeplink=true an.

• Beispiel: https://webshop-external-demo.xsolla.site/?deeplink=true

3. Veröffentlichen Sie den Link in öffentlich zugänglichen Materialien oder senden Sie den Nutzern individuelle Links.

Nachdem der Nutzer auf den Link geklickt hat, wird er zur Website weitergeleitet und automatisch authentifiziert.

Weiterleitung zu einer Artikelkarte einrichten

Verwenden Sie einen Link mitsamt Abfrageparameter, um den Nutzer beim Öffnen der Website direkt zum gewünschten Artikel weiterzuleiten. Nicht autorisierten Nutzern wird eine Karte mit Informationen zu dem im Abfrageparameter angegebenen Artikel angezeigt. Wenn der Nutzer bereits auf der Website angemeldet ist, öffnet sich nach dem Klick auf den Link das Zahlungsportal – dort kann der Nutzer den Artikel kaufen.

So leiten Sie einen Nutzer zu einem bestimmten Artikel weiter:

1. Kopieren Sie den Website-Link.
2. Hängen Sie am Ende des Links den Abfrageparameter ?purchase-sku=<item_SKU> an, wobei <item_SKU> die SKU des gewünschten Artikels ist.

• So finden Sie die SKU des Gegenstands (am Beispiel eines virtuellen Gegenstands):
  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
  2. Navigieren Sie zu der Artikelgruppe, in der sich der Gegenstand befindet.
  3. Kopieren Sie die SKU aus der Zeile des entsprechenden Gegenstands unter seinem Namen.
  Beispiel: https://webshop-external-demo.xsolla.site/?purchase-sku=my-awesome-crystal

3. Veröffentlichen Sie den Link in öffentlich zugänglichen Materialien oder senden Sie den Nutzern individuelle Links.

Nachdem der Nutzer auf den Link geklickt hat, gelangt er entweder zur Website mit der Artikelkarte und den detaillierten Artikelinformationen oder zum Zahlungsportal, wo er den Artikel kaufen kann. Das hängt davon ab, ob der Nutzer auf der Website authentifiziert ist.

Weiterleitung zum Kauf eines Artikels einrichten

Verwenden Sie einen Link mitsamt Abfrageparametern, um den Nutzer beim Öffnen der Website zum Zahlungsportal weiterzuleiten, wo er den entsprechenden Artikel kaufen kann. Der Link für den Artikelkauf enthält außerdem einen der Autorisierungsparameter, sodass der Nutzer automatisch angemeldet wird.

So erfolgt die Einrichtung:

1. Kopieren Sie den Website-Link.
2. Hängen Sie am Ende des Links einen der folgenden Authentifizierungsparameter an: ?user-id=<user_ID> oder ?deeplink=true.
3. Hängen Sie hinter dem Authentifizierungsparameter den Abfrageparameter ?purchase-sku=<item_SKU> an, wobei <item_SKU> die SKU des Artikels ist.

• So finden Sie die SKU eines Artikels (am Beispiel eines virtuellen Gegenstands):
  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
  2. Navigieren Sie zu der Artikelgruppe, in der sich der Gegenstand befindet.
  3. Kopieren Sie die SKU aus der Zeile des entsprechenden Gegenstands unter seinem Namen.

• Beispiel: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=my-awesome-crystal

4. Veröffentlichen Sie den Link in öffentlich zugänglichen Materialien oder senden Sie den Nutzern individuelle Links.

Weiterleitung zum Abschluss eines Abonnements einrichten

Verwenden Sie einen Link mitsamt Abfrageparametern, um den Nutzer beim Öffnen der Website zum Zahlungsportal weiterzuleiten, wo er das entsprechende Abonnement abschließen kann. Der Link für den Abschluss des Abonnements enthält außerdem einen der Autorisierungsparameter, sodass der Nutzer automatisch angemeldet wird.

Gehen Sie für die Einrichtung wie folgt vor:

1. Kopieren Sie den Website-Link.
2. Fügen Sie einen der Authentifizierungsparameter am Ende des Links hinzu: ?user-id=<user_ID> oder ?deeplink=true.
3. Fügen Sie hinter dem Authentifizierungsparameter den String &purchase-subscription=<plan_ID> hinzu, wobei <plan_ID> die ID des Abo-Modells ist.

1. So finden Sie die ID des Abo-Modells:
   1. Navigieren Sie im Kundenportal zum Menüpunkt Artikelkatalog > Abonnements.
   2. Kopieren Sie die ID aus der Zeile des gewünschten Abo-Modells über dessen Namen.

1. Beispiel: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-subscription=8Mp0MT9R

4. Veröffentlichen Sie den Link in öffentlich zugänglichen Materialien oder senden Sie den Nutzern individuelle Links.

Land für den Kauf festlegen

Verwenden Sie einen Link mit dem Abfrageparameter purchase-country, um das Land des Nutzers beim Zugriff auf den Web Shop explizit anzugeben. Dieser Parameter legt das Land beim Bezahlvorgang fest, unabhängig davon, welches Land automatisch anhand der IP-Adresse ermittelt wurde.

Einrichtung:

1. Kopieren Sie den Website-Link.
2. Fügen Sie einen der Authentifizierungsparameter am Ende des Links hinzu: ?user-id=<user_ID> oder ?deeplink=true.
3. Fügen Sie hinter dem Authentifizierungsparameter &purchase-sku=<ITEM_SKU>&purchase-country=<COUNTRY_CODE> hinzu, wobei:
   • <ITEM_SKU> die SKU des Artikels ist.
   • <COUNTRY_CODE> der zweistellige Ländercode gemäß ISO 3166-1 Alpha-2 ist. Der Parameter beeinflusst die angezeigte Währung, die Steuern und die verfügbaren Zahlungsmethoden im Web Shop.

Beispiel: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=8Mp0MT9R&purchase-country=MY

Den Einsatz von Promocodes oder Gutscheinen einrichten

Sie können einen Link mitsamt Abfrageparameter verwenden, um den Promocode oder Gutschein eines Nutzers anzuwenden. Der Code kann automatisch nach dem Aufruf der Website oder durch einen Klick auf die Schaltfläche Code einlösen angewendet werden. Sie können dem Link auch Parameter für eine der Authentifizierungsmethoden hinzufügen. Konfigurieren Sie Promocodecodes und Gutscheine im Projekt, um einen Link samt Code-Parameter zu verwenden.

1. Kopieren Sie den Website-Link.
2. Hängen Sie am Ende des Links einen der folgenden Abfrageparameter an:
   • ?redeem-code=<promo_code> – zum automatischen Einlösen des Codes.
   • ?insert-code=<promo_code> – zum Einlösen nach einem Klick auf eine entsprechende Schaltfläche.

• Anstelle von <promo_code> können Sie einen Promocode angeben, der im Kundenportal generiert wurde oder den sie selbst erstellt haben.

• Beispiel: https://xsolla.webshop.com/?redeem-code=promo777

• Wenn Sie möchten, dass der Nutzer automatisch auf der Website authentifiziert wird, fügen Sie einen der folgenden Authentifizierungsparameter vor dem Code-Parameter im Link hinzu: ?user-id=<user_ID> oder ?deeplink=true.

• Beispiel: https://webshop-external-demo.xsolla.site/?user-id=12345&redeem-code=TESTCOUPON

3. Veröffentlichen Sie den Link in öffentlich zugänglichen Materialien oder senden Sie den Nutzern individuelle Links.

Nachdem der authentifizierte Nutzer auf den Link geklickt hat, wird er zur Website weitergeleitet, wo der Code automatisch aktiviert wird oder der Nutzer die Möglichkeit hat, den Code manuell einzulösen.