Contaxe API PHP Class
09. November 2007 | In: Webservices
Contaxe hat vor einigen Tagen eine XML-Api veröffentlicht, mit der Publisher auf den Bestand an Werbemitteln zugreifen können. Um das aus PHP heraus komfortabel zu bewältigen, habe ich eine Wrapper Class geschrieben, die sämtliche Funktionen der Contaxe-Api kapselt und anhand diverser Beispiele erleutert.
Das besondere an der Contaxe-Api ist, das optional kontextsensitive Werbung ausgeliefert wird, man also kein konkretes Keyword vergeben muß. Dazu wird die Seite von einem Crawler besucht und einem Thema zugeordnet.
Eine weitere sinnvolle Option ist der Backfill. Werden zu einem Keyword 10 Ergebnisse abgefragt, die Datenbank von Contaxe enthält zu dieser Anfrage aber nur 3 Einträge, so kann man optional 7 zufällige Einträge zusätzlich erhalten. Diese sind allerdings nicht mehr kontextsensitiv.
Code
Die simpelste Abfrage besteht aus wenigen Zeilen:
include_once( 'contaxe.class.php' ); $ContaxeApi = new ContaxeApi(); $ContaxeApi->GetTextAds( array( 'query' => 'auto', /// keyword 'len' => 10 /// Anzahl der Ergebnisse ) ); |
Gesucht wird nach dem Keyword “auto”. Es sollen 10 Ergebnisse geliefert werden. Content-Detection ist nicht verlangt und zufälliger Backfill auch nicht.
Die Ergebnisse werden gleich auf dem Screen ausgegeben. Der optionale Parameter ‘print’ steht per Default auf true.
Über die mitgeliferte “contaxe.css” können die Ergebnisse an die eigenen Layout-Wünsche Angepasst werden.
Alle weiteren Methoden verlangen die gleichen Paramater;
$ContaxeApi = new ContaxeApi(); $ContaxeApi->GetTextAds( array(...) ); $ContaxeApi->GetImageAds( array(...) ); $ContaxeApi->GetImageTextAds( array(...) ); $ContaxeApi->GetFlashAds( array(...) ); |
Alle Paramater und deren Default-Werte
Die Namensgebung hat Contaxe verbrochen also bitte bei denen beschweren.
| Name | Type | Default | Beschreibung |
|---|---|---|---|
| query | String | Keyword | |
| len | Integer | 3 | Anzahl der Ergebnisse. Möglich: (1-15) |
| format | Enum | txt | Format der Werbemitte. Möglich: txt, img, imgtxt, flash |
| c | Integer | 2332 | Contaxe-Channel ID |
| cty | Enum | de | Location. Möglich: de,at,ch |
| incharset | String | utf-8 | Codierung der Request-Daten |
| outcharset | String | utf-8 | Codierung der Response-Daten |
| rnd | Boolean | 1 | Zufälliger Backfill. |
| ofs | Integer | 0 | Offset der Ergebnisse |
| tsi | String | Contaxe_API_PHP_Class _VERSION | Sub-ID, bel. belegbar |
| nocrawl | Boolean | 1 | Crawler Aus |
| Name | Type | Default | Beschreibung |
|---|---|---|---|
| default | String | Wird gezeigt, wenn kein Ergebnis | |
| pp | String | <div class=”contaxe_units”> | Prepend HTML |
| ap | String | </div> | Append HTML |
| mask | String | <div class=”contaxe_unit”> <a href=”%s” rel=”nofollow” target=”_blank” class=”contaxe_link”>%s</a> <div class=”contaxe_text”>%s</div> <div class=”contaxe_domain”>%s</div></div></div> | Ergebnismaske |
| Boolean | true | Ausgabe auf Bildschirm | |
| reflink | Boolean | true | Zeige reflink |
Demos:
Image-Werbemittel sind so gut wie nie vorhanden. Sehr oft liefern die Image-Url’s auch einen 404-Error. Fehler wurde von Contaxe behoben.
Flash habe ich noch nicht implementiert, da ich über die API nie Ergebnisse gekommen habe.
Demo aller Werbemitte von Contaxe
Suchbox mit Backfill von Contaxe
Suchbox über Ajax mit Backfill von Contaxe
Werbung von Contaxe mit Content Detection
Download:
Download der Contaxe Api inklusive aller Beispiele: Download v1.0
Die Class benötigt PHP 5 und das Modul SimpleXml.
Die API Class ist ein recht schneller Hack, Verbesserungsvorschläge etc. sind also gerne willkommen und sicherlich nötig.
Links
- Beitrag von: naden
Loading ...
11 Kommentare zu Contaxe API PHP Class
Jenakompakt
23. November 2007 um 12:48:44
Also bzgl. der Contentrelevanz bin ich ein wenig entäuscht.
Wenn das Wort “Geschichte” mit einem Anbieter für Spielautomaten verlinkt wird, scheint die Themennähe nach wie vor nicht wirklich gegeben zu sein.
Ich warte jetzt erstmal auf die ersten Statistiken. Man will ja nicht gleich aufgeben :)
naden
23. November 2007 um 13:29:18
Wenn Jemand für das Keyword diese Anzeige bucht und die Redaktion von Contaxe das approved hat, dann ist das Ergebnis an sich richtig.
Wenn es extrem unpassend erscheint, nennt man das menschliches Versagen ;)
Contaxe Support
24. November 2007 um 17:46:49
Hallo,
und Gratulation zum Contaxe-Adapter. Wir haben Deine Website in den Contaxe-FAQ verlinkt (http://www.contaxe.com/de/faq/affiliates-publisher/#faq-bietet-contaxe-eine-xml-schnittstelle-fuer-affiliates)
Zum Thema “Kontextsensitivität” sollte man Folgendes beachten, insbesondere wenn man den Eindruck hat, die Ergebnisse würden nicht so matchen, wie man sich dies vorstellt:
Contaxe erlaubt in verschiedenster Weise den Eingriff aller Beteiligten in die Werbeschaltung. Der Merchant kann sein Werbeumfeld festlegen, wie er dies möchte. Wenn er der Auffassung ist, dass ein bestimmtes nicht-themenrelevantes Werbeumfeld erfolgsversprechend konvertiert, gibt er auch Keywords ein, die nicht seinem Produkt direkt entsprechen. Dies bedeutet, dass neben der Technologie auch der Mensch aktiv in den Advertisingprozess eingreift.
Dazu kommt, dass der Affiliate dies genauso kann, und, er kann mittels Ausgrenzung einzelner Elemente seiner Website die Werbeplatzierung ebenfalls nochmals beeinflussen.
Last but not least: Contaxe bietet kontextsensitive Werbung UND zufällige Werbung oder verschiedenste Kombinationen davon, je nach Optimierungseinstellung. Der Merchant stellt seine Kampagne in der Regel so ein, dass er den Affiliates die Entscheidung darüber überlässt, wie sie seine Werbung verwenden – ob kontextsensitiv oder nicht.
Wer noch Fragen zu dem Themenkomplex hat – einfach in den Contaxe-ICQ-Live-Support kommen. Da ist fast immer irgend jemand erreichbar, auch am Wochenende, sehr oft sogar Nacht.
Viele Grüsse
Matthias
naden
25. November 2007 um 16:21:57
Hallo Matthias, danke für die Erwähnung. Deine Erklärung zu den verschienden Buchungs-/Einbindungskriterien erleichtert dem einen oder anderen sicher, die interne Funktionalität von Contaxe besser zu verstehen.
Gerald Mann
29. November 2007 um 12:01:48
Hi,
danke für die Hilfestelllung, aber ich habe ähnliche Probleme wie “Jenakompaktâ€Â. Denn außer Ebay-Werbung scheint es nicht sehr viel Thematisch passendes zu geben…
Nun ja warten wir die ersten Statistiken ab.
Grüße aus Münster
Gerald
Jenakompakt
29. November 2007 um 12:58:06
Ich habe die Content-Links wieder entfernt. Meine besucher interessiert eben keine Werbung von Spielautomatenhersteller.
Entsprechend mieß war die Klickrate. Da bleibe ich lieber bei Amazon. Dort bekommt man zwar nur für Sales eine Provision – aber die Einblendungen sind wenigstens passend
naden
29. November 2007 um 13:54:35
Ich habe die Erfahrung gemacht, das zusätzlich zu aller schon vorhandener Werbung mit Contaxe 5% Clickrate rauszuholen sind. Das kommt natürlich stark auf die Zielgrupp und das Layout der Seite an.
micha
11. Oktober 2008 um 03:40:21
Habe mal eine Frage:
ersteinmal lieben Dank für die bereitstellung des Codes.
Meine Frage bezieht sich auf normale textAds … gibt es dort eine möglichkeit die ausgabegröße auch für textads festzulegen. benutze auf meinen webseiten hauptsächlich textads in der größe 234×60
naden
11. Oktober 2008 um 18:54:57
@micha, du kannst die Höhe einfach über die Stylesheet Class contaxe_unit definieren.
micha
12. Oktober 2008 um 01:57:22
@ naden .. habe ich versucht, aber wenn der ad text zu lang ist, dann geht der text nach unten über die css box drüber !! sieht nicht schön aus !
naden
23. Oktober 2008 um 23:48:55
@micha, merkwürdige Sache. Da im CSS an keiner Stelle eine Breite oder Höhe definiert wird, vermute ich, dass das CSS auf deiner Webseite einen Seiteneffekt verursacht.