Interface Gutscheine: Unterschied zwischen den Versionen

Aus MasterAD.de - Wikipedia
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „Interface Gutscheine“)
 
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'''
 +
|}
 +
 
 +
.* Bei Leads und Sales muss noch die Art der Werbeform angegeben werden. Hierfür gibt es die Variable "typ".
 +
 
 +
== 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.
 +
|}

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

.* Bei Leads und Sales muss noch die Art der Werbeform angegeben werden. Hierfür gibt es die Variable "typ".

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.
Von „https://www.masterad.de/wiki/index.php?title=Interface_Gutscheine&oldid=287“