Für serverseitige Integrationen, besonders dort, wo strukturelle Veränderungen (Layout, Verbindung mit anderen Quellen, etc.) erforderlich sind, werden XML-Anfragen empfohlen.

Für Ajax Anfragen wird allgemein JSON empfohlen, wenn serverseitige Proxyanfragen möglich sind. Beachten Sie jedoch bitte, dass eine JavaScript-Anfrage die geläufigsten AJAX Anwenderfälle abdeckt.

Datenformate & Feed-URLs

Datenformat

Beschreibung

Basis-URL

Encoding

XML

Vollständiges XML-Dokument

http://feed.solads.media/feed.xml.ashx

UTF-8

JSON

JSON formatiertes Datenobjekt

http://feed.solads.media/feed.json.ashx

UTF-8

XHTML

vollständiges XHMTL (transitional) Dokument

http://feed.solads.media/feed.html.ashx

UTF-8

XHTML Fragment

DIV-Container

http://feed.solads.media/feed.frag.ashx

UTF-8

Alle Feed Inputs

Header

Datentyp

Erforderlich?

Beschreibung

User-Agent

String

Ja¹

Der User-Agent des Browsers. Bei clientseitigen Integrationen (JSON, JSONP, HTML, SCRIPT) werden diese Werte automatisch übertragen. Bei serverseitigen Integrationen müssen sie im Request-Header (User-Agent) an uns gesendet werden.

Referer

String

Ja¹

Die URL der Webseite, auf der die Anzeige integriert werden. Bei clientseitigen Integrationen (JSON, JSONP, HTML, SCRIPT) werden diese Werte automatisch übertragen. Bei serverseitigen Integrationen müssen sie im Request-Header (Referer) an uns gesendet werden.

¹ Im unwahrscheinlichen Fall, daß Ihre Programmiersprache nicht erlaubt HTTP Header zu senden, können Sie alternativ die Parameter "ua=" und "ref=" nutzen. Bitte kodieren Sie die Daten per URL encoding, bevor Sie die Anfrage schicken. Prüfen Sie bitte, ob Sie die Werte als HTTP Header schicken können. Dies ist die von uns bevorzugte Anfrage-Methode.

Parameter

Datentyp

Erforderlich?

Beschreibung

a

Integer(6)

Ja

Ihre Partnernummer

ai

Bit

Ja

Aktivieren Sie "Actual Impressions" und erhalten Sie eine Impression-Callback-URL, um unseren Adserver zu benachrichtigen, wenn die Werbung für den Benutzer sichtbar war

ch

Integer

Ja

Channelnummer. Bitte beachten Sie, dass für Text- und Banneranzeigen jeweils unterschiedliche Channelnummern genutzt werden müssen.

cph

Integer

Nein

Für Banner Ads: Höhe in Pixel

cpw

Integer

Nein

Für Banner Ads: Breite in Pixel

ct

Bit

Nein

Geben Sie an, ob Sie die Zustimmung des Benutzers zur Verarbeitung von personenbezogenen Daten (PII) gemäß den regionalen Datenschutzgesetzen haben. Die Werte sind 1 für Zustimmung oder 0 für keine Zustimmung. Standardwert, wenn Parameter leer oder nicht definiert, ist 0 (keine Zustimmung).

i

Bit

Nein

Bilder anzeigen (Standard = 0)

ih

Integer

Nein

Für Native Ads: Bilderhöhe in Pixel

iw

Integer

Nein

Für Native Ads: Bilderbreite in Pixel

ip

IP Adresse

Ja

IP Adresse des Endnutzers

lang

String

Ja

Spracheinstellungen des Nutzer-Browsers

mt

String

Nein

Medientyp: Banner, Standardtext

n

Integer

Ja

Anzahl auszuliefernder Anzeigen (1-15)

p

Enum

Nein

Preis anzeigen (##.##). Details siehe unten.

ref

URL

Nein ³

Übergeben Sie den Referrer (unterstützt dekodierte und kodierte URL-Strings). Verwenden Sie diesen Parameter, wenn Sie den Referrer nicht mit dem Request Header senden können. Ihr Traffic wird so gegen den Site-Table Ihres Publisher-Kontos gematcht, wenn dort Einträge angelegt sind. Werbekunden können dann bestimmte Unterseiten gezielt targeten. Wenn sowohl ref= als auch der Referrer im Header gesendet werden, wird der Wert aus ref= genutzt.

s

String

Nein

SubID-String

sl

Bit

Nein

sl=1 setzen, um sichere Links (HTTPS) zu erhalten (Standard=0)

sys

String

Ja

sys=Solads, interner Systemname

t

URL

Nein

Publisher Tracking URL

Spezifizierte Inputs

Klickpreis (Parameter "p"):

Wichtig: Es wird der Klickpreis angezeigt, der dem Partner ausgezahlt wird.

Wert

Beschreibung

Leer oder 0

Preis nicht anzeigen (Standard)

EUR

Preis in Euro Cents anzeigen (näherungsweise, wenn nicht Standardwährung)

USD

Preis in US Dollar Cents anzeigen (näherungsweise, wenn nicht Standardwährung)

GBP

Preis in britischen Pence anzeigen (näherungsweise, wenn nicht Standardwährung)

Hinweis: Preise werden in Cents/Pennies angezeigt, nicht in EUR/USD/GBP, z.B. bedeutet 10.5 ZEHN KOMMA FÜNF CENTS, nicht ZEHN DOLLAR FÜNFZIG!

Zusätzliche Inputs

Für HTML-Anfragen:

Parameter

Datentyp

Erforderlich?

Beschreibung

c

URI

Nein

URI Ihrer CSS-Datei

Nicht aktive Inputs

Parameter

Datentyp

Erforderlich?

Beschreibung

b

Bit

1

Backfill-Ergebnisse nutzen (Standard = 1)

f

Bit

0

Nicht-jugendfreie Anzeigen filtern (Standard = 0)

q

String

Ja, wenn ch undefiniert

Keyword

z

String

Nein

Zone Name

Publisher FAQ

1. Publisher Account

2. Client-Site Implementation

3. Server-Site Implementation

4. Code Examples