ΤΕΚΜΗΡΙΩΣΗ · ΣΥΝΔΕΣΜΟΣ WOOCOMMERCE

Ο σύνδεσμος WooCommerce της AFFYNOR

Συγχρονίστε παραγγελίες, κατάλογο και επιστροφές από το κατάστημά σας WooCommerce και αποδώστε τις πωλήσεις στις καμπάνιες σας (αναφορές κλικ και ttclid του TikTok) με αυτόματη συμφιλίωση.

1. Εγκατάσταση

1.1 Δημιουργία consumer keys (δικαιώματα Read/Write)

WooCommerce → Ρυθμίσεις → Για προχωρημένους → REST API → «Προσθήκη κλειδιού». Δικαιώματα: ανάγνωση/εγγραφή (η δημιουργία webhooks απαιτεί εγγραφή). Το κατάστημα πρέπει να είναι προσβάσιμο μέσω HTTPS.

1.2 Σύνδεση από την πλατφόρμα

Στο Κατάστημά μου → κάρτα WooCommerce, εισαγάγετε τη βασική διεύθυνση του καταστήματος, το consumer key και το consumer secret. Η σύνδεση επικυρώνεται αμέσως και παραμένει ενεργή.

1.3 Εγκατάσταση του snippet απόδοσης

Το snippet έχει δύο μέρη: το hook PHP (functions.php ή ένα code snippet) που εμφανίζει την παραγγελία στη σελίδα ευχαριστιών, και το JavaScript (GTM ή το theme) που καταγράφει την αναφορά και ενεργοποιεί το συμβάν αγοράς.

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>

Αντικαταστήστε το TU_SECRETO με το μυστικό pixel που εμφανίζεται στην κάρτα του συνδεδεμένου καταστήματος.

2. Απόδοση

Η παράμετρος affynor_ref της διεύθυνσης της διαφήμισης (ή το ttclid του TikTok) αποθηκεύεται σε cookie και επισυνάπτεται στην παραγγελία στη σελίδα ευχαριστιών. Το snippet αποθηκεύει επίσης το fbclid της Meta —στη μορφή fb.1.<στιγμή>.<fbclid>— ώστε η μετατροπή να μπορεί να αντιστοιχιστεί με το κλικ στη Meta. Το συμβάν παραμένει σε εκκρεμότητα και συμφιλιώνεται αυτόματα με τις συγχρονισμένες παραγγελίες: μόνο οι επαληθευμένες πωλήσεις αποδίδονται στις καμπάνιες σας.

3. Συγχρονισμός

Τα webhooks του WooCommerce (order.created, order.updated, product.created, product.updated) παραδίδουν τις αλλαγές σε πραγματικό χρόνο· ένας συγχρονισμός ασφαλείας διατρέχει το κατάστημα κάθε 10 λεπτά — μαζί με τις επιστροφές μέσω GET /orders/{id}/refunds — ώστε καμία παραγγελία να μη μένει ακαταχώριστη ακόμη κι αν αποτύχει το cron του WordPress.

4. Επιστροφές

Οι επιστροφές συγχρονίζονται αυτόματα και αφαιρούνται από τα έσοδα του μήνα που αποδόθηκαν. Μια πλήρως επιστραφείσα παραγγελία απορρίπτεται στη συμφιλίωση: δεν παράγει ποτέ προμήθεια.

5. Μοντέλο χρεώσεων

15% των εσόδων του μήνα που αποδόθηκαν, με ελάχιστο 129,90 €. Αν ο μήνας δεν έχει αποδοθείσες πωλήσεις, το ελάχιστο δεν εφαρμόζεται (ο 1ος μήνας είναι δωρεάν). Το ελάχιστο είναι ανά merchant ακόμη και με πολλά συνδεδεμένα καταστήματα (για παράδειγμα Shopify + WooCommerce).

6. Αντιμετώπιση προβλημάτων

Το webhook δεν φτάνει

Το cron του WordPress του merchant είναι απενεργοποιημένο ή καθυστερεί

Ελέγξτε το cron στο WP· στο μεταξύ ο συγχρονισμός ασφαλείας (κάθε 10 λεπτά) καλύπτει τις παραγγελίες. Τεκμηριωμένο στις Συχνές ερωτήσεις.

Υπογραφή webhook απορρίφθηκε (hmac_ok=0)

Η παραλλαγή υπογραφής (body έναντι delivery_url+body) ή το consumer secret δεν ταιριάζουν

Επανυπολογίστε το HMAC με το τρέχον consumer secret και δημιουργήστε ξανά το webhook με αυτό το μυστικό.

WOO_HTTP_401/403 στον συγχρονισμό

Το consumer key ανακλήθηκε ή δεν έχει δικαίωμα ανάγνωσης/εγγραφής

Δημιουργήστε ξανά το κλειδί στο WooCommerce και συνδεθείτε ξανά από την κάρτα.

Παραγγελία με ref χωρίς απόδοση

Το snippet δεν ενεργοποιήθηκε (adblock, cookie, σελίδα διαφορετική από τις ευχαριστίες)

Ελέγξτε το snippet στη σελίδα ευχαριστιών· το συμβάν μένει PENDING μέχρι να το συμφιλιώσει ο συγχρονισμός.

7. Κατάσταση και πορεία

Ο σύνδεσμος βρίσκεται σε επικύρωση με πιλοτικούς merchants: σύνδεση, απόδοση και συγχρονισμός ολοκληρωμένα (Φάσεις A–D)· η επικύρωση σε πραγματικά καταστήματα (Φάση E) είναι σε εξέλιξη. Η δημοσίευση ως επέκταση στο marketplace του WooCommerce είναι το επόμενο ορόσημο.