PDF Datei - FeWo

Transcription

PDF Datei - FeWo

Erste Schritte
Der bereitgestellte Feed ist ein XML-Atom- Feed. Um auf die Daten zuzugreifen, müssen Sie den
Feed zuerst parsen.
Hier sind die Schritte zum Aufrufen und Anzeigen von Daten:
1.
2.
3.
4.
Schritt: XML-Feed öffnen
Schritt: Daten aus dem Feed entpacken/parsen
Schritt: Daten speichern
Schritt: Daten anzeigen
Es gibt verschiedene Möglichkeiten, die Daten aus dem Feed zu extrahieren. Es wurden zahlreiche
APIs für den Zugriff auf XML entwickelt und standardisiert. Beispiele für Pull-Parser sind StAX in der
Programmiersprache Java, SimpleXML in PHP und System.Xml.XmlReader in der .NET Framework.
Weitere bekannte sind FeedAPI (http://drupal.org/project/feedapi) und SimplePie
(http://simplepie.org/).
Zugriff auf die Daten
Ihre Master Feed URL wird etwa so aussehen:
https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_deutschland&format
=cjAtom&affiliateId=123456
Um zu den restlichen Feed-Seiten zu gelangen, müssen Sie den Feed „laufen“ lassen, indem Sie dem
“next“-Link folgen.
So führt beispielsweise
<link rel="next" type="application/atom+xml"
href="https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_deut
schland&format=cjAtom&affiliateId123456&page=2"/> zu der zweiten Seite des Feeds und
<link rel="last" type="application/atom+xml"
href="https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_deut
schland&format=cjAtom&affiliateId123456&page=50"/> zu der fünfzigsten.
Update der Daten
Da es hin und wieder passieren kann, dass unsere Vermieter ihre Inserate aktualisieren, updaten wir
den Feed regelmäßig. Einmal täglich sollten Sie die Daten zwischenspeichern und die alten Daten von
den vorherigen Tagen durch die updateten Daten ersetzen. Indem Sie den Feed regelmäßig in Ihrem
System updaten, werden alle Änderungen und Aktualisierungen übernommen.
Customized Feeds / benutzerdefinierte Feeds
Falls Sie den Feed filtern möchten, um konkrete Datensätze angezeigt zu bekommen, haben Sie
mehrere Möglichkeiten, die Such-Ergebnisse zu verfeinern.
1. Filtern nach Regionen
Wenn Sie zum Beispiel nur Objekte in einer bestimmten Region wollen anzeigen lassen, dann
können Sie folgendes tun:
Generieren Sie zuerst Ihre Partner-Feed URLs, indem Sie Ihre Commission Junction PID
verwenden. In den folgenden Beispielen verwende ich 123456.
Schritt 1: Identifizieren Sie die FeWo-direkt Region ID, die Sie gerne auf Ihrer Website einbinden
möchten. Dies ist eine Zahl 1-7, die mit '/ r' beginnt. Die unteren Beispiele dürfen das besser
veranschaulichen:
Frankreich: http://www.fewo-direkt.de/urlaub-ferienwohnung-ferienhaus/frankreich/r14
Italien: http://www.fewo-direkt.de/urlaub-ferienwohnung-ferienhaus/italien/r15
Cote d'Azur : http://www.fewo-direkt.de/urlaub-ferienwohnung-ferienhaus/frankreich/cote-dazurriviera/r1436
Berlin: http://www.fewo-direkt.de/urlaub-ferienwohnung-ferienhaus/deutschland/berlin/r125
Schritt 2: Fügen Sie diese Region ID am Ende Ihrer Master Feed URL ein.
Frankreich:
https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_europa&format=cjAt
om&affiliateId=123456&refineBy=regions:14
Italien:
Cote d'Azur:
Berlin:
•
Eine weitere Option nach bestimmten Locations zu filtern ist das Benutzen von
„&queryString=destination “. Hier sind drei Beispiele:
https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_welt&format=cjA
tom&affiliateId=123456&queryString=deutschland à Deutschland
tom&affiliateId=123456&queryString=griechenland à Griechenland
tom&affiliateId=123456&queryString=costa+rica à Costa Rica
2. Filtern nach Preis
Der Feed erlaubt Ihnen, die Objekte nach ihrem Preis zu filtern. Um den maximalen Preis zu
definieren, fügen Sie bitte“ &maxPrice=“ am Ende der Feed URL an.
https://partner.homeaway.eu/aggregator/london_prd_de/partners/search?partnerId=cj_welt&form
at=cjAtom&affiliateId=123456&queryString=deutschland&maxPrice=1000 à wird Ihnen nur
Ergebnisse in Deutschland mit einem max. Preis von 1000 EUR zurück liefern.
Genau so können Sie den minimalen Preis durch „ &minPrice=“ definieren.
at=cjAtom&affiliateId=123456&queryString=deutschland&minPrice=100 àzeigt nur Objekte in
Deutschland mit einem min. Preis von 100 EUR an.
Wenn Sie einen Preisrahmen setzen möchten, können Sie gleichzeitig den min. und max. Preis
bestimmen, wie das unten folgende Beispiel das zeigt:
at=cjAtom&affiliateId=123456&queryString=deutschland&minPrice=100&maxPrice=1000 à das
Ergebnis zeigt Objekte nur in Deutschland zwischen 100-1000 EUR an.
3. Filtern nach Suchbegriff
Wenn Sie nur Datensätze mit einem bestimmten Keyword einbinden möchten, dann können Sie
so vorgehen:
Geben Sie Ihre CJ PID und den Suchbegriff in die dafür vorgesehenen Felder ein. Nehmen wir
„Pool“ als Beispiel.
So sieht dann Ihre Partner- Feed URL aus
at=cjAtom&affiliateId=123456&queryString=Pool
Wenn Sie nun nur Ferienobjekte auf Cote d'Azur mit Pool promoten möchten, verfeinern Sie die URL
durch die entsprechende Region ID à
at=cjAtom&affiliateId=123456&queryString=Pool&refineBy=regions:1436
XML Feed Data
• Holiday Rental Name- Name des Ferienobjekts
• Description of the Property- Beschreibung des Ferienobjekts
• Property ID- Objekt ID
• URL of the listing at fewo-direkt.de- URL vom Ferienobjekt auf fewo-direkt.de
• CJ Tracking URL
• Image URL
• Region (Land, Region, Stadt, PLZ)
• Price- Preis
• Currency- Währung
• Period Type- Zeitraum (Tag- Woche- Monat)
• Property Type- Typ des Ferienobjekts (Apartment, Haus, Villa, Bungalow, etc)
• # of Bedrooms- Anzahl Schlafzimmer
• # of People it Sleeps- Anzahl Schlafmöglichkeiten
• # of Bathrooms- Anzahl Badezimmer
Listing Attributes
Das Listing- Element besteht aus folgenden Attributen:
• systemid, propertyid, unitid – durch diese drei IDs wird das Ferienobjekt eindeutig definiert.
• url – die Ferienobjekt URL auf fewo-direkt.de
• lastmodified – zeigt, wann das Inserat durch den Vermieter zum letzten Mal aktualisiert wurde.
• thumbnailurl – gibt die Location vom Thumbnail Image an.
• imageurl – gibt die Location vom großen Bild an (gleich wie thumbnailurl). Dieses Bild passt in
einem 400x300 Frame.
Listing Elements
• headline – gleich wie “title”. Das ist die vom Vermieter angegebene Inserat-Headline.
• description – gleich wie “summary”. Das ist die vom Vermieter aufgegebene Beschreibung des
jeweiligen Ferienobjekts.
• regions –genaue Beschreibung der Ferienobjekt-Lage
• rates – Preisliste je nach Zeitraum (Tages-, Wochen- , Monatspreise)
• rentalbasis – die Grundlage für die Preisbildung- pro Objekt, pro Person, pro Zimmer, etc.
• rate from –unterste Preisspanne
• rate to –oberste Preisspanne
• currencyunit – EUR
• periodtype – der Zeitraum (Tag, Woche, Monat)
• propertytype – Typ des Ferienobjekts – Haus, Wohnung, Villa, Bungalow, etc.
• bedrooms – Anzahl Schlafzimmer
• sleeps – Anzahl Schlafmöglichkeiten
• wc – Anzahl WCs
• fullbathrooms – Anzahl Badezimmer
• showerRooms – Anzahl Duschräume
• city – Stadt, in der sich das Objekt befindet
• state – Region, in der sich das Objekt befindet
• country – Land, in dem sich das Objekt befindet
• postalcode – PLZ

PDF Datei - FeWo

Transcription

Similar documents

Kontaktdaten Urlaub auf Rügen - Ferienresidenz am Nationalpark