Sessionmanagement. ClickandBuy International Ltd. Registered Office: Lincoln House Hammersmith Road London W14 0QL

Transkript

1 Sessionmanagement ClickandBuy International Ltd. Registered Office: Lincoln House Hammersmith Road London W14 0QL Tel.: +44 (0) Fax: +44 (0) Version: 1.2 April 2009

2 ClickandBuy Sessionmanagement ClickandBuy International Ltd. Rechtsbelehrung Kein Teil der Dokumentation darf ohne schriftliche Genehmigung der ClickandBuy International Ltd. reproduziert oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Die ClickandBuy International Ltd. übernimmt keine Gewähr für die Funktion einzelner Programme oder von Teilen derselben. Insbesondere übernimmt sie keinerlei Haftung für eventuelle aus dem Gebrauch resultierender Folgeschäden.

3 Inhaltsverzeichnis Inhaltsverzeichnis...I Abbildungsverzeichnis...II Über diese Dokumentation...1 Zielgruppe Das ClickandBuy Sessionmanagement Wie funktioniert es? Anforderungen an das Anbietersystem Erstellung und Konfiguration von Sessionlinks Bepreisen von einzelnen Dateien Sessionlink erstellen Sessionlink integrieren und Integration testen Beispiel Dokumentierte Fehler HTTP 404 Datei nicht gefunden Testbetrieb Das von Ihnen angewählte Angebot Bepreisen eines gesamten Verzeichnisses Sessionlink erstellen Sessionlink integrieren und Integration testen Beispiel Dokumentierte Fehler HTTP 404 Datei nicht gefunden Testbetrieb Das von Ihnen angewählte Angebot Bepreisen von Dateien (Experten-Modus) Sessionlink erstellen Sessionlink integrieren und Integration testen Beispiel Dokumentierte Fehler HTTP 404 Datei nicht gefunden Testbetrieb Das von Ihnen angewählte Angebot Der Preis wird mit kostenlos angegeben Bepreisen von Dateien zu dynamischen Preisen (Experten-Modus) Sessionlink erstellen Sessionlink integrieren und Integration testen Beispiel Dokumentierte Fehler HTTP 404 Datei nicht gefunden Testbetrieb Das von Ihnen angewählte Angebot Der Preis wird mit kostenlos angegeben ClickandBuy Zusatzfunktionen Parameterübergabe MD5-Verschlüsselung des Premiumlinks Wie funktioniert es? Einstellung und Verwendung der MD5-Funktionalität Troubleshooting MD Benutzergruppen Technischer Support Anhang Reservierte Parameternamen Nation-Codes Währungscodes...47 I

4 Abbildungsverzeichnis Abbildung 1: Neuen Link einrichten...5 Abbildung 2: Link einrichten- Details...5 Abbildung 3: Link einbauen...6 Abbildung 4: Mitarbeitergruppe...7 Abbildung 5: Beispiel - Link einrichten...8 Abbildung 6: Fehlermeldung HTTP Datei nicht gefunden...9 Abbildung 7: Fehlermeldung Testbetrieb...10 Abbildung 8: Fehlermeldung "Das von Ihnen angewählte Angebot..."...10 Abbildung 9: Neuen Link Einrichten...11 Abbildung 10: Link einrichten- Details...12 Abbildung 11: Link einbauen...13 Abbildung 12: Mitarbeitergruppe...14 Abbildung 13: Beispiel - Link einrichten...15 Abbildung 14: Fehlermeldung HTTP Datei nicht gefunden...16 Abbildung 15: Fehlermeldung Testbetrieb...17 Abbildung 16: Fehlermeldung "Das von Ihnen angewählte Angebot..."...17 Abbildung 17: Neuen Link Einrichten...19 Abbildung 18: Link einrichten- Details...19 Abbildung 19: Sessionlink bearbeiten - Experten-Modus...20 Abbildung 20: Experten-Modus...20 Abbildung 21: Experten-Modus-Feldbeschreibung...21 Abbildung 22: Link einbauen...22 Abbildung 23: Mitarbeitergruppe...22 Abbildung 24: Beispiel - Link erstellen...23 Abbildung 25: Beispiel - Pattern anlegen...24 Abbildung 26: Fehlermeldung HTTP Datei nicht gefunden...24 Abbildung 27: Fehlermeldung Testbetrieb...25 Abbildung 28: Fehlermeldung "Das von Ihnen angewählte Angebot..."...26 Abbildung 29: Kostenloser Preis...26 Abbildung 30: Neuen Link Einrichten...28 Abbildung 31: Link einrichten- Details...28 Abbildung 32: Sessionlink bearbeiten - Experten-Modus...29 Abbildung 33: Experten-Modus...29 Abbildung 34: Experten-Modus-Feldbeschreibung...30 Abbildung 35: Link einbauen...31 Abbildung 36: Mitarbeitergruppe...31 Abbildung 37: Beispiel - Link erstellen...32 Abbildung 38: Beispiel erstes Pattern anlegen...33 Abbildung 39: Beispiel zweites Pattern anlegen...33 Abbildung 40: Fehlermeldung HTTP Datei nicht gefunden...34 Abbildung 41: Fehlermeldung Testbetrieb...35 Abbildung 42: Fehlermeldung "Das von Ihnen angewählte Angebot..."...35 Abbildung 43: Kostenloser Preis...36 Abbildung 44: Dynamische Parameterübergabe...38 Abbildung 45: Header Parameter...39 Abbildung 46: Registrierungsparameter...39 Abbildung 47: Beispiel einer MD5 Hashwertermittlung...41 Abbildung 48: Fehlermeldung MD Abbildung 49: Benutzergruppe anlegen...42 Abbildung 50: Benutzergruppe verwalten...42 Abbildung 51: Reservierte Parameternamen...44 Abbildung 52: Nation Codes...46 Abbildung 53: Währungscodes...47 II

5 Über diese Dokumentation Diese Dokumentation beschreibt die Funktionsweise des ClickandBuy Sessionmanagement und hilft Anbietern bei der Anbindung sowie bei der Pflege der über ClickandBuy bepreisten digitalen Inhalte. Zielgruppe Diese Dokumentation richtet sich an Anbieter und Entwickler, die das ClickandBuy Sessionmanagement implementieren möchten. Grundlegende Programmierkenntnisse werden dabei vorausgesetzt. 1

6 1 Das ClickandBuy Sessionmanagement Das ClickandBuy Sessionmanagement wird grundsätzlich in den Fällen verwendet, in denen digitaler Inhalt für einen kurzen Zeitraum gegen Gebühr veröffentlicht bzw. zugänglich gemacht werden soll. Mit anderen Worten lassen sich über das Sessionmanagement Dateien (wie z.b. Musikdateien, Dokumente etc) bepreisen, wobei der Zugriff oder Download zeitlich begrenzt ist. 1.1 Wie funktioniert es? Das ClickandBuy Sessionmanagement basiert auf der sog. Rewrite Engine. Bei einem Kauf über ClickandBuy wird der zu bepreisende Inhalt vom Anbietersystem geladen, auf dem ClickandBuy Proxyserver umgeschrieben und dort an den bezahlenden Kunden ausgeliefert. Da sich der Kunde bei Auslieferung auf der Premiumlinkdomain und nicht auf dem Anbietersystem befindet wird in diesem Zusammenhang auch vom Premiuminhalt gesprochen. Der Kunde befindet sich nach dem Kauf so lange auf dem ClickandBuy System, bis er einen Link anwählt, der Ihn außerhalb des Premiuminhalts führt bzw. der auf Inhalt führt, der nicht als Premiuminhalt definiert wurde. Der Kauf des Inhalts wird initiiert, indem der potenzielle Käufer auf einen Kauflink (auch Premiumlink genannt) geführt wird. Dieser Kauflink leitet den Kunden zu den Bezahlseiten von ClickandBuy, auf denen sich der Kunde in einem ersten Schritt entweder neu registrieren kann oder, soweit er dies bereits vorher einmal getan hat, sich mit seinem ClickandBuy Benutzernamen und Passwort einloggen kann. Nach einer kurzen Auflistung des zu kaufenden Angebots muss der Kunde die Zahlung bestätigen und wird dann sofort auf den für den Premiumlink festgelegten Inhalt geführt, der wie oben erläutert über die ClickandBuy Rewrite Engine umgeschrieben wird. Möchte der Kunde nach einer bestimmten Zeit abermals auf den Inhalt zugreifen beginnt er den Kaufprozess von vorn. Sofern die für den Sessionlink gültige und vom Anbieter vergebene Zugriffszeit noch nicht abgelaufen ist erkennt das ClickandBuy System den Kunden als Käufer und leitet Ihn ohne Zahlungsauslösung auf den Inhalt weiter. Ist die Session jedoch bereits abgelaufen wird der Kunde zu einer erneuten Zahlung aufgefordert. 2

7 1.2 Anforderungen an das Anbietersystem Um das ClickandBuy Sessionmanagement verwenden zu können benötigen Sie als Minimalanforderung einen ClickandBuy Anbieteraccount und Webspace, auf dem der zu verkaufende Inhalt gehostet ist. Eine Datenbank oder das Vorhandensein einer Skriptsprache wie z.b. PHP ist nicht zwingend erforderlich. Damit das Sessionmanagement reibungslos funktioniert müssen bestimmte Vorkehrungen getroffen werden: Der digitale Inhalt muss in einem gesonderten Ordner liegen, d.h. er darf nicht mit freiem bzw. kostenlosem Content vermischt sein. Der sog. Premiuminhalt darf einzig über ClickandBuy erreichbar sein. Kein externer Link darf auf diesen Ordner führen, ansonsten ist eine fehlerfreie Abrechnung der Käufe über ClickandBuy nicht möglich. Um den Ordner vor unerlaubtem Zugriff zu schützen muss er mittels htaccess oder IIS gesichert werden. Premiumlinks müssen generell auf eine absolute Inhalt-URL führen. Das bedeutet, dass alle Links, die Sie innerhalb eines Premiuminhalts verwenden, mit absolutem Pfad angegeben sein müssen. Ein einfaches Beispiel einer voll funktionsfähigen.htaccess-datei sieht folgendermaßen aus: #.htaccess datei für apache server # erlaubt nur Zugriffe über den ClickandBuy Proxyserver order deny,allow deny from all allow from

8 2 Erstellung und Konfiguration von Sessionlinks In diesem Kapitel wird die Konfiguration eines Sessionlinks erläutert und deren Integration bzw. Verwendung beschrieben. Dabei wird zwischen vier elementaren Verwendungsformen unterschieden: Bepreisen von einzelnen Dateien, Bepreisen eines gesamten Verzeichnisses, einzelnes Bepreisen von Dateien eines Verzeichnisses zum Einheitspreis und einzelnes Bepreisen von Dateien eines Verzeichnisses zu dynamischen Preisen. Auch wenn auf den ersten Blick keine gravierenden Differenzen zu erkennen sein mögen bedarf es je einer unterschiedlichen Premiumlinkkonfiguration sowie Integration auf den Anbieterseiten. Durch die Verwendung des sog. Experten-Modus sind die letzten beiden Varianten anspruchsvoller in der Integration, unterstützen jedoch durch einen dynamischen Aufbau die einfache Verwaltung von vielen einzelnen Dateien bzw. Produkten. Wenn Sie viele Dateien verkaufen möchten und stets neue Angebote dazukommen werden lohnt sich die anspruchsvolle Anbindung durch den Experten-Modus. Bei einer sich nicht ändernden überschaubaren Anzahl von zu verkaufenden Dokumenten lohnt sich tendenziell die einfache Anbindung ohne Experten-Modus. 2.1 Bepreisen von einzelnen Dateien Die einfachste Anwendung eines Sessionlinks ist das Bepreisen eines einzelnen Dokuments. Stellen Sie bitte sicher, dass jede Datei unter Berücksichtigung der in Kapitel 1.2 aufgeführten Anforderungen auf Ihrem Webserver hinterlegt ist. Das ClickandBuy System ist nicht für die Verwaltung von Hunderten von Premiumlinks ausgelegt. Wenn Sie eine große und wachsende Anzahl an zu verkaufenden Dokumenten haben verwenden Sie bitte den Experten-Modus (vgl. Kapitel 2.3 und 2.4), anstatt für jedes Dokument einen eigenen Premiumlink anzulegen. Sie ersparen sich damit nicht zuletzt Zeit und Arbeit, denn das Anlegen neuer Links ist bei Verwendung des Experten-Modus nur in Ausnahmefällen notwendig. Hinweis 4

9 2.1.1 Sessionlink erstellen Loggen Sie sich zunächst in Ihren Anbieteraccount ein und legen Sie eine neue Domain an, sofern Sie noch keine haben. Klicken Sie nun unter Angebotsverwaltung Übersicht Linkliste, um die Maske zur Generierung eines neuen Sessionlinks zu erhalten. Abbildung 1: Neuen Link einrichten Sofern Sie bereits einen oder mehrere Links erstellt haben befindet sich die Eingabemaske am unteren Ende der Linkliste. Hinweis Dabei haben die einzelnen Optionen folgende Bedeutung: Name Erläuterung aktivieren Setzen Sie diese Checkbox, damit der Link gekauft werden kann. Der Kaufversuch eines nicht aktivierten Links führt zu einer Fehlermeldung. Link Dies ist die URL bzw. Adresse des zu bepreisenden Inhaltes. Name Geben Sie hier den Namen des Produkts ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Info Geben Sie hier einen kleinen Infotext ein, der dem Kunden ebenfalls auf den Bezahlseiten angezeigt wird. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 2: Link einrichten- Details 5

10 2.1.2 Sessionlink integrieren und Integration testen Ein Klick auf [Speichern] legt den Sessionlink an und führt Sie in die Übersicht Linkliste zurück. Um Ihren Sessionlink zu testen müssen Sie Ihren individuellen Premiumlink in Ihrem Browser aufrufen und einen Testkauf durchführen. Den Premiumlink erhalten Sie, indem Sie auf [Link einbauen] klicken. Es öffnet sich ein Popup Fenster, in dem Sie entweder unter Punkt 1. Standardlink den Premiumlink einzeln erhalten oder unter 2. Comfortlink einen vorgefertigten HTML- Code finden. Für den Test kopieren Sie bitte einfach den Premiumlink, fügen diesen in einem neuen Browserfenster ein und laden diese URL. Abbildung 3: Link einbauen Auf den ClickandBuy Bezahlseiten registrieren Sie sich kostenlos als Käufer und tragen Ihren Benutzernamen oder Ihre Kundennummer in die Mitarbeitergruppe Ihres Anbieteraccounts unter [Angebotsverwaltung-> Zugriffsverwaltung-> Mitarbeiter] ein: 6

11 Abbildung 4: Mitarbeitergruppe Befindet sich Ihr Käuferkonto in der Mitarbeitergruppe, so sind sessionbasierte Käufe und Abonnementabschlüsse kostenlos. Diese Käufe werden nicht verbucht und es werden keine BDRs (Billing Detail Records) erstellt. Hinweis Nachdem Sie Zugriff auf das Dokument erhalten haben ist der Test beendet. Nun müssen Sie nur noch den Sessionlink auf Ihrer Homepage einfügen und Ihren Kunden als Kauflink anbieten. ACHTUNG: In der Regel muss Ihre Domain erst freigeschaltet, d.h. der Testmodus deaktiviert werden. Solange dies nicht geschehen ist kann kein Kunde den Kauf abschließen. Bitte nehmen Sie für die Freischaltung der Domain Kontakt mit dem ClickandBuy Anbieter Support auf. Hinweis 7

12 2.1.3 Beispiel In diesem kleinen Beispiel möchte der Anbieter eine Datei dokument.pdf anbieten. Diese Datei soll über die Homepage herunterzuladen sein. Das Dokument soll direkt nach dem Kauf heruntergeladen bzw. je nach Kundenbrowser angezeigt werden. Die Zugriffszeit, in welcher der Kunde wiederholten Zugriff haben soll beträgt 2 Stunden, der Preis des Dokumentes beträgt 1,99 EUR. Beispiel Die Dateneingabe während der Linkkonfiguration sieht dann wiefolgt aus: Abbildung 5: Beispiel - Link einrichten 8

13 2.1.4 Dokumentierte Fehler Dieses Unterkapitel gibt Ihnen einen kleinen Überblick über die häufigsten Fehlermeldungen, denen Sie während Ihrer Tests oder während des Betriebes Ihrer ClickandBuy Sessionmanagementintegration begegnen können HTTP 404 Datei nicht gefunden Abbildung 6: Fehlermeldung HTTP Datei nicht gefunden Die ZielURL kann von unserem Proxyserver nicht gefunden und aufgerufen werden. Überprüfen Sie, ob der für den Sessionlink hinterlegte Link korrekt und erreichbar ist. Ändern Sie ggf. die URL oder kopieren Sie den Inhalt an die hinterlegte Adresse. Die Fehlermeldung kann auch dann erscheinen, nachdem der Abonnent auf die InhaltURL geleitet wurde und dort auf einen weiteren Link geklickt hat. Dies bedeutet ebenfalls, dass der ClickandBuy Proxyserver die angegebene Seite nicht finden kann bzw. keinen Zugriff auf diese Seite hat. Beachten Sie zudem, dass die Links im Premiumbereich stets mit absoluten Pfaden angegeben werden müssen, da sonst die verwendete Rewrite Engine nicht mehr korrekt arbeitet. Hinweis 9

14 Testbetrieb Abbildung 7: Fehlermeldung Testbetrieb Diese Fehlermeldung zeigt Ihnen, dass der von Ihnen verwendete Käuferaccount nicht in die Testgruppe eingetragen wurde. Diese Fehlermeldung wird allen Kunden angezeigt, die versuchen, ein Angebot einer noch nicht freigegebenen Domain zu kaufen. Tragen Sie den Usernamen oder die Kundenreferenznummer des Käuferkontos in die Mitarbeitergruppe ein (vgl. Kapitel 2.1.2) Das von Ihnen angewählte Angebot Abbildung 8: Fehlermeldung "Das von Ihnen angewählte Angebot..." Der Sessionlink ist nicht aktiviert oder wurde gelöscht. Überprüfen Sie, ob Sie den richtigen Premiumlink aufgerufen haben bzw. ob dieser noch existiert und aktiviert ist. 10

15 2.2 Bepreisen eines gesamten Verzeichnisses Dieses Bepreisungsmodell ist dann sinnvoll, wenn der Anbieter den Zugriff auf ein ganzes Verzeichnis bepreist und die einzelnen darin enthaltenen Dateien als Paket und nicht einzeln veräußern will. Der Käufer bezahlt einmal und kann innerhalb seiner Session beliebig oft auf die im Verzeichnis enthaltenen Dateien zugreifen. Stellen Sie bitte zunächst sicher, dass das zu bepreisende Verzeichnis unter Berücksichtigung der in Kapitel 1.2 aufgeführten Anforderungen auf Ihrem Webserver erreichbar ist. Im Verzeichnis sollte eine Navigationsseite existieren, auf der die Links zu den einzelnen Dokumenten bzw. Dateien aufgeführt sind (absolute Pfade verwenden). Die Dateien müssen sich alle im selben Ordner befinden Sessionlink erstellen Loggen Sie sich zunächst in Ihren Anbieteraccount ein und legen Sie eine neue Domain an, sofern Sie noch keine haben. Klicken Sie nun unter Angebotsverwaltung Übersicht Linkliste, um die Maske zur Generierung eines neuen Sessionlinks zu erhalten. Abbildung 9: Neuen Link Einrichten 11

16 Sofern Sie bereits einen oder mehrere Links erstellt haben befindet sich die Eingabemaske am unteren Ende der Linkliste. Hinweis Dabei haben die einzelnen Optionen folgende Bedeutung: Name Erläuterung aktivieren Setzen Sie diese Checkbox, damit der Link gekauft werden kann. Der Kaufversuch eines nicht aktivierten Links führt zu einer Fehlermeldung. Link Dies ist die URL bzw. Adresse des zu bepreisenden Inhaltes. Name Geben Sie hier den Namen des Produkts ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Info Geben Sie hier einen kleinen Infotext ein, der dem Kunden ebenfalls auf den Bezahlseiten angezeigt wird. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 10: Link einrichten- Details Geben die unter Link die URL der Navigationsdatei an. Dies bewirkt, dass der Käufer nach der Zahlungsbestätigung auf die Navigationsseite geführt wird und die einzelnen Links zu den Dokumenten anklicken kann. Da die Dateien im selben Verzeichnis liegen führen alle diese Links in den selben und schon bezahlten Premiumbereich. Daher wird der Käufer während der offenen Kaufsession nicht erneut zur Bezahlung aufgefordert. Führt ein Link aus dem Premiumbereich heraus bzw. befindet sich das verlinkte Dokument in einem anderen Ordner, so wird der Kunde erneut zum Kaufen aufgefordert. Hinweis 12

17 2.2.2 Sessionlink integrieren und Integration testen Ein Klick auf [Speichern] legt den Sessionlink an und führt Sie in die Übersicht Linkliste zurück. Um Ihren Sessionlink zu testen müssen Sie Ihren individuellen Premiumlink in Ihrem Browser aufrufen und einen Testkauf durchführen. Den Premiumlink erhalten Sie, indem Sie auf [Link einbauen] klicken. Es öffnet sich ein Popup Fenster, in dem Sie entweder unter Punkt 1. Standardlink den Premiumlink einzeln erhalten oder unter 2. Comfortlink einen vorgefertigten HTML- Code finden. Für den Test kopieren Sie bitte einfach den Premiumlink, fügen diesen in einem neuen Browserfenster ein und laden diese URL. Abbildung 11: Link einbauen Auf den ClickandBuy Bezahlseiten registrieren Sie sich kostenlos als Käufer und tragen Ihren Benutzernamen oder Ihre Kundennummer in die Mitarbeitergruppe Ihres Anbieteraccounts unter [Angebotsverwaltung-> Zugriffsverwaltung-> Mitarbeiter] ein: 13

18 Abbildung 12: Mitarbeitergruppe Befindet sich Ihr Käuferkonto in der Mitarbeitergruppe, so sind sessionbasierte Käufe und Abonnementabschlüsse kostenlos. Diese Käufe werden nicht verbucht und es werden keine BDRs (Billing Detail Records) erstellt. Hinweis Nachdem Sie Zugriff auf das Dokument erhalten haben ist der Test beendet. Nun müssen Sie nur noch den Sessionlink auf Ihrer Homepage einfügen und Ihren Kunden als Kauflink anbieten. ACHTUNG: In der Regel muss Ihre Domain erst freigeschaltet, d.h. der Testmodus deaktiviert werden. Solange dies nicht geschehen ist kann kein Kunde den Kauf abschließen. Bitte nehmen Sie für die Freischaltung der Domain Kontakt mit dem ClickandBuy Anbieter Support auf. Hinweis Beispiel In diesem Beispiel möchte der Anbieter mehrere Dateien dokument1.pdf, dokument2.pdf, dokument3.pdf usw. anbieten. Diese Dateien sollen über die Homepage herunterzuladen sein. Der Käufer soll nicht jedes Dokument einzeln kaufen müssen sondern erhält nach einmaliger Bezahlung den Zugriff auf alle Dokumente, die er dann einzeln und nach Belieben herunterladen kann. Beispiel Hierfür wird ein Verzeichnis sammlung angelegt und darin eine Navigationsdatei index.html erstellt. Diese enthält den nötigen HTML Code, um Links zu den einzelnen Dokumentendateien anzeigen zu lassen. Die Dokumente werden ebenfalls im Verzeichnis hinterlegt. Ein Auszug aus der index.html könnte so aussehen: <a href= >Dokument1</a><br> <a href= >Dokument2</a><br> 14

19 Die Zugriffszeit, in welcher der Kunde wiederholten Zugriff haben soll beträgt 2 Tage, der Preis der Dokumentensammlung beträgt 15,99 EUR. Als Link URL wird die Adresse der Navigationsdatei index.html angegeben: Abbildung 13: Beispiel - Link einrichten Dokumentierte Fehler Dieses Unterkapitel gibt Ihnen einen kleinen Überblick über die häufigsten Fehlermeldungen, denen Sie während Ihrer Tests oder während des Betriebes Ihrer ClickandBuy Sessionmanagementintegration begegnen können. 15

20 HTTP 404 Datei nicht gefunden Abbildung 14: Fehlermeldung HTTP Datei nicht gefunden Die ZielURL kann von unserem Proxyserver nicht gefunden und aufgerufen werden. Überprüfen Sie, ob der für den Sessionlink hinterlegte Link korrekt und erreichbar ist. Ändern Sie ggf. die URL oder kopieren Sie den Inhalt an die hinterlegte Adresse. Die Fehlermeldung kann auch dann erscheinen, nachdem der Abonnent auf die InhaltURL geleitet wurde und dort auf einen weiteren Link geklickt hat. Dies bedeutet ebenfalls, dass der ClickandBuy Proxyserver die angegebene Seite nicht finden kann bzw. keinen Zugriff auf diese Seite hat. Beachten Sie zudem, dass die Links im Premiumbereich stets mit absoluten Pfaden angegeben werden müssen, da sonst die verwendete Rewrite Engine nicht mehr korrekt arbeitet. Hinweis 16

21 Testbetrieb Abbildung 15: Fehlermeldung Testbetrieb Diese Fehlermeldung zeigt Ihnen, dass der von Ihnen verwendete Käuferaccount nicht in die Testgruppe eingetragen wurde. Diese Fehlermeldung wird allen Kunden angezeigt, die versuchen, ein Angebot einer noch nicht freigegebenen Domain zu kaufen. Tragen Sie den Usernamen oder die Kundenreferenznummer des Käuferkontos in die Mitarbeitergruppe ein (vgl. Kapitel 2.1.2) Das von Ihnen angewählte Angebot Abbildung 16: Fehlermeldung "Das von Ihnen angewählte Angebot..." Der Sessionlink ist nicht aktiviert oder wurde gelöscht. Überprüfen Sie, ob Sie den richtigen Premiumlink aufgerufen haben bzw. ob dieser noch existiert und aktiviert ist. 17

22 2.3 Bepreisen von Dateien (Experten-Modus) Sollen innerhalb eines Verzeichnisses viele gleichartige und vor allem gleichpreisige Dokumente vertrieben werden ist es äußerst mühsam, für jedes Dokument einen eigenen Premiumlink anzulegen. Auch wenn neue Dokumente im Laufe der Zeit dazustoßen muss stets ein neuer Premiumlink erzeugt werden. Alternativ bietet es sich an, einen Premiumlink im Experten-Modus zu verwenden. Dieser einzelne Link kann dann für alle Dokumente innerhalb des Verzeichnisses benutzt werden und muss auch nicht verändert werden, wenn neue Dokumente dazukommen. Die Idee hinter dem Experten-Modus ist die Verwendung eines Musters (engl. pattern ), welches in jedem aufgerufenen Premiumlink enthalten sein muss. Ist dies der Fall wird der für das Pattern festgelegte Preis berechnet. Das Muster ist in Form eines regulären Ausdrucks anzugeben und ist demnach eine Zeichenfolge. Es muss im Dateinamen oder im Query String des Premiumlinks enthalten sein. Wird ein bereits gekauftes Dokument innerhalb der Sessionzeit erneut gekauft erkennt ClickandBuy die offene Session und leitet den Kunden wie erwartet auf den jeweiligen Inhalt weiter. Ist das Dokument ein anderes als das bereits gekaufte wird eine neue Bezahlung angestoßen, obwohl die beiden Dokumente im selben Verzeichnis liegen und über den selben Premiumlink gekauft werden. Für ein lücken- und reibungsloses Funktionieren ist es erforderlich, dass das Pattern des Experten-Modus auf alle im Verzeichnis enthaltenen Dokumente zutrifft. Die als Muster angegebene Zeichenfolge muss demnach in allen Dokumentennamen (bzw. im Query String) enthalten sein. Andernfalls wird der Kunde das Dokument ohne Bezahlung erhalten. Hinweis Sessionlink erstellen Loggen Sie sich zunächst in Ihren Anbieteraccount ein und legen Sie eine neue Domain an, sofern Sie noch keine haben. Klicken Sie nun unter Angebotsverwaltung Übersicht Linkliste, um die Maske zur Generierung eines neuen Sessionlinks zu erhalten. 18

23 Abbildung 17: Neuen Link Einrichten Sofern Sie bereits einen oder mehrere Links erstellt haben befindet sich die Eingabemaske am unteren Ende der Linkliste. Hinweis Dabei haben die einzelnen Optionen folgende Bedeutung: Name Erläuterung aktivieren Setzen Sie diese Checkbox, damit der Link gekauft werden kann. Der Kaufversuch eines nicht aktivierten Links führt zu einer Fehlermeldung. Link Dies ist die URL bzw. Adresse des zu bepreisenden Inhaltes. Name Geben Sie hier den Namen des Produkts ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Info Geben Sie hier einen kleinen Infotext ein, der dem Kunden ebenfalls auf den Bezahlseiten angezeigt wird. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 18: Link einrichten- Details Geben Sie unter Link die URL des Verzeichnisses an, in dem sich die Dokumente befinden (z.b. Setzen Sie den Preis unbedingt auf 0. Damit das im Experten-Modus zu definierende Pattern greifen kann muss der Ordner mit 0 EUR (oder andere Währung) bepreist werden. Dies ergibt sich aus den simplen Anforderungen des Bepreisungsmodells: der Zugang zum Verzeichnis soll nichts kosten, lediglich die einzelnen Dokumente sind zu bezahlen. 19

24 Abbildung 19: Sessionlink bearbeiten - Experten-Modus Klicken Sie nun auf [Experten-Modus], um das Muster angeben zu können. Abbildung 20: Experten-Modus 20

25 Die einzelnen Optionen haben folgende Bedeutung: Name Erläuterung Neue URL Setzen Sie diese Checkbox, damit das Pattern aktiviert wird. Ein nicht aktiviertes Pattern kann nicht benutzt werden. Pattern Geben Sie die Zeichenfolge an, die als Muster gelten soll. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Name Geben Sie hier den Namen des Pattern ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 21: Experten-Modus-Feldbeschreibung Das Pattern könnte z.b. wie eines der drei einfachen folgenden Muster aussehen: (.*)mp3(.*).pdf dokument Stellen Sie sicher, dass alle im Verzeichnis liegenden Dokumente mit dem Pattern abgedeckt sind. Hinweis Sessionlink integrieren und Integration testen Ein Klick auf [Speichern] legt das Pattern im Experten-Modus an. Klicken Sie anschließend auf [Linkliste], um auf die Übersicht Linkliste zurückzukehren. Um Ihren Sessionlink zu testen müssen Sie Ihren individuellen Premiumlink in Ihrem Browser aufrufen und einen Testkauf durchführen. Den Premiumlink erhalten Sie, indem Sie auf [Link einbauen] klicken. Es öffnet sich ein Popup Fenster, in dem Sie entweder unter Punkt 1. Standardlink den Premiumlink einzeln erhalten oder unter 2. Comfortlink einen vorgefertigten HTML- Code finden. Für den Test kopieren Sie bitte einfach den Premiumlink und fügen diesen in einem neuen Browserfenster ein. Da der Premiumlink jedoch nur für das Verzeichnis konfiguriert ist müssen Sie nun noch den Namen eines Dokuments anhängen. Erst dann rufen Sie die URL auf. Der Premiumlink sieht also beispielsweise so aus: 21

26 Abbildung 22: Link einbauen Auf den ClickandBuy Bezahlseiten registrieren Sie sich kostenlos als Käufer und tragen Ihren Benutzernamen oder Ihre Kundennummer in die Mitarbeitergruppe Ihres Anbieteraccounts unter [Angebotsverwaltung-> Zugriffsverwaltung-> Mitarbeiter] ein: Abbildung 23: Mitarbeitergruppe Befindet sich Ihr Käuferkonto in der Mitarbeitergruppe, so sind sessionbasierte Käufe und Abonnementabschlüsse kostenlos. Diese Käufe werden nicht verbucht und es werden keine BDRs (Billing Detail Records) erstellt. Hinweis Nachdem Sie Zugriff auf das Dokument erhalten haben ist der Test beendet. Nun müssen Sie nur noch den Sessionlink auf Ihrer Homepage einfügen und Ihren Kunden als Kauflink anbieten. Sie verwenden dabei stets den selben Premiumlink, benutzen ihn jedoch jeweils mit einem anderen Dokumentennamen. ACHTUNG: In der Regel muss Ihre Domain erst freigeschaltet, d.h. der Testmodus deaktiviert werden. Solange dies nicht geschehen ist kann kein Kunde den Kauf abschließen. Bitte nehmen Sie für die Freischaltung der Domain Kontakt mit dem ClickandBuy Anbieter Support auf. Hinweis 22

27 2.3.3 Beispiel In diesem Beispiel möchte der Anbieter mehrere Dateien dokument1.pdf, dokument2.pdf, dokument3.pdf usw. anbieten. Diese Dateien sollen über die Homepage herunterzuladen sein. Der Käufer soll jedes Dokument, die alle den selben Preis besitzen, einzeln kaufen können. Hierfür wird ein Verzeichnis verzeichnis angelegt und darin die einzelnen Dokumente kopiert. Beispiel Die Zugriffszeit, in welcher der Kunde wiederholten Zugriff auf die einzelnen Dateien haben soll beträgt 2 Tage, der Preis pro Dokument beträgt 2,00 EUR. 1. Als Link URL wird die Adresse des Verzeichnisses angegeben, der Preis des Verzeichnisses beträgt 0 EUR: Abbildung 24: Beispiel - Link erstellen 2. Da alle Dokumente dem Muster folgen, das Dateinamensuffix pdf zu besitzen wird das Pattern durch die Zeichenfolge pdf angegeben, der Preis beträgt 2,00 EUR und die Sessionzeit wird mit 2 Stunden analog zu den Verzeichniseinstellungen festgelegt: 23

28 Abbildung 25: Beispiel - Pattern anlegen Dokumentierte Fehler Dieses Unterkapitel gibt Ihnen einen kleinen Überblick über die häufigsten Fehlermeldungen, denen Sie während Ihrer Tests oder während des Betriebes Ihrer ClickandBuy Sessionmanagementintegration begegnen können HTTP 404 Datei nicht gefunden Abbildung 26: Fehlermeldung HTTP Datei nicht gefunden 24

29 Die ZielURL kann von unserem Proxyserver nicht gefunden und aufgerufen werden. Überprüfen Sie, ob der für den Sessionlink hinterlegte Link korrekt und erreichbar ist. Ändern Sie ggf. die URL oder kopieren Sie den Inhalt an die hinterlegte Adresse. Die Fehlermeldung kann auch dann erscheinen, nachdem der Abonnent auf die InhaltURL geleitet wurde und dort auf einen weiteren Link geklickt hat. Dies bedeutet ebenfalls, dass der ClickandBuy Proxyserver die angegebene Seite nicht finden kann bzw. keinen Zugriff auf diese Seite hat. Beachten Sie zudem, dass die Links im Premiumbereich stets mit absoluten Pfaden angegeben werden müssen, da sonst die verwendete Rewrite Engine nicht mehr korrekt arbeitet. Hinweis Testbetrieb Abbildung 27: Fehlermeldung Testbetrieb Diese Fehlermeldung zeigt Ihnen, dass der von Ihnen verwendete Käuferaccount nicht in die Testgruppe eingetragen wurde. Diese Fehlermeldung wird allen Kunden angezeigt, die versuchen, ein Angebot einer noch nicht freigegebenen Domain zu kaufen. Tragen Sie den Usernamen oder die Kundenreferenznummer des Käuferkontos in die Mitarbeitergruppe ein (vgl. Kapitel 2.1.2). 25

30 Das von Ihnen angewählte Angebot Abbildung 28: Fehlermeldung "Das von Ihnen angewählte Angebot..." Der Sessionlink ist nicht aktiviert oder wurde gelöscht. Überprüfen Sie, ob Sie den richtigen Premiumlink aufgerufen haben bzw. ob dieser noch existiert und aktiviert ist Der Preis wird mit kostenlos angegeben Abbildung 29: Kostenloser Preis Der aufgerufene Premiumlink passt in kein definiertes Muster, weshalb standardmäßig der Preis des übergeordneten Verzeichnisses ausgewählt wird, welches bei 0 liegen muss. Überprüfen Sie das im Expertenmodus hinterlegte Pattern und stellen Sie sicher, dass jedes Dokument damit abgedeckt wird. 26

31 2.4 Bepreisen von Dateien zu dynamischen Preisen (Experten-Modus) Sollen innerhalb eines Verzeichnisses viele Dokumente verschiedener Preiskategorien oder Dateitypen vertrieben werden ist es nahezu unmöglich, für jedes Dokument einen eigenen Premiumlink anzulegen. Aus diesem Grund bietet es sich an, einen Premiumlink im Experten-Modus zu verwenden. Dieser einzelne Link kann dann für alle Dokumente innerhalb des Verzeichnisses benutzt werden und muss auch nicht verändert werden, wenn neue Dokumente dazukommen. Die generelle Idee hinter dem Experten-Modus ist die Verwendung eines Musters (engl. pattern ), welches in jedem aufgerufenen Premiumlink enthalten sein muss. Ist dies der Fall wird der für das Pattern festgelegte Preis berechnet. Existieren mehrere Preiskategorien oder mehrere Gruppen von Dateien, deren Muster sich unterscheiden, werden mehrere Pattern innerhalb eines Premiumlinks benötigt. Ein solches Muster ist in Form eines regulären Ausdrucks anzugeben und ist demnach eine Zeichenfolge. Es muss im Dateinamen oder im Query String des Premiumlinks enthalten sein. Wird ein bereits gekauftes Dokument innerhalb der Sessionzeit erneut gekauft erkennt ClickandBuy die offene Session und leitet den Kunden wie erwartet auf den jeweiligen Inhalt weiter. Ist das Dokument ein anderes als das bereits gekaufte wird eine neue Bezahlung angestoßen, obwohl die beiden Dokumente im selben Verzeichnis liegen und über den selben Premiumlink gekauft werden. Achtung: Für ein lücken- und reibungsloses Funktionieren ist es erforderlich, dass alle im Verzeichnis enthaltenen Dokumente genau einem Pattern zuordenbar sind. Ein Dokument darf weder mehreren noch gar keinem Muster folgen. Hinweis Sessionlink erstellen Loggen Sie sich zunächst in Ihren Anbieteraccount ein und legen Sie eine neue Domain an, sofern Sie noch keine haben. Klicken Sie nun unter Angebotsverwaltung Übersicht Linkliste, um die Maske zur Generierung eines neuen Sessionlinks zu erhalten. 27

32 Abbildung 30: Neuen Link Einrichten Sofern Sie bereits einen oder mehrere Links erstellt haben befindet sich die Eingabemaske am unteren Ende der Linkliste. Hinweis Dabei haben die einzelnen Optionen folgende Bedeutung: Name Erläuterung aktivieren Setzen Sie diese Checkbox, damit der Link gekauft werden kann. Der Kaufversuch eines nicht aktivierten Links führt zu einer Fehlermeldung. Link Dies ist die URL bzw. Adresse des zu bepreisenden Inhaltes. Name Geben Sie hier den Namen des Produkts ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Info Geben Sie hier einen kleinen Infotext ein, der dem Kunden ebenfalls auf den Bezahlseiten angezeigt wird. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 31: Link einrichten- Details Geben Sie unter Link die URL des Verzeichnisses an, in dem sich die Dokumente befinden (z.b. Setzen Sie den Preis unbedingt auf 0. Damit das im Experten-Modus zu definierende Pattern greifen kann muss der Ordner mit 0 EUR (oder andere Währung) bepreist werden. Dies ergibt sich aus den simplen Anforderungen des Bepreisungsmodells: der Zugang zum Verzeichnis soll nichts kosten, lediglich die einzelnen Dokumente sind zu bezahlen. 28

33 Abbildung 32: Sessionlink bearbeiten - Experten-Modus Klicken Sie nun auf [Experten-Modus], um das erste Muster angeben zu können. Abbildung 33: Experten-Modus 29

34 Die einzelnen Optionen haben folgende Bedeutung: Name Erläuterung Neue URL Setzen Sie diese Checkbox, damit das Pattern aktiviert wird. Ein nicht aktiviertes Pattern kann nicht benutzt werden. Pattern Geben Sie die Zeichenfolge an, die als Muster gelten soll. Preis Hier bestimmen Sie den Preis und die entsprechende Währung des Artikels. Name Geben Sie hier den Namen des Pattern ein. Dieser wird dem Käufer auf den Bezahlseiten und auf den Abrechnungsdokumenten angezeigt. Dauer Dies ist die Sessionzeit, in der ein Käufer die Möglichkeit hat, auf den Inhalt wiederholt zuzugreifen, ohne erneut zur Zahlung aufgefordert zu werden. Abbildung 34: Experten-Modus-Feldbeschreibung Erstellen Sie so viele verschiedene Pattern wie Sie benötigen. Wenn Sie mit Preiskategorien arbeiten ist es aus Gründen der Übersichtlichkeit sinnvoll, den Preis oder einen Bezeichner der Kategorie im Dateinamen zu platzieren. So könnten die Pattern für die Dateinamen dokument_100.pdf, file_200.doc und lied_300.mp3 wiefolgt aussehen: Pattern _100 für Preiskategorie 1 Pattern _200 für Preiskategorie 2 Pattern _300 für Preiskategorie 3 Achten Sie darauf, dass Ihr Pattern nicht fälschlicherweise aufgrund einer zu kurzen Zeichenfolge auf die falschen Dokumente angewendet wird. Ein Muster von nur wenigen Zeichen (z.b. nur einem: 1 ) kann Teil des Dateinamens sein und so dafür sorgen, dass das Dokument zum falschen Preis verkauft wird. Pattern müssen immer eindeutig sein. Hinweis Sessionlink integrieren und Integration testen Ein Klick auf [Speichern] legt das Pattern im Experten-Modus an. Klicken Sie anschließend auf [Linkliste], um auf die Übersicht Linkliste zurückzukehren. Um Ihren Sessionlink zu testen müssen Sie Ihren individuellen Premiumlink in Ihrem Browser aufrufen und einen Testkauf durchführen. Den Premiumlink erhalten Sie, indem Sie auf [Link einbauen] klicken. Es öffnet sich ein Popup Fenster, in dem Sie entweder unter Punkt 1. Standardlink den Premiumlink einzeln erhalten oder unter 2. Comfortlink einen vorgefertigten HTML- Code finden. Für den Test kopieren Sie bitte einfach den Premiumlink und fügen diesen in einem neuen Browserfenster ein. 30

35 Da der Premiumlink jedoch nur für das Verzeichnis konfiguriert ist müssen Sie nun noch den Namen eines Dokuments anhängen. Erst dann rufen Sie die URL auf. Der Premiumlink sieht also beispielsweise so aus: Abbildung 35: Link einbauen Auf den ClickandBuy Bezahlseiten registrieren Sie sich kostenlos als Käufer und tragen Ihren Benutzernamen oder Ihre Kundennummer in die Mitarbeitergruppe Ihres Anbieteraccounts unter [Angebotsverwaltung-> Zugriffsverwaltung-> Mitarbeiter] ein: Abbildung 36: Mitarbeitergruppe Befindet sich Ihr Käuferkonto in der Mitarbeitergruppe, so sind sessionbasierte Käufe und Abonnementabschlüsse kostenlos. Diese Käufe werden nicht verbucht und es werden keine BDRs (Billing Detail Records) erstellt. Hinweis 31

36 Nachdem Sie Zugriff auf das Dokument erhalten haben ist der Test beendet. Nun müssen Sie nur noch den Sessionlink auf Ihrer Homepage einfügen und Ihren Kunden als Kauflink anbieten. Sie verwenden dabei stets den selben Premiumlink, benutzen ihn jedoch jeweils mit einem anderen Dokumentennamen. ACHTUNG: In der Regel muss Ihre Domain erst freigeschaltet, d.h. der Testmodus deaktiviert werden. Solange dies nicht geschehen ist kann kein Kunde den Kauf abschließen. Bitte nehmen Sie für die Freischaltung der Domain Kontakt mit dem ClickandBuy Anbieter Support auf. Hinweis Beispiel In diesem Beispiel möchte der Anbieter mehrere Dateien zu verschiedenen Preisen verkaufen. Alle.pdf-Dokumente sollen 2,00 EUR kosten, alle.mp3-dateien kosten 3,99 EUR. Alle Dateien sollen über die Homepage herunterzuladen sein, die Dokumente liegen alle im Verzeichnis Die Zugriffszeit, in welcher der Kunde wiederholten Zugriff auf die einzelnen Dateien haben soll beträgt 2 Tage. Beispiel 1. Als Link URL wird die Adresse des Verzeichnisses angegeben, der Preis des Verzeichnisses beträgt 0 EUR: Abbildung 37: Beispiel - Link erstellen 32

37 2. Nun wird das erste Pattern pdf angelegt, der Preis beträgt 2,00 EUR und die Sessionzeit wird mit 2 Stunden analog zu den Verzeichniseinstellungen festgelegt: Abbildung 38: Beispiel erstes Pattern anlegen 3. Das zweite Pattern mp3 wird dann erzeugt, wobei der Preis 3,99 EUR und die Sessionzeit abermals 2 Stunden betragen. Abbildung 39: Beispiel zweites Pattern anlegen 33

38 2.4.4 Dokumentierte Fehler Dieses Unterkapitel gibt Ihnen einen kleinen Überblick über die häufigsten Fehlermeldungen, denen Sie während Ihrer Tests oder während des Betriebes Ihrer ClickandBuy Sessionmanagementintegration begegnen können HTTP 404 Datei nicht gefunden Abbildung 40: Fehlermeldung HTTP Datei nicht gefunden Die ZielURL kann von unserem Proxyserver nicht gefunden und aufgerufen werden. Überprüfen Sie, ob der für den Sessionlink hinterlegte Link korrekt und erreichbar ist. Ändern Sie ggf. die URL oder kopieren Sie den Inhalt an die hinterlegte Adresse. Die Fehlermeldung kann auch dann erscheinen, nachdem der Abonnent auf die InhaltURL geleitet wurde und dort auf einen weiteren Link geklickt hat. Dies bedeutet ebenfalls, dass der ClickandBuy Proxyserver die angegebene Seite nicht finden kann bzw. keinen Zugriff auf diese Seite hat. Beachten Sie zudem, dass die Links im Premiumbereich stets mit absoluten Pfaden angegeben werden müssen, da sonst die verwendete Rewrite Engine nicht mehr korrekt arbeitet. Hinweis 34

39 Testbetrieb Abbildung 41: Fehlermeldung Testbetrieb Diese Fehlermeldung zeigt Ihnen, dass der von Ihnen verwendete Käuferaccount nicht in die Testgruppe eingetragen wurde. Diese Fehlermeldung wird allen Kunden angezeigt, die versuchen, ein Angebot einer noch nicht freigegebenen Domain zu kaufen. Tragen Sie den Usernamen oder die Kundenreferenznummer des Käuferkontos in die Mitarbeitergruppe ein (vgl. Kapitel 2.1.2) Das von Ihnen angewählte Angebot Abbildung 42: Fehlermeldung "Das von Ihnen angewählte Angebot..." Der Sessionlink ist nicht aktiviert oder wurde gelöscht. Überprüfen Sie, ob Sie den richtigen Premiumlink aufgerufen haben bzw. ob dieser noch existiert und aktiviert ist. 35

40 Der Preis wird mit kostenlos angegeben Abbildung 43: Kostenloser Preis Der aufgerufene Premiumlink passt in kein definiertes Muster, weshalb standardmäßig der Preis des übergeordneten Verzeichnisses ausgewählt wird, welches bei 0 liegen muss. Überprüfen Sie die im Expertenmodus hinterlegten Pattern und stellen Sie sicher, dass jedes Dokument damit abgedeckt wird. 36

41 3 ClickandBuy Zusatzfunktionen ClickandBuy bietet Ihnen neben diesen grundlegenden Modulfunktionen des Sessionmanagement weitere Features, welche die Arbeit mit ClickandBuy für Sie als Anbieter sowie für den Kunden erleichtern können. Alle hier aufgeführten Features sind optional nutzbar. Das Sessionmanagement ist ohne diese Funktionen voll funktionsfähig. 3.1 Parameterübergabe Um zusätzliche Informationen an das ClickandBuy System zu übermitteln existiert die Möglichkeit, vordefinierte Parameter an den ClickandBuy Premiumlink bzw. in dessen Query String einzufügen. Generell können Sie alle Ihrerseits benötigten Parameter an den Sessionlink anhängen. Diese Parameter werden durch den Kaufprozess durchgereicht und können mit der HTTP GET Methode wieder aufgefangen werden. Andere Parameter werden vom System verwendet und können daher verwendet werden, um z.b. den Preis dynamisch zu übergeben: Name price cb_currency cb_content_name_utf cb_content_info_utf Nation Beschreibung Der Preis des Kaufes in Cent. Nur, sofern die Gebühr entsprechend konfiguriert wurde. Hinweis: Die Funktion der dynamischen Währungsübergabe muss pro Sessionlink vom technischen Anbietersupport von ClickandBuy aktiviert werden. Dreistelliger Währungscode gem. ISO 4217 Hinweis: Die Funktion der dynamischen Währungsübergabe muss pro Sessionlink vom technischen Anbietersupport von ClickandBuy aktiviert werden. Sofern benutzt müssen cb_currency und price als Paar übergeben werden. Eine genaue Auflistung aller Währungen finden Sie im Anhang, Kapitel 4.3 Füllt dynamisch die Felder Name und Info des Links; wird angezeigt auf Bezahlseite und Rechnung. Zweistelliger Nation Code Hinweis: Es existieren Unterschiede zum ISO 3166 (zb. entspricht ISO3166 GB bei ClickandBuy UK). Ggf. müssen Sie die entsprechenden Nationen also noch übersetzen. Eine Auflistung der gültigen Werte finden Sie im Anhang, Kapitel

42 Das ClickandBuy System unterstützt die folgenden Sprachen mit den jeweilig zu verwendenden Parametern: lang cs (Tschechisch) da (Dänisch) de (Deutsch) en (Englisch) es (Spanisch) fi (Finnisch) fr (Französisch) it (Italienisch) nl (Niederländisch) no (Norwegisch) pl (Polnisch) pt (Portugiesisch) sv (Schwedisch) tr (Türkisch) Hinweis: Für nicht-unterstützte Sprachen wird als Standardsprache englisch (en) verwendet. Achten Sie darauf, dass immer Nation und lang zusammen übergeben werden! Abbildung 44: Dynamische Parameterübergabe Eine Liste von verbotenen (da vom System reservierten) Parametern befindet sich im Anhang. HINWEIS Beachten Sie, dass wenn Sie entweder den Preis oder Preis und Währung dynamisch übergeben wollen, diese Parameter vor Manipulation gesichert werden müssen. Da beim Verwenden des Sessionmanagement in der Regel keine Datenbank auf Seiten des Anbieters existiert bzw. die Einbindung dieser die Integration extrem erschwert kann der Erhalt des korrekten Preises nicht auf Anbieterseite gesichert werden. Die Manipulation des Premiumlinks muss also auf Seiten ClickandBuy geschehen, was einzig mittels MD5 Methode geschehen kann (vgl. Kapitel 3.4) Die MD5 Methode ist ebenfalls ein komplexer Vorgang, dessen Einbindung nicht ohne fundierte Kenntnisse in der Webentwicklung zu bewerkstelligen ist. Im Zweifelsfall verwenden Sie vorzugsweise statische Preise in Verbindung mit Pattern, die Ihre Preiskategorien abbilden. Der vom Anbieter übermittelte Query String wird innerhalb des ClickandBuy Bezahlprozesses gänzlich an die InhaltURL übermittelt, damit ggf. die enthaltenen Werte überprüft und in die Anbieterdatenbank gespeichert werden können. An die InhaltURL werden bei jedem Aufruf zudem ClickandBuy eigene Parameter im HTTP Header übermittelt. Die wichtigsten lauten: 38

43 Header-Parameter HTTP_X_BEREICHID HTTP_X_USERIP HTTP_X_GROUPID HTTP_X_USERID HTTP_X_PRICE HTTP_X_ACTUALBDRAMOUNT HTTP_X_CURRENCY HTTP_X_BILLEDAMOUNT HTTP_X_BILLEDCURRENCY REMOTE_ADDR Abbildung 45: Header Parameter Beschreibung LinkID des gekauften Premiumlinks Surfer IP Adresse ID der Benutzergruppe, in der sich der Käufer befindet. ClickandBuy User-ID ClickandBuy Preis (in Millicents!) Aktueller Betrag des BDR, welches durch den Kauf generiert wird. Für diesen Kauf verwendete Währung In Rechnung gestellter Betrag (kann vom eigentlichen Preis abweichen) In Rechnung gestellte Währung (kann von der übergebenen Währung abweichen). ClickandBuy Web Proxy IP Adresse Weitere eindeutige Parameter, die Sie an den Premiumlink anhängen und so das Registrierungsformular für neue ClickandBuy Kunden vorausfüllen können, sind: Name FirstName LastName Company Street HouseNumber ZIP City Phone Gender DateOfBirth Abbildung 46: Registrierungsparameter Beschreibung adresse Vorname Nachname Firma Straße Hausnummer (soweit nicht enthalten in Straße) Postleitzahl Stadt Telefonnummer Anrede des Kunden. Erwartete Werte sind M oder F. Geburtsdatum; kann in den folgenden Formaten übergeben werden: DD/MM/YYYY DD.MM.YYY YYYYDDMM 39

44 3.2 MD5-Verschlüsselung des Premiumlinks Ein Premiumlink kann generell vor Manipulation geschützt werden, indem das MD5 Verfahren aktiviert und verwendet wird. Dies gilt auch für Sessionlinks, jedoch bedarf es hierfür der Konfiguration Ihres Anbieteraccounts seitens ClickandBuy. Setzen Sie sich daher zunächst mit dem Anbieter Support von ClickandBuy in Verbindung, sofern Sie die Funktionalität MD5 überhaupt verwenden wollen. Die Verschlüsselungsmethode mittels MD5 stellt sicher, dass der Premiumlink nicht manipuliert wurde. Dies macht die Überprüfung der Integrität eines Links beim Datenaustausch zwischen zwei Parteien möglich. MD5 ist eine Abkürzung für Message Digest Algorithm 5 und stellt eine weit verbreitete und viel genutzte Verschlüsselungsmethode dar. Die Länge eines Verschlüsselungswertes ( Hash ), der mittles MD5 erstellt wurde, beträgt 128 bit. Der Hashwert wird als 32-stelliger Hexadezimalwert angezeigt, der so aussehen könnte: 34048ce4cd069b624f6e021ba63ecde Wie funktioniert es? MD5 wird üblicherweise dann verwendet, wenn der Anbieter einen dynamischen Preis und eine dynamische Währung übergibt. Das ClickandBuy System vergleicht den vom Anbieter anhand der URL errechneten und an ClickandBuy übergebenen Hashwert mit einem selbst errechneten Wert. Sind diese beiden Werte unterschiedlich, wurde die URL manipuliert, die Transaktion wird so von ClickandBuy blockiert. Hauptaufgabe der MD5-Funktionalität ist also die Manipulationsabwehr des Preises sowie der Währung Einstellung und Verwendung der MD5-Funktionalität Die MD5-Funktionalität benötigt einen geheimen Schlüsselwert ( dynkey ), den der Anbieter frei wählen kann. Dieser dynkey wird in der Linkkonfiguration eines Sessionlinks gespeichert. Nun muss der Anbieter diesen dynkey verwenden, um den MD5 Hashwert zu errechnen und diesen per HTTP GET Parameter fgkey an den Premiumlink anhängen. 40