המפרט של Atom 1.0

מאמר זה מספק הנחיות ליצירת פיד נתוני מוצרים מסוג XML בפורמט Atom 1.0. כדי לעזור לכם למצוא מידע נוסף על הרכיבים שבדוגמאות שלנו, קישרנו את המאפיינים הסטנדרטיים לסעיפים המתאימים במפרט הרשמי של Atom 1.0. הבאנו דוגמאות לקבצים בפורמט Atom 1.0, אבל מעט מאוד פרטים לגבי פורמט Atom 1.0 עצמו. למידע נוסף על התקן הזה, מומלץ לעיין במפרט של פורמט ההפצה של Atom.

אפשר להוריד מכאן קובץ לדוגמה בפורמט Atom 1.0.

סעיף 1: מפרט Atom 1.0

לפי המפרט של Atom 1.0, יש 5 רכיבים שמוגדרים מראש ברמת הרשומה - שם מוצר (title), מזהה (id) קישור (link) תקציר (summary) ועדכון אחרון (updated). הרכיבים האלה הם אופציונליים בתקן Atom 1.0, אבל הם שדות חובה בפידים של נתוני מוצרים.

בנוסף, בפידים של נתוני מוצרים צריך רכיבים נוספים, כמו מחיר (price) ומצב (condition). כדי לאפשר לכם לכלול פרטים נוספים על המוצרים, הרחבנו את Atom 1.0 על ידי הוספת מרחב השמות של Google Merchant Center. הגדרת מרחב השמות של Google Merchant Center מאפשרת להשתמש ברכיבים נוספים שנקראים "מאפיינים", ומאפשרת להוסיף יותר מידע לגבי כל מוצר בפיד.

לפניכם דוגמה למסמך בסיסי בפורמט Atom 1.0 שמכיל פריט אחד:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"

xmlns:g="http://base.google.com/ns/1.0">
<title>השם של פיד הנתונים</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry> 
<title>סוודר צמר אדום</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>סוודר רך ונוח שיחמם אתכם בלילות החורף הקרים.</summary> 

<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</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 1.0. הקידומת שנבחרה בהצהרת מרחב השמות הזו היא ‎"g":‎

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

המאפיינים במרחב השמות של Google Merchant Center חייבים לכלול את הקידומת הזו. אחרת, המערכת תתעלם מהמאפיינים ומהערכים שהם כוללים.

מאפיינים

אפשר להשתמש בכל המאפיינים הרלוונטיים שמתאימים למוצרים שלכם. כדאי להשתמש במאפיינים האלה כדי להוסיף מידע על המוצרים שלכם ולהגדיל את הסיכוי שהמוצרים יופיעו בתוצאות החיפוש. בנוסף, בהרבה מהמאפיינים שמוגדרים במרחב השמות של Google Merchant Center אפשר להשתמש יותר מפעם אחת בתוך כל מוצר. כך אפשר להוסיף עוד מידע שיש לכם לגבי כל מוצר בפיד.

סעיף 2: בדיקות חשובות

לפני ששולחים את הפיד, מומלץ מאוד לעבור על הרשימה הבאה כדי לוודא שהקובץ בפורמט הנכון:

1. שם הקובץ צריך להסתיים בסיומת xml.
2. שם הקובץ של הפיד הרשום בחשבון Google Merchant Center צריך להתאים לשם שנתתם לקובץ.
3. מוסיפים הצהרות של מרחבי שמות. הערכים האלה צריכים להיות זהים, כמו בדוגמאות הבאות.
   1. מרחב השמות של Google Merchant Center: ‏‎xmlns:g="http://base.google.com/ns/1.0".‎
   2. מרחב שמות של מאפיינים מותאמים אישית: xmlns:[prefix]="http://base.google.com/cns/1.0"‎. צריך להחליף את [prefix] בקידומת שצוינה בקובץ.
4. מוודאים שהקידומת הכלולה בתגי המאפיינים של Google Merchant Center ובתגי המאפיינים המותאמים אישית של Google Merchant Center תואמת לקידומת שהוגדרה בהצהרת מרחב השמות.
5. מסירים את המאפיינים שאינם מכילים ערכים.

סעיף 3: סיכום

מטרת המסמך הזה היא לעזור לכם להבין את העקרונות הבסיסיים של יצירת פיד נתוני מוצרים מסוג XML עבור Google Merchant Center. לכן, השתמשנו בדוגמה הפשוטה ביותר. אנחנו מקבלים פידים שמכילים רכיבים אחרים שהוגדרו בתקן Atom 1.0 או במרחב שמות משלכם, אבל במהלך העיבוד המערכת תתעלם מהמידע שמופיע ברכיבים האלה, והוא לא יופיע במודעות או בכרטיסי המוצר החינמיים שלכם. בשלב זה, אנחנו מעבדים רק נתונים שנכללים ברכיבי ברירת המחדל של Atom 1.0 ובמאפיינים שנכללים במרחב השמות של Google Merchant Center או במרחב שמות מותאם אישית של Google Merchant Center.