adtago API v1 (DEPRECATED) > DropGate

ACHTUNG: Diese Version der API gilt als veraltert und wurde als DEPRECATED gekennzeichnet.
Bitte wechseln Sie zur neuen adtago API v2.

Dieser Methode prüft ob zu einer übergebenen URL ein Affiliate-Programm existiert und löst im Erfolgsfall das entsprechende Tracking aus. Die Methode sollte ausschließlich in einem versteckten IFRAME ausgelöst werden! Im Erfolgsfall leitet das Tracking auf die Startseite des jeweiligen Affiliate-Anbieters. Ist kein Partnerprogramm vorhanden, wird ein 1x1-Blindpixel ausgeben! Weitere Informationen zum IFRAME finden Sie unter Implementierung.

Request

Request-URL: http://api.adtago.de/DropGate.php?p=[PUBLIC_KEY]&k=[MD5_FINGERPRINT]{&s=[SUBID]} { &url=[URL] | &tld=[TLD_MD5] } { &q=[SEARCH_QUERY] }

Parameter	Beispiel	Beschreibung
[PUBLIC_KEY]	x1234y6789	adtago-Public-Key (siehe Produkte > adtago API)
[MD5_FINGERPRINT]	c5s446e8cswd53s5y459wfxaqg6e2dse	Fingerprint Variante 1 bei Parameter [URL]: MD5-Fingerprint aus URL und adtago-Private-Key: (unkodierte) URL + adtago-Private-Key (direkt aneinander - ohne Trennzeichen!) Beispiel-Code (URL = http://www.otto.de) md5("http://www.otto.deXu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd") Variante 2 bei Parameter [TLD_MD5]: MD5-Fingerprint aus TLD_MD5 und adtago-Private-Key: MD5 + adtago-Private-Key (direkt aneinander - ohne Trennzeichen!) Beispiel-Code (MD5 = 20166ec41731c401a9e4e51a0b003cce) md5("20166ec41731c401a9e4e51a0b003cceXu38sV2u6ZXu38sV2u6ZXu38sV2u6Zrd")
[SUBID]	12345	SubID (OPTIONAL) Ein beliebiger Wert der bei einer Buchung hinterlegt wird. SubIDs dürfen alphanummerisch sein (A-Z und 0-9) und als einzigen Sonderzeichen "-" beinhalten. Die maximale Länge beträgt 20 Zeichen.
[URL]	http%3A%2F%2Fwww.otto.de	URL (URL-kodiert) Beispiel-Code: urlencode("http://www.otto.de")
[TLD_MD5]	20166ec41731c401a9e4e51a0b003cce	MD5 der Toplevel-Domain (OPTIONAL) Beispiel-Code: md5("otto.de") Wichtig: Es muss der MD5 der kleingeschriebenen Top-Level-Domain sein (ohne Sub-Domains etc.): Falsch: http://www.otto.de, www.otto.de, otto.de, OTTO.de Richtig: otto.de Eine fertige PHP-Funktion die Ihnen die Toplevel-Domain im korrekten Format liefert, finden Sie hier.
[SEARCH_QUERY]	M%FCnchen	Such-Query (URL-kodiert) Rein optionaler Parameter, nur für Partner aus dem Bereich Search nötig. Weitere Informationen auf Anfrage.

Beispiel:
Variante 1 (mit URL):
http://api.adtago.de/DropGate.php?p=x1234y6789&k=c5s446e8cswd53s5y459wfxaqg6e2dse&s=12345&url=http%3A%2F%2Fwww.otto.de&q=M%FCnchen
Variante 2 (mit TLD_MD5):
http://api.adtago.de/DropGate.php?p=x1234y6789&k=c5s446e8cswd53s5y459wfxaqg6e2dse&s=12345&tld=20166ec41731c401a9e4e51a0b003cce&q=M%FCnchen

Response

Response wenn Partnerprogramm vorhanden:

Tracking auslösen und Weiterleitung zur Startseite des Affiliate-Anbieters (innerhalb eines Images oder IFRAMES)

Response wenn KEIN Partnerprogramm vorhanden:

Keine Weiterleitung - Ausgabe einer Pixel-Grafik (1x1)

Implementierung

Die Methode "DropGate" eignet sich ideal für Partner die einen eigenen Splash-Screen (=Zwischen-/Weiterleitungsseite) verwenden und auf einfache Weise ein automatisiertes Affiliate-Tracking anbieten möchten. Wie erwähnt erfolgt der Aufruf in einem IFRAME. Nachfolgend zeigen wir Ihnen wie Sie das Tracking unsichtbar implementieren können.

Code-Beispiel für IFRAME

<iframe src="http://api.adtago.de/DropGate.php...." style="width:0px;height:0px;border-width:0px;" id="aoDropFrame"></iframe>

PHP-Beispiel-Code

Die nachfolgende Funktion liefert die Domain inkl. TLD einer beliebigen (Long-)URL. Bei z.B. "http://SUBdomain.Domain.de/Folder/file.html?par1=val1&par2=val2" ist das Ergebnis "domain.de"

function getTLD($x)

                          	{

  if(ereg("\.",$x)===FALSE)

     return;

                          		  $e = strstr($x,'//');

                          		  if($e===FALSE)

                          		    $e = $x;

                          		  else

                          		    $e = substr($e,2);

  $f = spliti('/',$e);

                          		  $e = $f[0];

  $p = split('\.',$e);

                          		  $i = count($p);

  if( $i>2 && ( strcasecmp($p[($i-2)],"co")==0 || strcasecmp($p[($i-2)],"com")==0 || strcasecmp($p[($i-2)],"org")==0 ) )

                          		  {

    if(strlen($p[($i-3)])<1 || strlen($p[($i-2)])>6 || strlen($p[($i-2)])<1 )

                          		      return;

                          		    return $p[($i-3)] . "." . $p[($i-2)] . "." . $p[($i-1)];

                          		  }

                          	  if(strlen($p[($i-2)])<1 || strlen($p[($i-1)])>6 || strlen($p[($i-1)])<1 )

                          		    return;

                          	  return strtolower($p[($i-2)] . "." . $p[($i-1)]);

                          		}

Errors

Code	Meldung	Beschreibung
1000	Insufficient arguments	Mindestens ein Request-Parameter ist leer oder falsch
1001	Unknown API-User	Der adtago-Public-Key ist unbekannt (Parameter "p")
1002	Wrong MD5-Verification	MD5-Verifizierungscode ist falsch (Parameter "k")
1003	API-Quota exceeded	Das maximal verfügbare Abruf-Kontingent für die adtago-API wurde überschritten (Standard = 30.000 Calls). Das Kontingent wird monatlich zurückgesetzt. Falls Sie ein größeres Kontingent benötigen, teilen Sie uns bitte mit wie und wo Sie unsere API verwenden möchten.
1004	To many TLD (max. 20)	Es wurden zu viele Top-Level-Domains übergeben. Pro Call dürfen maximal 20 TLDs übergeben werden.
1005	Wrong request argument: ##ERROR_MSG##	Ein oder mehrere Abfrage-Parameter sind falsch (z.B. falsche Datumsangabe). In ##ERROR_MSG## werden die falschen Angabe aufgezählt.

Beispiel-Error:

<?xml version="1.0"   encoding="ISO8859-1"?>

						<error>

						  <code>1000</code>

						  <msg>Insufficient arguments</msg>

						</error>