פורמטים נתמכים של קבצים

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

הוראות ליצירת קובץ מופרד בטאבים

קבצים עם ערכים מופרדים בטאבים, או קובצי TSV – זה אחד משני הפורמטים הנתמכים של קבצים ב-Manufacturer Center. רוב קובצי ה-TSV נוצרים באמצעות תוכנות של גיליונות אלקטרוניים. מציינים את שמות המאפיינים בשורה הראשונה (הכותרת) ומפרידים ביניהם באמצעות טאב. לאחר מכן, החל מהשורה השנייה, מזינים את הערכים המתאימים מתחת לכל שם מאפיין. כדי ליצור ולשמור קבצים מופרדים בטאבים, מומלץ להשתמש בתוכנת גיליונות אלקטרוניים כגון Google Sheets או LibreOffice.

יצירת קובץ נתונים

שלב 1: פותחים את תוכנת הגיליונות האלקטרוניים

משתמשים בתוכנת גיליונות אלקטרוניים כגון Google Sheets. כך קל ליצור קובץ נתונים ולהמיר אותו לפורמט הנכון.

שלב 2: יוצרים שורת כותרת

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

דוגמה לשימוש במאפיינים בשורת הכותרת:

	A	B	C	D	E	F
1	מזהה [id]	מותג [brand]	שם הפריט [title]	מספר פריט מסחרי גלובלי (GTIN) ‏[gtin]	תיאור [description]	קישור לתמונה [image_link]

 

שלב 3: מזינים מידע על הפריט

בשורות שמתחת לשורת הכותרת, מזינים מידע על הפריטים בהתאם למאפיינים שבחרתם. מזינים כל פריט בשורה נפרדת, ואת הפרטים שלו בעמודות המתאימות. (לדוגמה, תיאור של מוצר צריך להיות בעמודה עם הכותרת 'תיאור').

	A	B	C	D	E	F
1	מזהה [id]	מותג [brand]	שם הפריט [title]	מספר פריט מסחרי גלובלי (GTIN) [gtin]	תיאור [description]	קישור לתמונה [image_link]
2	‎123-yelbr	צעצועי Acme	צעצועי Acme – דובון צהוב	001234567890	תיאור לדוגמה	link.com/pic
3	‎456-redbr	צעצועי Acme	צעצועי Acme – דובון אדום	001234598760	תיאור לדוגמה	link.com/pic

 

שלב 4: ממירים את הגיליון האלקטרוני

רוב התוכנות של גיליונות אלקטרוניים מאפשרות לייצא את הנתונים לקובץ מופרד בטאבים. כדי ליצור קובץ בסיומת tsv. אפשר להשתמש באחת משתי האפשרויות שלמטה. זה הקובץ שצריך לשלוח ל-Manufacturer Center.

אם משתמשים ב-Google Sheets:

• בתפריט קובץ, בוחרים באפשרות הורדה כ ואז בוחרים ערכים מופרדים בטאב (‎.tsv, הגיליון הנוכחי). קובץ הטקסט המופרד בטאבים יוצג בחלון חדש.
• נותנים שם לקובץ. חשוב לבחור בסוג הקובץ ‎.tsv, אם יש אפשרות כזו. לוחצים על שמירה.

אם משתמשים ב-LibreOffice:

• בוחרים באפשרות File > Save as…‎ (קובץ > שמירה בשם…).
• בוחרים בפורמט Text CSV (.csv)‎. האפשרות מציינת שמדובר בקובץ CSV, אבל היא יוצרת בפועל קובצי טקסט מסוגים שונים.
• מסמנים את האפשרות Edit filter settings (עריכה של הגדרות המסנן). לוחצים על Save (שמירה). אם מופיעה אזהרה, ממשיכים עם הפורמט Text CSV.
• בחלון הקופץ שנפתח, משאירים את האפשרות Character set (מערכת תווים) כ-Unicode (UTF-8)‎. משנים את Field delimiter (תו מפריד בין שדות) ל-{Tab} בעזרת התפריט הנפתח. מוחקים את הערך ב-Text delimiter (תו מפריד בין טקסט). משאירים את שאר תיבות הסימון כפי שהן ולוחצים על OK (אישור).

אם כבר רשמתם פיד בחשבון Manufacturer Center, מומלץ להשתמש באותו שם קובץ שציינתם בתהליך ההגדרה.

שלב 5: שולחים את הקובץ דרך פיד נתונים

בודקים שהקובץ עומד בדרישות המפורטות בהמשך בנוגע לפורמט ושולחים אותו אלינו.

הדרישות בנוגע לפורמט

• הקובץ צריך להיות מופרד בטאבים.
• השורה הראשונה בקובץ היא הכותרת – היא צריכה להכיל שמות מאפיינים מופרדים בטאבים.
• פריט אחד בכל שורה – כל המאפיינים בשורה הזו צריכים להיות מופרדים בטאבים.
• אסור להוסיף טאבים בסופי שורות.
• אסור לכלול טאבים או מעברי שורה בתוך המאפיינים עצמם.

הפורמט של מאפיינים חוזרים

המאפיינים הבאים הם מאפיינים חוזרים:

• מספר פריט מסחרי גלובלי (GTIN) ‏[gtin]
• סוג המוצר [product_type]
• קישור לתמונה נוספת [additional_image_link]
• קישור לסרטון [video_link]

 

מאפיין חוזר הוא מאפיין שמקבל יותר מערך אחד.

• כדי להפריד בין הערכים של מאפיין חוזר משתמשים בפסיקים.
  • מספר פריט מסחרי גלובלי (GTIN) ‏[gtin]
    001234567898, 001234567876
• אם ערך של מאפיין חוזר מכיל פסיק, צריך לתחום אותו במירכאות כפולות ישרות.
  • סוג המוצר [product_type]
    "לבית ולגינה > מטבח ופינת אוכל > מוצרי חשמל > מקרר", מוצרי חשמל לבית > מטבח > מקרר
• אם ערך שתחום במירכאות מכיל מירכאות כפולות, צריך להכפיל אותן.
  • "מסך טאבלט חד בגודל ‎7‎""‎ ‏(323 פיקסלים לאינץ')", "סוללה שמחזיקה מעמד לאורך זמן, עד 9-10 שעות של שימוש פעיל", מהירות וביצועים של ארבע ליבות עם RAM בנפח 2GB, מגיע עם Android 4.3

 

המאפיינים הבאים הם מאפיינים קבוצתיים חוזרים:

• פרטי המוצר [product_detail]
• תיאור תכונות [feature_description]

מאפיין קבוצתי הוא מאפיין שכולל מאפייני משנה.

• למאפיין פרטי המוצר יש שלושה מאפייני משנה:
  • שם הענף [section_name]
  • שם המאפיין [attribute_name]
  • ערך המאפיין [attribute_value]
• גם למאפיין תיאור התכונות יש שלושה מאפייני משנה:
  • כותרת [headline]
  • טקסט [text]
  • קישור לתמונה [image_link]

כדי לציין מאפיין קבוצתי, מספקים ערכים לכל מאפייני המשנה שלו כשהם מופרדים בנקודתיים.

• פרטי המוצר
  מסך:רזולוציה:1200x1920
• בדומה למאפיינים חוזרים רגילים, כשמספקים ערכים של כמה מאפיינים קבוצתיים צריך להפריד ביניהם בפסיק.
  • פרטי המוצר
    מסך:רזולוציה:1200x1920,מסך:משקל:8 קילו
• בדומה למאפיינים חוזרים, צריך לתחום במירכאות כפולות ישרות ערכים שמכילים פסיק וערכים שמכילים נקודתיים. כמו כן, יש להכפיל מירכאות שמופיעות בתוך ערכים שתחומים במירכאות.
  • תיאור תכונות [feature_description]
    זום משופר עם הגרסה החדשה:הדור החדש מגיע עם זום משופר שבעזרתו תוכלו לראות יותר מהעולם סביבכם.:"http://example.com/image1.png",רזולוציה חדה יותר:"המוצר מגיע עם צג ‎15""‎ חד פי 10 מהגרסאות הקודמות, ועם זום שמגדיל פי 3.5.":"http://example.com/image2.jpg"

כאן אפשר לראות דוגמה: תבנית קובץ ל-Manufacturer Center ‏– TSV.tsv.

הוראות ליצירת קובץ XML

XML ‏‏(Extensible Markup Language) מספק מסגרת גמישה לקידוד נתונים מובְנים בפורמט שגם אנשים וגם מחשבים יכולים לקרוא. אם יש לכם מערכת לניהול פרטי מוצרים (PIM) עם יכולות ייצוא מתקדמות, Google ממליצה להשתמש בקובצי XML.

Google תומכת בגרסה מורחבת של RSS 2.0 עם מאפיינים סטנדרטיים המקושרים לסעיפים המתאימים במפרט הרשמי של RSS 2.0, כדי לעזור לכם למצוא מידע נוסף על הרכיבים שמוצגים בדוגמאות שלנו. Google מספקת דוגמאות לקובצי RSS 2.0, אבל אנחנו מספקים פרטים מינימליים לגבי RSS 2.0 עצמו. מידע נוסף על התקן הזה זמין בכתובת http://blogs.law.harvard.edu/tech/rss.

סעיף 1: מפרט RSS 2.0

לפי המפרט של RSS 2.0, יש שלושה רכיבים מוגדרים מראש ברמת המוצר – שם מוצר (title), קישור (link) ותיאור (description). הרכיבים האלה הם אופציונליים בתקן RSS 2.0, אבל הם שדות חובה בפידים של נתוני מוצרים.

בפידים של נתוני מוצרים נדרשים גם רכיבים נוספים, כגון מזהה [id], מותג [brand] ו-GTIN ‏[gtin]. כדי לכלול את הרכיבים האלה ומידע מפורט יותר לגבי מוצרים מסוימים, Google הרחיבה את פורמט RSS 2.0 על ידי הוספת מרחב השמות של הפיד של Manufacturer Center. הגדרת מרחב השמות של Manufacturer Center מאפשרת להשתמש ברכיבים נוספים שנקראים "מאפיינים", ומאפשרת להוסיף יותר מידע לגבי כל מוצר בפיד.

דוגמה למסמך בסיסי בפורמט RSS 2.0 שמכיל מוצר אחד:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Acme Inc</title>
    <link>http://www.amce.com</link>
    <description>פיד לדוגמה של קו המוצרים של Acme Inc‏</description>
    <item>
      <g:id>actb7-16-B</g:id>
      <g:brand>Acme</g:brand>
      <g:title>טאבלט של Acme‏ - WiFi‏ - 16GB - שחור</g:title>
      <g:gtin>001234567895</g:gtin>
      <g:gtin>1001234567894</g:gtin>
      <g:mpn>ACMETAB16</g:mpn>
      <g:disclosure_date>2013-01-15</g:disclosure_date>
      <g:release_date>2013-03-04</g:release_date>
      <g:suggested_retail_price>USD 129.00</g:suggested_retail_price>
      <g:product_name>AcTab 7</g:product_name>
      <g:product_line>AcTab</g:product_line>
      <g:product_type>מכשיר &gt; מחשב טאבלט</g:product_type>
      <g:product_type>מחשב &gt; מחשב טאבלט</g:product_type>
      <g:item_group_id>AcTab-7-2013</g:item_group_id>
      <g:color>שחור</g:color>
      <g:product_detail>
        <g:section_name>כללי</g:section_name>
        <g:attribute_name>סוג מוצר</g:attribute_name>
        <g:attribute_value>נגן דיגיטלי</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name>כללי</g:section_name>
        <g:attribute_name>סוג נגן דיגיטלי</g:attribute_name>
        <g:attribute_value>מבוסס Flash‏</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name>צג</g:section_name>
        <g:attribute_name>רזולוציה</g:attribute_name>
        <g:attribute_value>432‎ x‎ 240‎</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name>צג</g:section_name>
        <g:attribute_name>גודל אלכסוני</g:attribute_name>
        <g:attribute_value>‏2.5 אינץ'</g:attribute_value>
      </g:product_detail>
      <g:description>עכשיו בגרסה דקה, קלה ומהירה יותר – AcTab מספק שילוב מושלם של עוצמה וניידות וכולל מסך חד וברור בגודל 7 אינץ'.</g:description>
      <g:feature_description>
        <g:headline>מסך בגודל 7 אינץ' עם חדות מדהימה.</g:headline>
        <g:text>טאבלט בגודל 7 אינץ' עם רזולוציה גבוהה במיוחד של יותר מ-2.3 מיליון פיקסלים.</g:text>
        <g:image_link>http://www.acme.com/actab7/screen</g:image_link>
      </g:feature_description>
      <g:feature_description>
        <g:headline>צליל מקיף וסוחף.</g:headline>
        <g:text>‏AcTab7 כולל שני רמקולי סטריאו שמפיקים אודיו עשיר וסוחף. הודות לטכנולוגיית הגברה מכווננת היטב תוכלו לשמוע הכול בצורה ברורה יותר. קולות דיבור וצלילים נשמעים חדים ונעימים יותר לאוזן.</g:text>
        <g:image_link>http://www.acme.com/actab7/sound</g:image_link>
      </g:feature_description>
      <g:feature_description>
        <g:headline>קל מתמיד, ועם סוללה שמחזיקה מעמד למשך זמן רב יותר.</g:headline>
        <g:text>ה-AcTab החדש שוקל 300 גרם בלבד, כך שאפשר לשאת אותו בקלות לכל מקום בתיק יד, בתיק גב ואפילו בכיס האחורי. עם עד 9 שעות של הפעלת וידאו באיכות HD ו-10 שעות של גלישה באינטרנט או קריאת ספרים אלקטרוניים, תוכלו ליהנות ממנו במשך יום שלם. טעינה אלחוטית מובנית מאפשרת לטעון את המכשיר, לקחת אותו ולצאת לדרך.</g:text>
        <g:image_link>http://www.acme.com/actab7/battery</g:image_link>
      </g:feature_description>
      <g:image_link>https://acme.com/actab7.png</g:image_link>
      <g:additional_image_link>https://acme.com/actab7.png</g:additional_image_link>
      <g:additional_image_link>https://acme.com/actab7-front.png</g:additional_image_link>
      <g:additional_image_link>https://acme.com/actab7-back.png</g:additional_image_link>
      <g:video_link>https://www.youtube.com/watch?v=abc</g:video_link>
      <g:product_page_url>http://www.acme.com/actab</g:product_page_url>
    </item>
  </channel>
</rss>

שתי התוספות העיקריות בדוגמה הזו הן התוספת של הצהרת מרחב שמות [xmlns:g="http://base.google.com/ns/1.0] והתוספת של מאפייני Manufacturer Center, כגון GTIN‏ [gtin], קוד MPN ‏[mpn], מחיר מומלץ לצרכן [suggested_retail_price] ותאריך השקה [release_date].

הצהרת מרחב השמות של Manufacturer Center

כדי להשתמש במאפיינים שמוגדרים רק במרחב השמות של Manufacturer Center, צריך להשתמש בהצהרת מרחב השמות הבאה:[xmlns:g="http://base.google.com/ns/1.0"‎]

בנוסף להצהרת מרחב השמות של Manufacturer Center, צריך להוסיף גם קידומת בתוך כל תג מאפיין. הוספת הקידומת למאפיינים מאפשרת לנו להבחין בין מאפיינים שמוגדרים במרחב השמות שלנו לבין רכיבים שמוגדרים ב-RSS 2.0. הקידומת שנבחרה בהצהרת מרחב השמות הזו היא "g":‏ <g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

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

מאפיינים

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

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

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

1. שם הקובץ של הפיד הרשום בחשבון Manufacturer Center צריך להיות זהה לשם שנתתם לקובץ.
2. חשוב לכלול את הצהרת מרחב השמות הבאה: xmlns:g="http://base.google.com/ns/1.0"
3. מוודאים שהקידומת הכלולה בתגי המאפיינים של Manufacturer Center זהה לקידומת שהוגדרה בהצהרת מרחב השמות.
4. מסירים את המאפיינים שאינם מכילים ערכים.

סעיף 3: סיכום

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

דוגמה: Manufacturer Center file template - XML.xml.

כשיוצרים את קובץ הנתונים, חשוב לשמור אותו באחד מסוגי הקבצים הנתמכים עם סיומת שם הקובץ המתאימה:

• ‎.tsv: ערכים מופרדים בטאבים
• ‎‎.xml‎‏: ‏XML‏
• ‎.gz‎: ‏Gnu zip‏, טקסט או XML דחוסים
• ‎.zip‎: ‏Zip‏, טקסט או XML דחוסים
• ‎.bz2‎: ‏Bzip2‏, טקסט או XML דחוסים