Serverseitige Implementierung mit XML/JSON-Feed

Für serverseitige Integrationen, bei denen eine strukturelle Manipulation (Layout, Aggregation mit anderen Feeds usw.) erforderlich ist, stehen XML- oder JSON-Endpunkte zur Verfügung.

Für AJAX-Requests wird in der Regel JSON empfohlen, sofern serverseitige Proxy-Requests möglich sind. Hinweis: Ein clientseitiger SCRIPT-Request deckt die meisten typischen AJAX Use Cases ab und ist deutlich einfacher zu implementieren.

Bei einer serverseitigen Implementierung ist es zwingend erforderlich, einen Impression-Callback zu senden, sobald ein Placement für den User sichtbar wird. Andernfalls wird Ihr Traffic nicht korrekt erfasst.

Wichtige Regeln

Publisher müssen Impression-Callbacks senden, um korrektes Tracking zu gewährleisten.
Die Reihenfolge der Anzeigen darf nicht verändert oder manipuliert werden.
Fragen Sie bitte nur so viele Ads ab, wie Sie tatsächlich anzeigen möchten.
Ergebnisse dürfen nicht gecached werden.

Datenformate & Feed-URLs

Datenformate	Response (Antwort)	Endpoint (Endpunkt)	Kodierung
XML	XML-Dokument	http://feed.solads.media/feed.xml.ashx	UTF-8
JSON	JSON-formatiertes Datenobjekt	http://feed.solads.media/feed.json.ashx	UTF-8

XML Sample Request (Native Ad)

https://feed.solads.media/feed.xml.ashx?sys=Solads&a=[[PUBLISHERID]]&ch=[[CHANNELID]]&ip=[[USER_IP]]&iw=[[IMAGE_WIDTH]]&ih=[[IMAGE_HEIGHT]]&i=1&lang=[[BROWSER_LANGUAGE]]&n=[[NUMBER_OF_RESULTS]]&s=[[SUBSTRING]]&sl=1&consent=1&ai=1

XML Sample Response (Native Ad)

<adverts results="13"> <advert id="0" clickprice="" ecpmi="">   <title></title>   <description></description>   <displayurl></displayurl>   <clickurl></clickurl>   <impressionurl></impressionurl>   <imageurl></imageurl>   <mediawidth></mediawidth>   <mediaheight></mediaheight>   <mediatype></mediatype> </advert>

JSON Sample Request (Native Ad)

https://feed.solads.media/feed.json.ashx?sys=Solads&a=[[PUBLISHERID]]&ch=[[CHANNELID]]&ip=[[USER_IP]]&iw=[[IMAGE_WIDTH]]&ih=[[IMAGE_HEIGHT]]&i=1&lang=[[BROWSER_LANGUAGE]]&n=[[NUMBER_OF_RESULTS]]&s=[[SUBSTRING]]&sl=1&consent=1&ai=1

JSON Sample Response (Native Ad)

{"adverts":{"results":,"platform":"","guid":"","mediawidth":240,"mediaheight":120,"advert":[{"id":0,"bid":,"campaign":,"copy":,"ecpmi":0.,"title":"","description":"","displayurl":"","clickurl":"",","impressionurl":"","mediatype":"","clickprice":,"imageurl":"","imagetitle":"","mediawidth":,"mediaheight":}}

Request-Header

Header	Datentyp	Erforderlich?	Beschreibung
User-Agent	String	Ja¹	Der User-Agent des Browsers. In der Regel geschieht dies bei clientseitigen Implementierungen (JSON, JSONP, HTML, SCRIPT) automatisch. Serverseitige Implementierungen müssen diesen Header im Request an SolAds Media entsprechend setzen.
Referer	String	Ja¹	Die URL der Seite, welche die Ads aus dem Request erhalten wird. In der Regel geschieht dies bei clientseitigen Implementierungen (JSON, JSONP, HTML, SCRIPT) automatisch. Serverseitige Implementierungen müssen diesen Header im Request an SolAds Media entsprechend setzen.

¹ Falls Ihre gewählte Programmiersprache oder Umgebung das Setzen von Request-Headern nicht zulässt, können diese über die Parameter „ua=“ und „ref=“ bereitgestellt werden. Die Daten müssen in diesem Fall URL-codiert gesendet werden. Bitte versuchen Sie jedoch nach Möglichkeit Header zu verwenden, da Parameter unnötiges Logging verursachen und die Performance beeinträchtigen können.

Feed-Inputs (Parameter)

Parameter	Datentyp	Erforderlich?	Beschreibung
a	Integer (6)	Ja	Ihre Publisher-ID
ai	Bit	Ja	Aktiviert "Actual Impressions". Sie erhalten eine Impression-Callback-URL, um unseren Adserver zu benachrichtigen, sobald eine Anzeige für den User sichtbar war.
b	Bit	Nein	Nur verwenden, wenn Sie vom Support-Team dazu aufgefordert werden.
bfcpm	Float	Nein	Mindestgebot (Minimum Bid) für Banner. Nur relevant für Display-Ads. Format: #.##
ch	Integer	Ja	Channel-Nummer
cpw	Integer	Ja, für Banner	Banner-Breite (Copy width)
cph	Integer	Ja, für Banner	Banner-Höhe (Copy height)
consent	Boolean	Ja	Gibt an, ob die Nutzereinwilligung zur Verarbeitung personenbezogener Daten (PII) gemäß Datenschutzgesetzen vorliegt. 1 = Einwilligung, 0 = Keine Einwilligung (Standard).
i	Bit	Ja, für Natives	Bilder verwenden, falls verfügbar (Standard = 0)
ih	Integer	Ja, für Natives	Höhe des Logo-Bildes für Native Text-Ads
iw	Integer	Ja, für Natives	Breite des Logo-Bildes für Native Text-Ads
ip	IP-Adresse	Ja	IP-Adresse des Endnutzers
lang	String	Ja	Browsersprache des Endnutzers
mt	String	Nein¹	Medientyp (Media Type) – banner, standardtexts
n	Integer	Ja	Anzahl der angeforderten Ergebnisse (1-15)
p	Enum	Nein	Preise zurückgeben. Siehe unten.
ref	URL	Nein	URL der Seite, die den Ad-Request sendet (unterstützt decodierte und encodierte URL-Strings). Nutzen Sie diesen Parameter, wenn Sie den Referrer nicht via Header senden können. Dies ordnet Ihren Traffic der Site-Tabelle Ihres Publisher-Accounts zu, damit Advertiser spezifische Seiten targeten können. Falls ref= und der Referrer-Header gleichzeitig gesendet werden, überschreibt ref= den Header.
s	String	Nein	SubID-String
sl	Bit	Nein	Setzen Sie sl=1 für sichere Links (HTTPS) (Standard=0)
sys	String	Ja	Muss auf "Solads" gesetzt werden (interner Name unserer Plattform)
t	URL	Nein	Tracking-URL

¹ Je nach Systemkonfiguration können spezifische Anzeigentypen durch Angabe des Media-Type-Parameters angefordert werden. Wird dieser Parameter nicht angegeben, wählt der Adserver einen Medientyp, der zu den anderen Parametern passt.

Aufzählbare Eingabewerte (Enumerated Inputs)

Preise (Parameter „p“):

Wert	Beschreibung
Leer oder 0	Keine Preise zurückgeben (Standard)
EUR	Preise in Euro zurückgeben
USD	Preise in US-Dollar zurückgeben
GBP	Preise in britischen Pfund zurückgeben

HINWEIS: Alle Preise werden in Cents/Pennies angegeben, NICHT in Euro/Dollar/Pfund. Beispiel: 1.52 entspricht EIN KOMMA FÜNF-ZWEI CENTS, NICHT EINEM EURO ZWEIUNDFÜNFZIG!

Optionale Eingaben (nur für interne Referenz)

Für HTML-Requests:

Parameter	Datentyp	Pflichtfeld?	Details
c	URI	Nein	URI Ihrer CSS-Datei

Inaktive Eingaben (Legacy)

Parameter	Datentyp	Pflichtfeld?	Details
f	Bit	Nein	Filter für Adult-Content (Standard = 0)
q	String	Ja², falls ch nicht definiert	Keyword
z	String	Nein	Zonen-Name (Zone Name)

(#168)

KontaktEinloggenAnmeldenAGB