Der WooCommerce-Konnektor von AFFYNOR

Synchronisiere Bestellungen, Katalog und Erstattungen aus deinem WooCommerce-Shop und ordne Verkäufe deinen Werbekampagnen zu (click refs und TikToks ttclid) mit automatischem Abgleich.

1. Installation

1.1 Verbraucherschlüssel anlegen (Lese- und Schreibrechte)

WooCommerce → Einstellungen → Erweitert → REST API → «Schlüssel hinzufügen». Rechte: Lesen/Schreiben (das Registrieren von Webhooks braucht Schreibrechte). Der Shop muss über HTTPS erreichbar sein.

1.2 Von der Plattform aus verbinden

Unter Mein Shop → Karte WooCommerce die Basis-URL des Shops, den Verbraucherschlüssel und das Verbrauchergeheimnis eingeben. Die Verbindung wird sofort geprüft und bleibt aktiv.

1.3 Das Attributions-Snippet installieren

Das Snippet hat zwei Teile: den PHP-Hook (functions.php oder ein Code-Snippet), der die Bestellung auf der Danke-Seite ausgibt, und das JavaScript (GTM oder das Theme), das die Referenz erfasst und das Kaufereignis auslöst.

add_action('woocommerce_thankyou', function ($order_id) {
  if (!$order_id) return;
  $order = wc_get_order($order_id);
  echo '<div id="affynor-order" data-affynor-order-id="' . esc_attr($order->get_id())
    . '" data-affynor-order-total="' . esc_attr($order->get_total())
    . '" data-affynor-order-currency="' . esc_attr($order->get_currency()) . '" style="display:none"></div>';
}, 10);

<script>!function(){var S="https://affynor.com",K="TU_SECRETO";function u(n){try{return new URLSearchParams(location.search).get(n)}catch(e){}}function c(n){try{return document.cookie.split("; ").find(function(x){return x.indexOf(n+"=")===0}).slice(n.length+1)}catch(e){}}var r=u("affynor_ref")||c("affynor_ref")||c("tiktok_ttclid");if(r){try{document.cookie="affynor_ref="+encodeURIComponent(r)+"; path=/; max-age=31536000"}catch(e){}}var b=u("fbclid")||c("affynor_fbc");if(b&&!/^fb[.]/.test(b)){b="fb.1."+Date.now()+"."+b}if(b){try{document.cookie="affynor_fbc="+encodeURIComponent(b)+"; path=/; max-age=31536000"}catch(e){}}function f(o){try{fetch(S+"/store/pixel",{method:"POST",headers:{"Content-Type":"application/json","x-affynor-pixel-secret":K},body:JSON.stringify({order_id:o.id,revenue_cents:Math.round(+o.total*100),currency:o.cur||"EUR",ref_code:r,fbclid:b})})}catch(e){}}window.affynorPixel=f;function a(){var e=document.getElementById("affynor-order");if(e)f({id:e.getAttribute("data-affynor-order-id"),total:e.getAttribute("data-affynor-order-total")||"0",cur:e.getAttribute("data-affynor-order-currency")});}if(/thank|gracias|success|pedido|confirm/i.test(location.pathname))setTimeout(a,400)}();</script>

Ersetze TU_SECRETO durch das Pixel-Geheimnis, das auf der Karte des verbundenen Shops angezeigt wird.

2. Attribution

Der Parameter affynor_ref in der Anzeigen-URL (oder TikToks ttclid) wird in einem Cookie gespeichert und auf der Danke-Seite an die Bestellung gehängt. Das Snippet speichert auch Metas fbclid — im Format fb.1.<timestamp>.<fbclid> —, damit die Conversion dem Klick auf Meta zugeordnet werden kann. Das Ereignis bleibt ausstehend und wird automatisch gegen die synchronisierten Bestellungen abgeglichen: nur geprüfte Verkäufe werden deinen Kampagnen zugeordnet.

3. Synchronisierung

WooCommerce-Webhooks (order.created, order.updated, product.created, product.updated) liefern Änderungen in Echtzeit; ein Sicherungsabgleich läuft alle 10 Minuten durch den Shop — inklusive Erstattungen über GET /orders/{id}/refunds —, damit keine Bestellung unerfasst bleibt, selbst wenn WordPress' Cron ausfällt.

4. Erstattungen

Erstattungen werden automatisch synchronisiert und vom zugeordneten Umsatz des Monats abgezogen. Eine vollständig erstattete Bestellung wird beim Abgleich zurückgewiesen: sie erzeugt nie Provision.

5. Gebührenmodell

15% des zugeordneten Umsatzes des Monats, mit einem Minimum von 129,90 €. Hat der Monat keine zugeordneten Verkäufe, greift das Minimum nicht (der erste Monat ist frei). Das Minimum gilt je Händler, auch bei mehreren verbundenen Shops (zum Beispiel Shopify + WooCommerce).

6. Fehlerbehebung

7. Status und Roadmap

Der Konnektor wird mit Pilot-Händlern validiert: Verbindung, Attribution und Synchronisierung sind vollständig (Phasen A–D); die Validierung in echten Shops (Phase E) läuft. Die Veröffentlichung als Erweiterung im WooCommerce-Marktplatz ist der nächste Meilenstein.