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.
Bitte senden Sie einen Referrer in der Request-URL und einen Placement-String im Subid-Parameter.
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]]&ref=[[REFERRER]]&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 Headers

Header	Datentyp	Erforderlich?	Beschreibung
User-Agent	String	Ja¹	Der User-Agent des Browsers.
Referer	String	Ja¹	Die URL der Seite, welche die Ads aus dem Request erhalten wird.

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	Empfohlen	URL der Seite, die den Ad-Request sendet (unterstützt decodierte und encodierte URL-Strings). Dies ordnet Ihren Traffic der Site-Tabelle Ihres Publisher-Accounts zu, damit Advertiser spezifische Seiten targeten können.
s	String	Empfohlen	Verwenden Sie den SubID-String, um Informationen zur Platzierung einer bestimmten Anzeige zu übermitteln, z. B. „search-top“ oder „sidebar“. Dies hilft Werbetreibenden dabei, ihre Anzeigen auf Ihrer Website gezielter auszuspielen.
sl	Bit	Empfohlen	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)

d>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