Przejdź do głównej zawartości

Przekazywanie parametrów i postback

Źródło łączy platformę i Qubix w obu kierunkach:

  • Z linku do Qubix — gdy odwiedzający kliknie reklamę, Qubix pobiera z linku wymagane parametry (identyfikator reklamy, piksel itd.) i wiąże je z wizytą.
  • Z Qubix do platformy — gdy nastąpi zdarzenie (rejestracja, wpłata), Qubix wysyła postback do platformy, aby ta poznała wynik.

Ustawienia dla obu kierunków konfiguruje się w źródle — zobacz Tworzenie źródła.

To, które wartości pobrać z linku, określa tabela Parametry w źródle. Dla każdego parametru wskazuje Pan/Pani:

  • Klucz URL — pod jakim kluczem wartość przychodzi w linku;
  • Placeholder — co platforma podstawi w wartość (własne makro lub stałą wartość).

Przykład linku dla reklamy Facebook:

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

Tutaj {{ad.id}} to makro Facebook: przy wyświetlaniu reklamy platforma sama zastępuje je rzeczywistym identyfikatorem. Gotowy link dla Pana/Pani źródła Qubix składa w bloku Przykładowy URL dla reklamy na formularzu źródła — można go skopiować i wkleić w pole URL reklamy na platformie.

Wskazówka

Parametr ID reklamy jest potrzebny do powiązania kliknięć z reklamami i przeglądania statystyk według nich. Bez niego źródło nadal będzie działać, ale podział w rozbiciu na reklamy będzie niedostępny.

O parametrach po stronie linku kampanii — Link kampanii i parametry.

Postback S2S: powiadamianie platformy

Postback (server-to-server, S2S) to żądanie, które Qubix wysyła do platformy po wystąpieniu zdarzenia. Szablon żądania ustawia się w polu Postback S2S źródła. W szablon wstawia się makra — Qubix podstawi w nie rzeczywiste wartości przed wysłaniem:

MakroWartość
{external_id}Identyfikator wizyty/leada po stronie platformy.
{status}Status zdarzenia (na przykład rejestracja, wpłata, odrzucenie).
{revenue}Przychód za zdarzenie.
{payout}Wypłata za zdarzenie.
{currency}Waluta.
{sub_id_N}Dodatkowe znaczniki (sub_id_1, sub_id_2 itd.).
{tid}Identyfikator transakcji.

Przykładowy szablon postbacku:

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

Facebook: Conversions API zamiast postbacku

Dla źródła na szablonie facebook zwykły postback nie jest używany. Zamiast tego Qubix wysyła zdarzenia bezpośrednio do Facebook Conversions API. Konfiguruje Pan/Pani jedynie mapowanie zdarzeń: które zdarzenie Qubix odpowiada któremu zdarzeniu Facebook (na przykład wpłata → Purchase). Identyfikator piksela jest pobierany z linku kliknięcia, a token dostępu — z rejestru pikseli.

Więcej — Facebook Conversions API i Piksele.

Co dalej