Interface Gutscheine: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „Interface Gutscheine“) |
|||
(Eine dazwischenliegende Version des gleichen Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | Interface Gutscheine | + | Diese Gutschein-API gibt Ihnen alle Gutscheine (Werbemittel) von Partnerprogrammen aus, für die eine bestehende Partnerschaften existiert. |
+ | |||
+ | Das Interface dient als Schnittstelle zwischen Ihrer Webseite und unserer Datenbank. | ||
+ | Mit Hilfe eines PHP-Scriptes haben Sie so die Möglichkeit schnell und einfach Programme in Ihre Homepage einzubinden. | ||
+ | |||
+ | Der unten angezeigte PHP-Code ist nur ein Beispiel! | ||
+ | Bitte passen Sie diesen ggf. an Ihrer Webseite und Bedürfnisse an. | ||
+ | |||
+ | Um Missbrauch und Serverlasten zu vermeiden haben wir die Anzahl der Anfragen pro Tag und Publisher limitiert. Die Anzahl der Anfragen entnehmen Sie bitte Ihrem Publisheraccount. | ||
+ | |||
+ | <blockquote width=80%; style="background:#f4f4ff; border: 2px solid #999; border-right-width: 2px"> | ||
+ | <code> | ||
+ | <?php<br> | ||
+ | $url="http://www.masterad.de/interface/output_gutscheine1.1.php?aid=&sid=&ipw=&output=xml";<br> | ||
+ | $newfile = simplexml_load_file($url);<br> | ||
+ | foreach($newfile->couponlist as $out)<br> | ||
+ | {<br> | ||
+ | $programid= $out->programid;<br> | ||
+ | $programname= $out->programname;<br> | ||
+ | $couponcategory= $out->couponcategory;<br> | ||
+ | ?> | ||
+ | </code> | ||
+ | </blockquote> | ||
+ | |||
+ | |||
+ | == Eingabewerte == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Variable !! Beschreibung | ||
+ | |- | ||
+ | | aid || Variable für Ihre AffilateID (entspricht der LoginID) | ||
+ | ''Diese Variable darf nur numerisch sein'' | ||
+ | |- | ||
+ | | sid|| Variable für Ihre SeitenID. Die SeitenID (kurz SID) finden Sie unter dem Menüpunkt „Seitenverwaltung“ | ||
+ | ''Die Variable darf nur numerisch sein'' | ||
+ | |- | ||
+ | | ipw || Variable für das Interfacepasswort. Das Interfacepasswort finden Sie unter dem Menüpunkt „Interface“. | ||
+ | ''Die Variable darf nur alphanumerisch sein'' | ||
+ | |- | ||
+ | | output || Wählen Sie das Ausgabeformat der Gutscheine.<br>'''Zur Auswahl stehen: csv, xml''' | ||
+ | |} | ||
+ | |||
+ | |||
+ | == Ausgabewerte CSV == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Variable !! Beschreibung | ||
+ | |- | ||
+ | | programmID || PartnerprogrammID | ||
+ | |- | ||
+ | | Programmname || Partnerprogrammname | ||
+ | |- | ||
+ | | Gutscheinkategorie || Kategorie des Gutscheins | ||
+ | |- | ||
+ | | Gutscheinart || CODE = '''Alphanummerischer Code den der Besucher meist händisch (z.B. Bestellstellvorgang) eintragen muss''',<br>LINK = '''Link zu einer Webseite wo der Bonus meist schon inkludiert ist''' | ||
+ | |- | ||
+ | | Gutscheincode || Gutscheincode ist bei der LINK-Gutscheinart leer | ||
+ | |- | ||
+ | | Gueltig ab || Ab wann kann der Gutschein eingelöst werden | ||
+ | |- | ||
+ | | Gueltig bis || Bis wann ist der Gutschein gültig | ||
+ | |- | ||
+ | | Beschreibung || Ggf. weitere Hinweise / Restriktionen um den Gutschein einlösen zu können | ||
+ | |- | ||
+ | | Trackingcode || Link zur Partnerprogrammprogramm. Dieser Link muss zwingend verwendet werden, da sonst kein sauberes Tracking erfolgen und die Transaktion nicht Ihrem Publisheraccount zugeordnet werden kann. | ||
+ | |} | ||
+ | |||
+ | |||
+ | == Ausgabewerte XML == | ||
+ | |||
+ | {| class="wikitable sortable" | ||
+ | |- | ||
+ | ! Variable !! Beschreibung | ||
+ | |- | ||
+ | | programid || PartnerprogrammID | ||
+ | |- | ||
+ | | programname || Partnerprogrammname | ||
+ | |- | ||
+ | | couponcategory || Kategorie des Gutscheins | ||
+ | |- | ||
+ | | coupontyp || CODE = '''Alphanummerischer Code den der Besucher meist händisch (z.B. Bestellstellvorgang) eintragen muss''',<br>LINK = '''Link zu einer Webseite wo der Bonus meist schon inkludiert ist''' | ||
+ | |- | ||
+ | | couponcode || Gutscheincode ist bei der LINK-Gutscheinart leer | ||
+ | |- | ||
+ | | validfrom || Ab wann kann der Gutschein eingelöst werden | ||
+ | |- | ||
+ | | validto || Bis wann ist der Gutschein gültig | ||
+ | |- | ||
+ | | coupondescription || Ggf. weitere Hinweise / Restriktionen um den Gutschein einlösen zu können | ||
+ | |- | ||
+ | | trackinglink || Link zur Partnerprogrammprogramm. Dieser Link muss zwingend verwendet werden, da sonst kein sauberes Tracking erfolgen und die Transaktion nicht Ihrem Publisheraccount zugeordnet werden kann. | ||
+ | |} |
Aktuelle Version vom 10. Februar 2017, 21:49 Uhr
Diese Gutschein-API gibt Ihnen alle Gutscheine (Werbemittel) von Partnerprogrammen aus, für die eine bestehende Partnerschaften existiert.
Das Interface dient als Schnittstelle zwischen Ihrer Webseite und unserer Datenbank. Mit Hilfe eines PHP-Scriptes haben Sie so die Möglichkeit schnell und einfach Programme in Ihre Homepage einzubinden.
Der unten angezeigte PHP-Code ist nur ein Beispiel! Bitte passen Sie diesen ggf. an Ihrer Webseite und Bedürfnisse an.
Um Missbrauch und Serverlasten zu vermeiden haben wir die Anzahl der Anfragen pro Tag und Publisher limitiert. Die Anzahl der Anfragen entnehmen Sie bitte Ihrem Publisheraccount.
<?php
$url="http://www.masterad.de/interface/output_gutscheine1.1.php?aid=&sid=&ipw=&output=xml";
$newfile = simplexml_load_file($url);
foreach($newfile->couponlist as $out)
{
$programid= $out->programid;
$programname= $out->programname;
$couponcategory= $out->couponcategory;
?>
Eingabewerte
Variable | Beschreibung |
---|---|
aid | Variable für Ihre AffilateID (entspricht der LoginID)
Diese Variable darf nur numerisch sein |
sid | Variable für Ihre SeitenID. Die SeitenID (kurz SID) finden Sie unter dem Menüpunkt „Seitenverwaltung“
Die Variable darf nur numerisch sein |
ipw | Variable für das Interfacepasswort. Das Interfacepasswort finden Sie unter dem Menüpunkt „Interface“.
Die Variable darf nur alphanumerisch sein |
output | Wählen Sie das Ausgabeformat der Gutscheine. Zur Auswahl stehen: csv, xml |
Ausgabewerte CSV
Variable | Beschreibung |
---|---|
programmID | PartnerprogrammID |
Programmname | Partnerprogrammname |
Gutscheinkategorie | Kategorie des Gutscheins |
Gutscheinart | CODE = Alphanummerischer Code den der Besucher meist händisch (z.B. Bestellstellvorgang) eintragen muss, LINK = Link zu einer Webseite wo der Bonus meist schon inkludiert ist |
Gutscheincode | Gutscheincode ist bei der LINK-Gutscheinart leer |
Gueltig ab | Ab wann kann der Gutschein eingelöst werden |
Gueltig bis | Bis wann ist der Gutschein gültig |
Beschreibung | Ggf. weitere Hinweise / Restriktionen um den Gutschein einlösen zu können |
Trackingcode | Link zur Partnerprogrammprogramm. Dieser Link muss zwingend verwendet werden, da sonst kein sauberes Tracking erfolgen und die Transaktion nicht Ihrem Publisheraccount zugeordnet werden kann. |
Ausgabewerte XML
Variable | Beschreibung |
---|---|
programid | PartnerprogrammID |
programname | Partnerprogrammname |
couponcategory | Kategorie des Gutscheins |
coupontyp | CODE = Alphanummerischer Code den der Besucher meist händisch (z.B. Bestellstellvorgang) eintragen muss, LINK = Link zu einer Webseite wo der Bonus meist schon inkludiert ist |
couponcode | Gutscheincode ist bei der LINK-Gutscheinart leer |
validfrom | Ab wann kann der Gutschein eingelöst werden |
validto | Bis wann ist der Gutschein gültig |
coupondescription | Ggf. weitere Hinweise / Restriktionen um den Gutschein einlösen zu können |
trackinglink | Link zur Partnerprogrammprogramm. Dieser Link muss zwingend verwendet werden, da sonst kein sauberes Tracking erfolgen und die Transaktion nicht Ihrem Publisheraccount zugeordnet werden kann. |