Links

Conversies server-side rapporteren

Rapporteer conversies aan Styrar vanuit je eigen backend in Node.js, Python of Ruby on Rails.

Als een conversie op je backend plaatsvindt in plaats van in de browser — bijvoorbeeld een webhook van je betalingsprovider — lees je de waarde styrar_ck van het oorspronkelijke verzoek en post je die rechtstreeks naar hetzelfde publieke endpoint dat de browserpixel gebruikt. Zie Conversiepixel voor de volledige referentie.

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Node.js / Express

JavaScript

app.get('/checkout/complete', async (req, res) => {
  const clickToken = req.query.styrar_ck || req.cookies?.styrar_ck;
  if (clickToken) {
    fetch('https://api.styrar.com/v1/pixel/track', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ clickToken, eventName: 'purchase', value: req.session.orderTotal }),
    }).catch(() => {});
  }
  res.render('checkout-complete');
});

Python (Flask)

PYTHON

import requests

@app.route('/checkout/complete')
def checkout_complete():
    click_token = request.args.get('styrar_ck') or request.cookies.get('styrar_ck')
    if click_token:
        try:
            requests.post(
                'https://api.styrar.com/v1/pixel/track',
                json={'clickToken': click_token, 'eventName': 'purchase', 'value': order_total},
                timeout=2,
            )
        except requests.RequestException:
            pass
    return render_template('checkout-complete.html')

Python (Django)

PYTHON

import requests

def checkout_complete(request):
    click_token = request.GET.get('styrar_ck') or request.COOKIES.get('styrar_ck')
    if click_token:
        try:
            requests.post(
                'https://api.styrar.com/v1/pixel/track',
                json={'clickToken': click_token, 'eventName': 'purchase', 'value': order_total},
                timeout=2,
            )
        except requests.RequestException:
            pass
    return render(request, 'checkout-complete.html')

Ruby on Rails

RUBY

require 'net/http'
require 'json'

class CheckoutController < ApplicationController
  def complete
    click_token = params[:styrar_ck] || cookies[:styrar_ck]
    if click_token
      begin
        uri = URI('https://api.styrar.com/v1/pixel/track')
        Net::HTTP.post(uri, { clickToken: click_token, eventName: 'purchase', value: @order_total }.to_json,
                        'Content-Type' => 'application/json')
      rescue StandardError
        nil
      end
    end
  end
end

Elke andere backend

Het endpoint is gewone HTTP en JSON zonder authenticatie, dus dit werkt vanuit elke taal die een HTTP-verzoek kan doen:

Shell

curl -X POST https://api.styrar.com/v1/pixel/track \
  -H 'Content-Type: application/json' \
  -d '{"clickToken":"<styrar_ck value>","eventName":"purchase","value":49.99}'

Wikkel de aanroep zo in dat een trackingfout de flow waar hij aan vastzit nooit kan breken — het endpoint geeft altijd 200 { "ok": true } terug, maar je moet netwerkfouten aan jouw kant toch afvangen.

Verwant

Conversiepixel — volledige referentie