Posts Tagged ‘Webservices’

affilinet Webservices – Änderung in ProgramListService WS V1

Wednesday, September 30th, 2009

Im ProgramListService der Version 1 gab es eine Änderung:

Der Partnerschaftsstatus wurde folgendermaßen angepasst:

Noch nicht beworbene Programme werden nun mit dem Status “1″ ausgegeben.

Vorher wurde dieser Status als “0″ geflagged!

http://webservices.affili.net/Publisher/ProgramList.asmx

D.h. Tools, die diesen Status verwenden sollten tunlichst angepasst werden, da ansonsten mit einem fehlerhaften Verhalten zu rechnen ist.

affilinet Publisher Auto Apply Tool Update II

Wednesday, September 30th, 2009

Aufgrund einer Änderung des Webservices für die Abfrage der Programmliste musste Ich wieder mal eine neue Version des Tools erstellen. Im Webservice wurde der Status, welcher die Partnerschaft wiedergibt geändert. Vorher war es so, dass noch nicht beworbene Programme mit “0″ geflagged waren…jetzt ist es “1″.

Die neue Version kann ab sofort unter der selben URL runtergeladen werden wie bisher:

affilinet Publisher Auto Apply Tool: Download

Vielen Dank nochmal an alle für das positive Feedback bei der dmexco!

affilinet Webservices: Komisches Verhalten beim Paging bei Produktdaten

Wednesday, May 20th, 2009

Immer wieder gibt es Probleme beim Paging in Produktdaten wenn die affilinet Webservices verwendet werden. Dies ist ein bei affilinet bekanntes Problem und es wird mit Hochdruck an einer Lösung gearbeitet. Allerdings kann man dieses Problem in gewissen Fällen umgehen:

Wird wie im vorherigen Post beschrieben ein Kategoriebrowsing implementiert, kann man durch das Setzen des Parameters “WithImgOnly” auf ‘false’ ein weitaus besseres Paging realisiert. Anscheinend werden die Produkte ohne Bild nach dem eigentlichen Paging entfernt, so dass man in “einigen” Fällen die Information bekommt, dass X Seiten verfügbar sind, diese aber oft leer zurück gegeben werden. Gleiches trifft auch auf die allgemeine Suche in allen Shops und allen Kategorien zu…wobei das Ergebnis hier nicht ganz so befriedigend ist.

Will man wirklich nur Produkte mit Bild bekommen, sollte man sich momentan wirklich nicht auf ein vernünftiges Paging verlassen…mit Betonung auf “noch”?! ;-)

affilinet Webservices: Kategoriebrowsing in Produktdaten

Wednesday, May 20th, 2009

Entgegen vieler anders lautender Meinungen ist es mit den affilinet Webservices sehr wohl möglich Kategoriebrowsing zu implementieren. Ziel hierbei soll folgendes sein:

- Es wird ein Kategoriebaum dargestellt (Globaler Kategoriebaum von affilinet oder eines speziellen Shops).
- Beim Klick auf eine Kategorie sollen die Produkte dargestellt werden, welche sich in dieser Kategorie befinden.

Die Implementierung hierfür ist sehr simpel:
Es muss nämlich lediglich die Methode “SearchProductsInCategories” genutzt und der Parameter “Keywords” leer gelassen werden! :-)

Hinweis:
Zu beachten ist hierbei wiederum der Unterschied zwischen globalen affilinet und speziellen Shop Kategorien. Welche Kategorien benutzt werden sollen wird über den Parameter “UseAffilinetCategories” gesteuert. Ist dieser ‘false” muss eine Kategorie Id eines speziellen Shops eingegeben werden (Und natürlich die passende ShopId im Parameter “ShopID” gesetzt werden). Wird auf ‘true’ gestellt, muss wiederum eine affilinet Kategorie eingegeben werden und “ShopID” auf ‘0′ gesetzt werden.

affilinet Publisher Auto Apply Tool Update!

Tuesday, May 19th, 2009

Da der Login Prozess seit heute nach erfolgreicher Anmeldung via SignUp Formular auf eine andere Seite weiterleitet, musste Ich leider eine neue Version des affilinet Publisher Auto Apply Tools veröffentlichen!

Die neue Version kann ab sofort unter der selben URL runtergeladen werden wie bisher:

affilinet Publisher Auto Apply Tool: Download

Vielen Dank nochmal an alle für das positive Feedback beim affilinet Marketing Day in München!

affilinet Publisher Auto Apply Tool

Wednesday, May 13th, 2009

Wie ja bereits in einem der vorherigen Posts beschrieben ist das Anmelden bei den einzelnen Advertisern ein ziemlich zeitaufwändiger Prozess. Ich habe hierfür mal ein kleines Tool gebastelt, welches einem die Arbeit so gut wie komplett abnimmt:

affilinet Auto Apply Tool – Download

Für das Tool wird Windows XP (oder Vista?) und Microsoft .NET Framework 2.0 benötigt.

Screenshot - affilinet Auto Apply Tool

Screenshot - affilinet Auto Apply Tool

Disclaimer:
Ganz wichtig: Die Verantwortung alle Advertiser AGBs gelesen zu haben, liegt bei dem Benutzer dieses Tools! 

Benutzung:
- Installieren
- PublisherId, Publisher Passwort & Webservice Passwort eingeben
- GO Button klicken
- Sich freuen, dass man nicht alles manuell gemacht hat ;-)
 
Hinweise:
Ja, es gibt Bugs! Da Ich das Tool aber eigentlich nur für mich geschrieben habe und man sich nicht wirklich oft bei allen Advertisern bewerben will reicht es aber IMHO aus.
 
Bekannte Probleme: Bei einigen Advertisern geht’s einfach nicht…keine Ahnung warum. Da es bei ca. 1000 Advertisern aber unter 10 sind, habe ich mich nicht weiter darum gekümmert. Die wenigen kann man dann zur Not ja auch noch gerade über das Publisher Portal manuell behandeln. Das eigentliche Problem dabei ist, dass das Tool bei diesen Advertisern stoppt. Wenn dies der Fall sein sollte, muss man einfach in der Listbox manuell den nächsten Eintrag auswählen und schon geht’s weiter!
 
Benutzerdaten:
Das Publisher Passwort ist das, was bei der Anmeldung im Publisher Portals genutzt wird.
Das Webservice Passwort findet ihr unter: “Konto / Technische Einstellungen / Webservices / Publisher Websercices”
 
Ich bin übrigens gerne bereit den Source Code weiter zu geben, falls jemand Lust das Tool weiter zu entwickeln (VS 2008 Solution / C#)…ist allerdings echt keine große Kunst!
 
Falls interesse bestehen sollte, kann Ich auch in einem weiteren Post beschrieben, wie das ganze implementiert wurde.
Im Prinzip rufe Ich einfach die Webservice Methode GetAllPrograms auf und hole mir damit alle Programme bei welchen Ich noch keine Partnerschaft habe.
Dann iteriere Ich einfach über diese Liste und rufe die affilinet SignUp Seite auf um mit Hilfe des DOM meine Daten in die Felder zu füllen und den “Anmelden” Button zu klicken. Nun muss nur noch gewartet werden, bis die Startseite des Publisher Portals erscheint und fertig ist die Anmeldung!
 
So…viel Spaß beim anmelden! Ihr könnt ja mal einen Kommentar schreiben was ihr mit der gesparten Zeit gemacht habt! ;-)

Bessere Suchergebnisse mit affilinet Produktdaten Webservices

Tuesday, April 28th, 2009

Ein relativ unbekanntest Feature bei der Produktsuche über affilinet Webservices ist, dass man (und wie man) Suchbegriffe mit UND und/oder ODER verknüpfen kann. Das ganze geht folgendermaßen:

UND Verknüpfung:

Dies ist die Standard Verknüpfung. Hierbei werden einfach mehrere Suchbegriffe hintereinander geschrieben.

Beispiel: “BMW Benzin Diesel”

Hierbei werden alle Produkte gefunden, die sowohl “BMW” als auch “Benzin” enthalten.

ODER Verknüpfung:

Hierbei werden die Suchbegriffe in Klammern geschrieben.

Beispiel: (Benzin Diesel)

Hierbei werden alle Produkte gefunden, die entweder “Benzin” oder “Diesel” enthalten

ODER mit UND verknüpfen

Will man UND mit ODER verknüpfen, muss man darauf achten, dass das UND hinter dem ODER steht:

Beispiel: (Benzin Diesel) BMW

Hierbei werden alle Produkte gefunden die “BMW” UND “Benzin” ODER “Diesel” enthalten.

Gutscheincode Webservice von affilinet

Sunday, April 26th, 2009

Wie ja schon im letzten Post geschrieben, hat sich etwas getan am WSDL der Inbox Webservices:

https://api.affili.net/V2.0/PublisherInbox.svc?wsdl

Seit kurzem ist da die neue Methode “GetVoucherCodes” aufgetaucht. Hiermit hat man die Möglichkeit die seit kurzem auf der Publisher Plattform verfügbaren Gutscheine bzw. Gutscheincodes via Webservice abzufragen.

In Aktion könnt ihr das ganze unter: http://www.derbilligpreisvergleich.de/Gutscheinverzeichnis_S0

affilinet Produktdaten Webservices effektiv nutzen – Teil 2

Saturday, April 18th, 2009

Da ich in der letzten Woche ein wenig Zeit hatte, habe Ich es endlich geschafft die im Teil 1 beschriebene Funktionalität umsetzen zu können. Das Resultat könnt ihr euch unter folgender URL ansehen:

http://www.derbilligpreisvergleich.de

Hier werden für die Darstellung der Produktdaten lediglich affilinet Webservices genutzt. Welche dies genau sind und mit welchen schwierigkeiten man dabei zu kämpfen hat, erfahrt ihr im nächsten Teil. Soviel aber schon jetzt: Caching, caching, caching!

Und noch ein Tipp: guckt euch mal das WSDL für die Inbox Webservices (die neuen) an…passend zu Ostern! Naja, fast! ;-)

affilinet Produktdaten Webservices effektiv nutzen – Teil 1

Wednesday, April 8th, 2009

Aus aktuellem Anlass werde Ich mit dem ASP.NET Tutorial für Anfänger erstmal nicht weitermachen und stattdessen einige Tipps und Beispiele für die effektive Nutzung von affilinet Produktdaten geben. Hier tauchen anscheinend immer wieder die gleichen Fragen und Probleme auf, so dass viele potentielle Anwender schon nach einigen Stunden abgeschreckt werden, bevor überhaupt ein Ergebnis erzielt wurde. Um das Szenario möglichst realistisch zu halten, werde Ich hierfür bei affilinet einen neuen Account anlegen und somit den kompletten Ablauf dokumentieren um von einem neuen Account zu einem funktionierenden Online Shop zu kommen, welcher möglichst viele Daten enthält. Auch SEO wird hier eine große Rolle spielen.

Ein großes Problem, welches nur manuell gelöst werden kann ist die Anzahl der Produkte zu maximieren mit der man arbeiten kann. Hierfür benötigt man natürlich möglichst viele Partnerschaften mit Programmen, welche Produktdaten anbieten. Ich werde mich hierbei lediglich auf die affilinet Webservices konzentrieren, da die Nutzung der CSV Produktdaten IMHO schon ein wenig komplizierter ist (Meist eine eigene DB notwendig).

Ich werde mich dabei allerdings nicht nur auf die Produktdaten Webservices beschränken sondern zumindest auch die Programmlisten Webservices benutzen.

Ziel ist hierbei einen Onlineshop zu erstellen, welcher für möglichst viele verschiedene Zielgruppen optimierte Produktdaten liefert, also einen wirklichen Mehrwert für den Benutzer darstellt und nicht nur die Suchmaschinen mit unnötigem Spam versorgt.

Eigentlich sieht es ja so aus, dass man sich zuerst mit einer bestehenden Website bei den jeweiligen Programmen bewirbt. Das ist natürlich das erste Problem bei der Erstellung eines neuen Projektes. Man benötigt Daten um eine Seite zu erstellen, die man aber erst bekommt, wenn bereits eine Seite vorhanden ist. Ein typisches Henne Ei Problem. Hier bleibt einem nichts anderes übrig, als eine Seite zu erstellen, welche für den Advertiser interessant ist, so dass eine Partnerschaft ermöglicht wird.

In den meisten Fällen reicht es aus eine Partnerschaft mit einem Program einzugehen, welches Produktdaten anbietet. In einigen Fällen muss aber die Benutzung der Produktdaten gesondert beantragt werden.

Typischer Ablauf

1. Relevante Seite erstellen und im Internet veröffentlichen

Tipp: Seiten wie „Hier entsteht eine neue Internetpräsenz” o.ä. werden euch nicht viel nützen sondern eher schaden. Wird eine Bewerbung abgelehnt, könnt ihr euch erst nach 3 Monaten bei diesem Programm erneut bewerben.

2. Neuen Account für diese URL bei affilinet erstellen (oder vorhanden Benutzen)

Tipp: Wird ein neuer Account mit genau denselben Einstellungen erstellt (Natürlich mit anderer URL), wird dieser bei affilinet als „verlinkter” Account gehandhabt. Somit könnt Ihr euch mit einem Account anmelden und trotzdem alle mit einem Login verwalten.

3. Suche nach Programmen mit Produktdaten durchführen und bei diesen bewerben

Hierfür muss einfach folgende Seite aufgerufen werden:

Solutions / Produktdaten / Produktlisten
http://publisher.affili.net/Solutions/productSearch.aspx

Leider ist es nicht möglich sich bei mehreren Programmen automatisch zu bewerben. Somit ist hier ein hoher manueller Aufwand nötig. L

4. Bewerbung bei Programmen ohne Produktdaten (optional)

Ich gehe hierbei auch Partnerschaften mit Programmen ein, welche keinerlei Produktdaten anbieten, da ich mit Benutzung der Programmlisten Webservices meinen Benutzern ebenfalls Dienstleistungen schmackhaft machen möchte, welche keinerlei Produktdaten anbieten (Kreditvergleicher o.ä.)

5. Auf Bestätigung der Partnerschaft warten

Da einige Programme euch sofort automatsch annehmen werden, könnt ihr mit diesen natürlich schon sofort loslegen. Bei den meisten müsst ihr euch leider auf längere Wartezeiten gefasst machen.

6. Gesondert für die Benutzung der Produktdaten bewerben

Wenn eure Partnerschaft vom Program angenommen wurde, solltet ihr nochmal kontrollieren, ob ihr die Benutzung der Produktdaten gesondert beantragen müsst, indem ihr nach der Annahme nochmals die Produktlistenseite kontrolliert und gegeben falls hier beim jeweiligen Shop die Benutzung beantragt.

7. Passwörter für den Webservices Zugriff generieren

Um überhaupt die Webservices benutzen zu können, müsst ihr euch bei affilinet noch die entsprechenden Passwörter besorgen. Dazu geht ihr auf folgende Seite und generiert euch diese.

Konto / Technische Einstellungen / Webservices
http://publisher.affili.net/Account/techSettingsPublisherWS.aspx

8. Wahl der “richtigen” API

Nun habt ihr noch einmal die Qual der Wahl. Es wurde vor kurzem eine neue Version der affilinet Webservices API veröffentlicht, die im Vergleich zu den alten einige offensichtliche Verbesserungen gebracht haben was die Einheitlichkeit der Methoden angeht (Parameternamen und Typen). Allerdings sind diese zurzeit nur via SOAP zu erreichen. Um es kurz zu machen: Wisst ihr was SOAP ist und wie ihr SOAP Webservices via PHP o.ä. ansprechen könnt nehmt einfach die neuen. Wisst ihr das nicht und habt auch kein Interesse daran euch dieses Wissen anzueignen oder könnt es aus technischen Gründen nicht (Für PHP: Server benötigt SOAP Extensions und OpenSSL), bleibt euch nichts anderes übrig als die „alten” Webservices zu benutzen. Die verstehen sich auch mit HttpGet Requests (D.h. Ihr könnt einfach eine URL aufrufen um an die Ergebnisse zu kommen).

Neue Dienste

http://developer.affili.net/

Hier wurde von affilinet eigens für die neuen Webservices ein neues Portal erstellt, welches neben der Dokumentation der Dienste ebenfalls eine Sandbox Datenbank zur Verfügung stellt um ohne Partnerschaften testen zu können.

Alte Dienste

Für Programmlisten, Statistiken o.ä.:
http://webservices.affili.net/Publisher/Default.aspx
Dokumentation

Für Produktdaten:
http://webservices.affili.net/PDWS/ProductDataV2.asmx
Dokumentation

So, nun habt ihr eigentlich alles, was ihr für die Nutzung der Webservices braucht um einen schönen Onlineshop zu basteln. Im nächsten Teil werde Ich dann einige Hilfestellungen zu den richtigen Methoden und deren Parametern geben. Ein wenig selber mit den Webservices zu spielen kann ja zwischenzeitlich auch nicht schaden…zumal ihr sowieso wahrscheinlich auf einige Bewerbungen warten werdet! ;-)

Hinweise:

Programme vs Shops (aka Produktlisten)

Programme sind nicht gleich Shops! Angenommen ihr habt eine Partnerschaft mit einem Program mit der ID 0815, dann ist dies nicht auch gleichzeitig die ShopId. Diese kann dann zum Beispiel 4711 sein. Dies hat damit zu tun, dass viele Programme verschiedene Produktliste aka Shops anbieten, die jeweils unterschiedliche IDs haben. Um eine Liste aller Shops zu bekommen müsst ihr entweder die oben beschriebene Produktlistenseite benutzen oder gleich den Webservice GetShopList, welche wiederum ein Mapping von Shop auf Program ermöglicht.

Programmkategorien vs Shopkategorien vs Kategorien der einzelnen Shops

Das gleiche gilt für die Kategorien. Es gibt zum einen die Programmkategorien des affilinet Portals in welche die Programme einsortiert sind (ProgramListService/GetProgramCategories) und zum anderen sogenannte Shopkategorien (getCategoryList mit Parameter „0″ für ShopID) in welche die Produkte aller Shops einsortiert sind. Zusätzlich hat jeder Shop wiederum eigene Kategorien, welche ebenfalls über getCategoryList mit der jeweiligen ShopID abzufragen sind die ihr über die Methode GetShopList bekommt! ;-)

Die Struktur sieht also folgendermaßen aus:

Programmkategorien – > Programme -> Shops -> Shopkategorien -> Produkte

Oder

Shopkategorien (von ShopID „0″) -> Produkte

affilinet hat freundlicherweise die Kategorien der einzelnen Shops auf den generellen Kategorie baum „gemapped”, so dass ihr anhand der generellen Kategorien (ShopID „0″) einen einheitlichen Shop aufbauen könnt, welche die Produkte aller einzelnen Shops enthält. Alternativ könnt ihr über den Kategorie baum eines einzelnen Shops eine spezialisierte Seite bauen, die lediglich eine Produktliste behandelt (Mein toller Buchladen o.ä.) wenn ihr eine Seite für eine Nische haben wollt.

Hierfür werde ich in naher Zukunft Beispiele vorstellen, die es euch ermöglicht mit den richtigen Methoden und Parametern sehr einfach eigene Onlineshops zu erstellen.

Wahl der richtigen Methode

Grundsätzlich stehen folgende Methoden zum Suchen von Produkten zur Verfügung:

  • SearchProducts
  • SearchProductsInCategory
  • SearchProductsInCategories

Ich will jetzt gar nicht lange Beschreiben, wofür welche Methode genau da ist. Dafür gibt es ja die Dokumentation von affilinet. Aus Erfahrung kann Ich nur empfehlen nach Möglichkeit die Suche auf Kategorien einzuschränken und hierfür die Methode SearchProductsInCategories zu verwenden. Muss über den gesamten Datenbestand gesucht werden bleibt nur die SearchProducts. Hierbei sind die Ergebnisse allerdings aufgrund der vielen Daten nicht immer wirklich optimal.

Wenn ihr schnell mal gucken wollt, welche Anfragen welche Ergebnisse bringen sei euch neomatrix ans Herz gelegt. Hier liegt zwar der eigentliche Fokus auf Statistiken (mehrere Publisher Accounts aggregiert, Vergleichszeiträume etc.) aber auch der Teil „Werbemittel” welcher einen Generator für Flash Carousels beinhaltet ist für die Abfrage und den Test der Produktdatenwebservices gut geeignet. Grundsätzlich benutzt das Tool nur affilinet Webservices, so dass ihr hier einen guten Überblick bekommen könnt, was hiermit alles möglich ist! :-) http://www.affili-tools.net/