Zum Hauptinhalt springen

Parameterübergabe und Postback

Eine Quelle verbindet die Plattform und Qubix in beide Richtungen:

  • Vom Link in Qubix — wenn ein Besucher auf eine Anzeige klickt, nimmt Qubix die erforderlichen Parameter aus dem Link (den Anzeigen-Identifikator, den Pixel usw.) und bindet sie an den Besuch.
  • Von Qubix zur Plattform — wenn ein Ereignis eintritt (Registrierung, Einzahlung), sendet Qubix einen Postback an die Plattform, damit sie das Ergebnis kennt.

Die Einstellungen für beide Richtungen werden in der Quelle festgelegt — siehe Quelle erstellen.

Welche Werte aus dem Link zu nehmen sind, legt die Tabelle Parameter der Quelle fest. Für jeden Parameter geben Sie an:

  • URL-Schlüssel — unter welchem Schlüssel der Wert im Link ankommt;
  • Platzhalter — was die Plattform in den Wert einsetzt (ihr eigenes Makro oder ein fester Wert).

Beispiel eines Links für eine Facebook-Anzeige:

https://your-domain/?pixel=123456789&ad_id={{ad.id}}

Hier ist {{ad.id}} ein Facebook-Makro: Beim Anzeigen der Anzeige ersetzt die Plattform es selbst durch den echten Identifikator. Den fertigen Link für Ihre Quelle setzt Qubix im Block Beispiel-URL für eine Anzeige im Quellenformular zusammen — er kann kopiert und in das URL-Feld der Anzeige auf der Plattform eingefügt werden.

Tipp

Der Parameter Ad ID wird benötigt, um Klicks mit Anzeigen zu verknüpfen und Statistiken nach ihnen zu sehen. Ohne ihn funktioniert die Quelle weiter, aber die Aufschlüsselung pro Anzeige ist nicht verfügbar.

Über die Parameter auf der Seite des Kampagnenlinks — Kampagnenlink und Parameter.

S2S-Postback: die Plattform benachrichtigen

Ein Postback (Server-to-Server, S2S) ist eine Anfrage, die Qubix an die Plattform sendet, wenn ein Ereignis eintritt. Die Anfragevorlage wird im Feld S2S-Postback der Quelle festgelegt. In die Vorlage werden Makros eingesetzt — Qubix ersetzt vor dem Senden echte Werte hinein:

MakroWert
{external_id}Der Besuchs-/Lead-Identifikator auf Seite der Plattform.
{status}Der Ereignisstatus (zum Beispiel Registrierung, Einzahlung, Ablehnung).
{revenue}Die Einnahmen für das Ereignis.
{payout}Die Auszahlung für das Ereignis.
{currency}Die Währung.
{sub_id_N}Zusätzliche Markierungen (sub_id_1, sub_id_2 usw.).
{tid}Der Transaktions-Identifikator.

Beispiel einer Postback-Vorlage:

https://source.com/postback?subid={external_id}&status={status}&payout={revenue}

Facebook: Conversions API statt eines Postbacks

Für eine Quelle auf der Vorlage facebook wird der reguläre Postback nicht verwendet. Stattdessen sendet Qubix Ereignisse direkt an die Facebook Conversions API. Sie richten nur das Ereignis-Mapping ein: welches Qubix-Ereignis welchem Facebook-Ereignis entspricht (zum Beispiel Einzahlung → Purchase). Der Pixel-Identifikator wird dem Klick-Link entnommen, und das Zugriffs-Token — dem Pixel-Verzeichnis.

Mehr dazu — Facebook Conversions API und Pixel.

Wie geht es weiter