Pixel JS — instalacja

Skopiuj jeden tag i wklej go na thank-you page. Działa w 2 minuty.

Kiedy używać: E-commerce (Shopify, WooCommerce, PrestaShop), proste landing page z formularzem, lead gen. Nie używaj jeśli Twoja strona ma silne ad-blockery w użyciu lub potrzebujesz 100% accuracy — wtedy server-side postback.

1. Wklej pixel base (na każdej stronie)

Najlepiej w <head> — async, nie blokuje renderowania.

<!-- Affily Pixel -->
<script async src="https://t.affily.pl/pixel.js"></script>
<script>
  window.affily = window.affily || function(){
    (window.affily.q = window.affily.q || []).push(arguments);
  };
</script>

2. Strzel event konwersji (na thank-you page)

Po finalizacji zamówienia, na stronie podziękowania (lub po wysłaniu formularza):

<script>
  affily('conversion', {
    offer_id: 'off_xxxxxxxx',        // ID Twojej oferty w Affily
    order_id: '{{ORDER_ID}}',        // unikalny ID zamówienia
    amount: {{ORDER_TOTAL}},          // wartość koszyka w PLN (number, not string)
    currency: 'PLN'
  });
</script>
Przykład dla WooCommerce:
<!-- W functions.php lub przez "Insert headers and footers": -->
add_action('woocommerce_thankyou', function($order_id) {
    $order = wc_get_order($order_id);
    ?>
    <script>
      affily('conversion', {
        offer_id: 'off_TWOJE_ID',
        order_id: '<?= $order_id ?>',
        amount: <?= $order->get_total() ?>,
        currency: 'PLN'
      });
    </script>
    <?php
});

3. Test integracji

  1. 1. Kliknij swój testowy link Affily (np. t.affily.pl/r/TEST)
  2. 2. Sprawdź w devtools, czy ustawione zostało cookie affily_click_id
  3. 3. Przejdź przez checkout (test mode)
  4. 4. Na thank-you page sprawdź Network tab: powinien być POST na t.affily.pl/p z 201
  5. 5. W panelu Affily → Konwersje powinieneś zobaczyć konwersję ze statusem pending

FAQ

Co jeśli klient nie ma cookie?

Konwersja nie zostanie zaliczona — Affily nie wie skąd przyszedł klient. Cookie ustawia się przy kliknięciu w link Affily. Domyślny czas życia: 30 dni.

Cross-domain - czy działa?

Pixel używa first-party cookie na domenie affily.pl. Działa cross-domain dla wszystkich subdomen affily.pl, ale nie dla zewnętrznych domen. Dla cross-domain użyj server-side postback.

Jak debugować?

W konsoli przeglądarki wpisz window.affily.q - zobaczysz wszystkie wystrzelone eventy. Pixel loguje też debug info do console gdy URL ma ?affily_debug=1.

Czy mogę używać Google Tag Manager?

Tak. Dodaj Custom HTML tag z pixel base, a osobno tag na thank-you page który strzela affily('conversion', ...). Trigger: page view URL contains "thank-you" lub podobny.

← DocsServer-side postback →