Οδηγός εγκατάστασης Google Shopping / Merchant XML Feed για WooCommerce
Πεδία προϊόντων, availability, εικόνες, τιμές και feed URL για Google Merchant Center.
Οδηγός εγκατάστασης: Google Shopping XML feed για WooCommerce
Ο οδηγός περιγράφει την εγκατάσταση και τη ρύθμιση του plugin OBS Google Shopping XML και τη σύνδεση του feed με το Google Merchant Center. Την εγκατάσταση την κάνει δωρεάν η OBS. Τα βήματα είναι εδώ για να ξέρετε τι ελέγχεται.
Προαπαιτούμενα
- Λογαριασμός Google Merchant Center με επαληθευμένο και διεκδικημένο domain, στοιχεία επιχείρησης και πολιτικές αποστολής και επιστροφών.
- WordPress 6.0+, WooCommerce 6.5+, PHP 8.1+. Προτείνεται PHP memory limit τουλάχιστον 256M (το plugin το δείχνει στην κάρτα PHP Memory Limit).
- Πρόσβαση για server cron (cPanel, Plesk ή SSH) για αξιόπιστη ανανέωση.
- Καθαρά δεδομένα προϊόντων: τίτλοι χωρίς κεφαλαία παντού, κύρια εικόνα, τιμή, brand και EAN/MPN όπου υπάρχουν.
- Το License key από τον λογαριασμό σας στην OBS Technologies.
- Backup του site πριν από την εγκατάσταση.
Εγκατάσταση και License key
- WordPress → Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση. Ανεβάστε το ZIP και πατήστε Ενεργοποίηση.
- Ανοίξτε WooCommerce → OBS Google Shopping XML.
- Στο πλαίσιο «Activate OBS Google Shopping XML for Update» επικολλήστε το κλειδί στο Enter Validation Key και πατήστε Activate. Το κλειδί αντιστοιχεί σε ένα domain και ενεργοποιεί τις αυτόματες ενημερώσεις.
Χάρτης ρυθμίσεων
Overview
- XML Feed Export: κατάσταση τελευταίας παραγωγής.
- Feed URL: εμφανίζεται μετά την πρώτη παραγωγή. Το αρχείο αποθηκεύεται στο
/wp-content/uploads/obs-xml-export/google_shopping.xml. - Actions: Generate feed now (πλήρες feed) και Quick test export (δείγμα).
- Scheduling: κατάσταση προγραμματισμού και «Show server cron command» με την έτοιμη εντολή crontab.
- PHP Memory Limit: έλεγχος διαθέσιμης μνήμης.
Required Setup
- Update Frequency: Hourly, Twice a day, Daily (προεπιλογή Daily).
- Mode: Bulk (προεπιλογή), Cron ή Chunk. Το Chunk χωρίζει την παραγωγή σε τμήματα για μεγάλους καταλόγους. Το Default Page Size (προεπιλογή 500) ορίζει το μέγεθος τμήματος.
- Color Attributes και Size Attributes: τα attributes που γράφονται σε
g:colorκαιg:size. - Default Brand και Brand Attribute: πηγή του
g:brand. - Product Description: Short Description (προεπιλογή) ή Full Description.
- Skip Out-of-Stock Products και Skip Backordered Products.
- Product Name Composer: σύνθεση του τίτλου.
Availability
- In Stock / Out Of Stock / Backorder Taxonomy και Default In-Stock / Out-of-Stock / Backorder Availability: πηγή και κείμενα διαθεσιμότητας. Στο Google feed η διαθεσιμότητα γράφεται ως
in stockήout of stock.
Filters
- Include Categories, Exclude Categories, Include Brands, Exclude Brands.
Overrides (Custom Fields Overrides)
- Custom Meta field for Brand / Product ID / Barcode / MPN / EAN / Availability / Weight: meta keys όταν τα δεδομένα βρίσκονται σε custom πεδία. Για Product ID, MPN και EAN η προεπιλογή είναι
_sku. - Skip product meta: εξαιρεί προϊόντα που έχουν τιμή στο συγκεκριμένο meta field.
Advanced
- Test Export Product Limit (προεπιλογή 10) και Test Export SKU Filter (ένα SKU ανά γραμμή) για το Quick test export.
- Category Export Mode:
google_product_category(προεπιλογή) ήproduct_type.
Κατηγορίες και μεμονωμένα προϊόντα
- Settings → OBS Google XML Category Mapping (ή το link «Map Categories for XML Output»): αντιστοίχιση κάθε κατηγορίας WooCommerce με κατηγορία Google. Η ίδια επιλογή («Select Google Shoppping Category») υπάρχει και στην επεξεργασία κάθε κατηγορίας.
- Στην καρτέλα προϊόντος, το πλαίσιο OBS Google Shopping XML Product Visibility με την επιλογή «Hide from OBS Google Shopping XML» εξαιρεί το προϊόν από το feed.
Δοκιμή και validation του feed
- Ορίστε στο Test Export SKU Filter 3–5 αντιπροσωπευτικά SKUs: απλό προϊόν, μεταβλητό, σε προσφορά, εκτός αποθέματος.
- Πατήστε Quick test export και ανοίξτε το αρχείο. Ελέγξτε τιμή με ΦΠΑ και «EUR», sale price μόνο στις προσφορές, item_group_id στις παραλλαγές, εικόνες με HTTPS και αριθμητικό google_product_category.
- Πατήστε Generate feed now και ανοίξτε το Feed URL. Πρέπει να επιστρέφει XML (HTTP 200), όχι σελίδα σφάλματος.
- Στο Merchant Center προσθέστε πηγή προϊόντων από αρχείο με το Feed URL και scheduled fetch.
- Μετά την πρώτη λήψη ελέγξτε τα Diagnostics και συγκρίνετε 2–3 προϊόντα με το eshop.
- Αλλάξτε ελεγχόμενα μια τιμή, ξαναδημιουργήστε το feed και επιβεβαιώστε την αλλαγή.
Go-live checklist
- License key ενεργό στο σωστό domain.
- Όλες οι κατηγορίες με προϊόντα έχουν mapping σε κατηγορία Google.
- Brand και EAN/MPN τροφοδοτούνται από τα σωστά πεδία.
- Server cron προστέθηκε και η κάρτα Scheduling δείχνει «Scheduled».
- Το Feed URL είναι προσβάσιμο από τη Google (χωρίς 403 από firewall/CDN).
- Scheduled fetch ενεργό στο Merchant Center και Diagnostics χωρίς μαζικές απορρίψεις.
Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Αιτία | Λύση |
|---|---|---|
| Λίγα προϊόντα ή μικρό αρχείο | Διακοπή παραγωγής (μνήμη, timeout, fatal error) ή φίλτρα | PHP memory 256M+, Mode «Chunk», server cron, έλεγχος Filters και log. |
| «Critical error» στο Generate | Παλαιότερη έκδοση σε νεότερη PHP | Ενημέρωση plugin, έλεγχος debug.log, ticket με το σφάλμα. |
| «Invalid price» στο Merchant Center | Παλαιότερη μορφή τιμής ή μηδενικό sale price | Έκδοση 1.0.5+ και έλεγχος κανονικών τιμών. |
| Κενή ή λάθος κατηγορία Google | Κατηγορίες χωρίς mapping | OBS Google XML Category Mapping ή Category Export Mode «product_type». |
| Shortcodes στην περιγραφή | Αφαιρείται το HTML αλλά όχι τα shortcodes | Short description ή filter στο obs_google_shopping_xml_custom_description. |
| Σφάλμα 403 κατά τη λήψη | Firewall/WAF/CDN μπλοκάρει τη Google | Άδεια πρόσβασης στο /wp-content/uploads/obs-xml-export/. |
| Παλιές εικόνες/τιμές στο Merchant Center | Δεν τρέχει cron ή αραιή λήψη | Server cron και συχνότερο scheduled fetch. |
| Δεν βρίσκω το EAN/GTIN | EAN σε custom meta | Custom Meta field for EAN και g:gtin μέσω append filter. |
Στο ticket προς την OBS στείλτε εκδόσεις WordPress, WooCommerce, PHP και plugin, την ώρα της παραγωγής και 2 κωδικούς προϊόντων με το σφάλμα. Μη στέλνετε κωδικούς πρόσβασης μέσα στο μήνυμα.
Βήματα εγκατάστασης
-
Βήμα 1
Feed endpoint
Ενεργοποιούμε το XML feed και επιβεβαιώνουμε ότι το URL απαντά.
-
Βήμα 2
Product fields
Ελέγχουμε title, price, availability, εικόνες και identifiers.
-
Βήμα 3
Sample validation
Περνάμε δείγμα προϊόντων από έλεγχο πριν δοθεί στο Merchant Center.
Συχνές ερωτήσεις
Είναι ίδιο με Skroutz XML;
Όχι. Η λογική μοιάζει, αλλά το Google Merchant έχει διαφορετικά πεδία, policies και validation.
Χρειάζεται Google Merchant account;
Ναι, το feed URL πρέπει να συνδεθεί στο Merchant Center του πελάτη.