במאמר הזה אנחנו מפרטים את ההנחיות ליצירת מקור נתוני מוצרים מסוג XML בפורמט Atom 0.3. קישרנו את המאפיינים הסטנדרטיים לסעיפים המתאימים במפרט הרשמי של Atom 0.3 כדי לעזור לכם למצוא מידע נוסף על הרכיבים שמוצגים בדוגמאות שלנו. הבאנו דוגמאות לקבצים בפורמט Atom 0.3, אבל מעט מאוד פרטים לגבי פורמט Atom 0.3 עצמו.
סעיף 1: מפרט Atom 0.3
לפי המפרט של Atom 0.3, יש 4 רכיבים מוגדרים מראש ברמת הרשומה – שם פריט (title), קישור (link), מזהה (id) ותאריך שינוי (modified). הרכיבים האלה אופציונליים בתקן Atom 0.3, אבל הם שדות חובה במקור נתוני המוצרים.
במקורות נתוני מוצרים נדרשים גם רכיבים נוספים, כמו price (מחיר) ו-condition (מצב). כדי לכלול את הרכיבים האלה ומידע מפורט יותר לגבי מוצרים מסוימים, הרחבנו את Atom 0.3 על ידי הוספת מרחב השמות של Google Merchant Center. הגדרת מרחב השמות של Google Merchant Center מאפשרת להשתמש ברכיבים נוספים שנקראים 'מאפיינים', וכך להוסיף יותר מידע לגבי כל מוצר במקור נתוני מוצרים.
זוהי דוגמה למסמך Atom 0.3 בסיסי שיש בו מוצר אחד:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
xmlns:g="http://base.google.com/ns/1.0"><title>השם של מקור הנתונים</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>סוודר צמר אדום</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>סוודר רך ונוח שיחמם אתכם בלילות החורף הקרים.</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>
<g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition> </entry> </feed>
בדוגמה הזו, התוספות העיקריות הן הצהרת מרחב השמות (בשורה השלישית) ושלושת המאפיינים הנוספים (קישור לתמונה [image_link], מחיר [price] ומצב [condition]).
הצהרת מרחב השמות של Google Merchant Center
הצהרת מרחב השמות הבאה נדרשת כדי להשתמש במאפיינים שמוגדרים רק במרחב השמות של Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
בנוסף להצהרת מרחב השמות של Google Merchant Center, צריך להוסיף גם קידומת בתוך כל תג מאפיין. הוספת הקידומת למאפיינים מאפשרת לנו להבחין בין מאפיינים שמוגדרים במרחב השמות שלנו לבין רכיבים שמוגדרים ב-Atom 0.3. הקידומת שנבחרה בהצהרת מרחב השמות הזו היא "g":
<g:image_link>http://www.example.com/image1.jpg</g:image_link>המאפיינים במרחב השמות של Google Merchant Center חייבים לכלול את הקידומת הזו. אחרת, המערכת תתעלם מהמאפיינים ומהערכים שהם כוללים.
מאפיינים
אפשר להשתמש בכל המאפיינים הרלוונטיים שמתאימים למוצרים שלכם. כדאי להשתמש במאפיינים האלה כדי להוסיף מידע על המוצרים שלכם ולהגדיל את הסיכוי שהמוצרים יופיעו בתוצאות החיפוש. בנוסף, בהרבה מהמאפיינים שמוגדרים במרחב השמות של Google Merchant Center אפשר להשתמש יותר מפעם אחת בתוך כל מוצר. כך אפשר להוסיף עוד מידע שיש לכם לגבי כל מוצר במקור נתוני המוצרים.
סעיף 2: בדיקות חשובות
לפני ששולחים את מקור נתוני המוצרים, מומלץ מאוד לעבור על הרשימה הבאה כדי לוודא שפורמט הקובץ תקין.
שם הקובץ צריך להסתיים בסיומת xml.
שם הקובץ של מקור נתוני המוצרים שרשום בחשבון Google Merchant Center צריך להיות זהה לשם שנתתם לקובץ.
אל תשכחו להוסיף הצהרות של מרחבי שמות. הערכים האלה צריכים להיות זהים, כמו בדוגמאות הבאות.
- מרחב השמות של Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - מרחב שמות של מאפיינים מותאמים אישית:
xmlns:[prefix]="http://base.google.com/cns/1.0". צריך להחליף את [prefix] בקידומת שצוינה בקובץ.
חשוב לוודא שהקידומת שמופיעה בתגי המאפיינים של Google Merchant Center ובתגי המאפיינים המותאמים אישית של Google Merchant Center זהה לקידומת שהוגדרה בהצהרת מרחב השמות.
צריך להסיר את המאפיינים שאין להם ערכים.
סעיף 3: סיכום
הרשומה לדוגמה שצוינה במסמך הזה מופיעה בצורתה הפשוטה ביותר כדי לעזור לכם להבין את העקרונות הבסיסיים של יצירת מקור נתוני מוצרים בפורמט XML בשביל Google Merchant Center. אמנם אנחנו מקבלים מקורות נתוני מוצרים שיש בהם רכיבים אחרים שהוגדרו בתקן Atom 0.3 או במרחב שמות משלכם, אבל במהלך העיבוד המערכת תתעלם מהמידע שנמצא ברכיבים האלה, והוא לא יופיע בכרטיסי המוצר שלכם. בשלב זה, אנחנו מעבדים רק נתונים שנמצאים ברכיבי ברירת המחדל של Atom 0.3 ובמאפיינים שהם חלק ממרחב השמות של Google Merchant Center או ממרחב שמות מותאם אישית של Google Merchant Center.