Οδηγοί
Οδηγός εγκατάστασης Linkwise XML Feed για WooCommerce
Ρύθμιση Linkwise product feed με σωστά affiliate δεδομένα, τιμές, stock, URLs και προγραμματισμένη ανανέωση.
Οδηγός εγκατάστασης Linkwise XML Feed για WooCommerce
Προαπαιτούμενα
- Συνεργασία advertiser με τη Linkwise και οι τρέχουσες προδιαγραφές του feed που σας έστειλε.
- Τα ZIP από τον λογαριασμό σας στην OBS: OBS Woo Export και OBS Feed Linkwise, και το License key.
- SKU στα προϊόντα, εικόνες σε δημόσια URLs και brand ή προεπιλεγμένος κατασκευαστής.
- Global χαρακτηριστικά (attributes) WooCommerce για χρώμα και μέγεθος, αν πουλάτε τέτοια προϊόντα.
- Πρόσβαση για ρύθμιση cron στον server ή στο control panel της φιλοξενίας.
Εγκατάσταση και License key
- Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου: ανεβάστε και ενεργοποιήστε πρώτα το OBS Woo Export.
- Ανεβάστε και ενεργοποιήστε το OBS Feed Linkwise.
- Ανοίξτε WooCommerce → OBS Woo Export και επικολλήστε το License key στο πεδίο «Enter Validation Key» του Linkwise. Πατήστε Activate.
Ρυθμίσεις
| Ρύθμιση | Τι κάνει |
|---|---|
| Περιγραφή | Ποια περιγραφή του προϊόντος στέλνεται. Αν τα κείμενά σας είναι στη σύντομη περιγραφή, βεβαιωθείτε ότι αυτή εξάγεται. |
| Χαρακτηριστικά χρώματος και μεγέθους | Από ποια attributes γεμίζουν το χρώμα και τα μεγέθη. |
| In Stock / Out Of Stock / Backorder Taxonomy | Τα κείμενα διαθεσιμότητας για απόθεμα, εξαντλημένα και προπαραγγελίες. |
| Μόνο διαθέσιμα προϊόντα | Αν τα εξαντλημένα προϊόντα μένουν έξω από το feed. |
| Προεπιλεγμένος κατασκευαστής | Γράφεται όταν το προϊόν δεν έχει brand. |
| Εξαιρέσεις | Προϊόντα που δεν θέλετε να δουν οι affiliates. |
Δοκιμή
- Παράγετε το XML από τη σελίδα του OBS Woo Export.
- Ανοίξτε το URL σε browser και από εξωτερικό δίκτυο: πρέπει να εμφανίζεται έγκυρο XML.
- Συγκρίνετε 3–5 προϊόντα (απλό, μεταβλητό, σε προσφορά, εξαντλημένο) με τη σελίδα τους.
- Αλλάξτε την τιμή ενός προϊόντος, ξαναπαράγετε και ελέγξτε ότι η αλλαγή πέρασε.
Go-live checklist
- Το feed έχει περάσει τον έλεγχο της Linkwise χωρίς ανοιχτές παρατηρήσεις.
- Τα links και οι κατηγορίες είναι στα ελληνικά, με πλήρη διαδρομή κατηγορίας.
- Το server cron τρέχει και το αρχείο ανανεώνεται.
- Το Linkwise Affiliate Advertiser είναι εγκατεστημένο και ελεγμένο με δοκιμαστική παραγγελία.
Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Αιτία | Λύση |
|---|---|---|
| Η Linkwise αναφέρει ότι λείπουν υποχρεωτικά στοιχεία (tags) από το feed. | Δεν έχουν οριστεί στη μηχανή τα χαρακτηριστικά ή τα πεδία από όπου διαβάζονται, π.χ. χρώμα, μέγεθος, brand ή EAN, ή η Linkwise έχει νέα απαίτηση. | Στείλτε μας τις παρατηρήσεις της Linkwise. Ορίζουμε τις πηγές των πεδίων και, αν χρειάζεται νέο στοιχείο, το προσθέτουμε στο feed. |
| Στο XML τα links και οι κατηγορίες είναι στα αγγλικά. | Πολύγλωσσο site (π.χ. WPML) όπου το feed παράγεται στη γλώσσα που δεν θέλετε. | Η παραγωγή πρέπει να γίνεται στα ελληνικά. Ελέγχουμε τη ρύθμιση γλώσσας της μηχανής και ξαναπαράγουμε. |
| Τα μεγέθη ενός μεταβλητού προϊόντος δεν εμφανίζονται ή εμφανίζεται μόνο μία εγγραφή. | Τα μεγέθη είναι τοπικά attributes του προϊόντος ή δεν έχει οριστεί το χαρακτηριστικό μεγέθους στη μηχανή. | Χρησιμοποιήστε global attributes και ορίστε το χαρακτηριστικό μεγέθους στη μηχανή. Ξαναπαράγετε το XML. |
| Το feed έχει πολύ λιγότερα προϊόντα από το κατάστημα. | Ενεργή εξαγωγή μόνο διαθέσιμων προϊόντων, εξαιρέσεις, ή προϊόντα που δεν είναι δημοσιευμένα. | Ελέγξτε τη ρύθμιση «μόνο διαθέσιμα» και τις εξαιρέσεις. Αν το πρόβλημα μένει, στείλτε μας δύο προϊόντα που λείπουν. |
| Η παραγωγή ή το cron σταματά με «count(): Argument #1 ($value) must be of type Countable|array, string given». | Παλιά έκδοση του πρόσθετου που δεν είναι συμβατή με PHP 8. | Ζητήστε μας την ενημερωμένη έκδοση. Μέχρι τότε το προηγούμενο αρχείο XML μένει όπως ήταν. |
| Η Linkwise ζητά escape ειδικών χαρακτήρων ή το XML δεν ανοίγει στον browser. | Περιγραφή ή τίτλος με χαρακτήρες ή HTML που σπάνε τη δομή του αρχείου. | Σημειώστε τη γραμμή του σφάλματος, διορθώστε το κείμενο του προϊόντος και ξαναπαράγετε. Αν επαναλαμβάνεται, επικοινωνήστε μαζί μας. |
| Μετά από αλλαγή permalinks το XML έχει τα παλιά URLs. | Τα links γράφονται τη στιγμή της παραγωγής. | Ξαναπαράγετε το XML ή περιμένετε το επόμενο cron. |
| Η Linkwise δεν μπορεί να κατεβάσει το feed και ζητά whitelist IP. | Firewall, plugin ασφαλείας ή Cloudflare μπλοκάρει τον server της Linkwise. | Επιτρέψτε την IP που σας έδωσε η Linkwise ή εξαιρέστε το αρχείο XML από τους κανόνες ασφαλείας. |
Βήματα εγκατάστασης
-
Βήμα 1
Feed specification
Καταγράφουμε τα required Linkwise fields και το product sample.
-
Βήμα 2
Εγκατάσταση
Εγκαθιστούμε το OBS plugin και καταγράφουμε το feed endpoint.
-
Βήμα 3
Mapping
Συνδέουμε IDs, URLs, εικόνες, τιμές, stock, brand και categories.
-
Βήμα 4
Validation
Ελέγχουμε XML, sample προϊόντων και Linkwise requirements.
-
Βήμα 5
Freshness
Τρέχουμε δεύτερο generation και συνδέουμε scheduler.
Συχνές ερωτήσεις
Είναι το ίδιο με το Linkwise advertiser tracking;
Όχι. Το XML feed στέλνει product catalog data· το advertiser plugin αφορά conversion tracking.
Περιλαμβάνονται sale prices;
Το mapping πρέπει να στέλνει την πραγματική τελική τιμή και ελέγχεται σε normal και sale sample.
Μπορώ να εξαιρώ προϊόντα;
Ναι, με κανόνες ανά προϊόν, category ή data quality όπου το επιτρέπουν οι ρυθμίσεις του feed.