עיצוב קבצים להעלאה

מאמר זה מסביר איך ליצור ולעצב קובצי CSV לייבוא.

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

במאמר זה:

שיקולים כלליים

  1. יש להעלות את קובצי הנתונים בפורמט CSV (ערכים מופרדים באמצעות פסיק).
  2. הכותרת של קובץ ה-CSV חייבת להתאים בדיוק לסכימה של מערך נתוני היעד. סדר העמודות חייב להיות זהה לזה שצוין בסכימה, וכל שמות העמודות צריכים להשתמש בשם המאפיין או הערך הפנימי של ‎ga., ולא בשם המשמש לתצוגה. (למשל, ga:source, ולא מקור.)
  3. יש להקפיד שמבנה הנתונים המיועדים להעלאה יהיה בפורמט הנכון. עיין בהמשך לקבלת פרטים.

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

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

השגת הסכימה

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

כדי להשיג את הסכמה של קבוצת הנתונים:
  1. כניסה אל Google Analytics.
  2. לחץ על מנהל מערכת ועבור אל הנכס שאליו ברצונך להעלות נתונים.
  3. בעמודה מאפיין, בחר את הנכס המכיל את קבוצת הנתונים שבה יאוחסנו הנתונים שלך.
  4. לחץ על ייבוא נתונים.
  5. לחץ על הקישור שם של מערך נתוני היעד.
  6. לחץ על הלחצן קבל סכימה (סמוך לתחתית הדף). כעת תופיע תיבת הדו שיח הבאה.

שימוש בעורך טקסט

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

ודא שהעורך שלך יוצר קובצי טקסט רגיל. אין להשתמש בעורכי טקסט עשיר, כגון Microsoft Word, אלא אם כן אתה שומר את הקבצים שלך באופן מפורש כטקסט רגיל (‎.txt). פורמט טקסט עשיר מכיל עיצוב נוסף ותווי בקרה שעלולים לגרום לשגיאות בייבוא.

שימוש בגיליון אלקטרוני

כדי להשתמש בגיליון אלקטרוני לאחסון הנתונים להעלאה, בצע את השלבים שלמעלה להשגת הסכימה של מערך הנתונים. לאחר מכן לחץ על הלחצן הורד את תבנית הסכימה. פעולה זו תמקם את כותרות הסכימה בספריית ההורדות שלך. לאחר מכן תוכל לפתוח את הסכימה בגליון האלקטרוני המועדף עליך. השתמש בפונקציית הייבוא (Import) של הגיליון האלקטרוני כדי להציג נתונים שברצונך להעלות. כאשר הקובץ מוכן להעלאה, השתמש בפונקציות שמירה בשם או ייצוא של תכנית הגיליון האלקטרוני שבה אתה משתמש, ובחר ב-CSV כפורמט הפלט.

עיצוב הנתונים להעלאה

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

פסיקים

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

abc123,29.99,Blue,XXL 
def345,100,Red,M
ghi678,1035.20,Green,S

במקרה זה, פונקציית ייבוא הנתונים מקבלת ארבע עמודות של נתונים:

abc123 29.99 Blue XXL
def345 100 Red M
ghi678 1035.20 Green S

אך מה יקרה אם נוסיף עוד פסיק לנתונים, לדוגמה על ידי קביעת פורמט מטבע לעמודת המספרים (על ידי הוספת פסיק לסימון מיקום האלפים, כך?

ghi678,1,035.20,Green,S

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

abc123 29.99 Blue XXL
def345 100 Red M
ghi678 1 035.20 Green S

מצב זה ייצור שגיאה כזאת:

“שגיאה: ספירת העמודות לא מתאימה"

מירכאות

ניתן להשתמש במירכאות כפולות כדי לבצע "escape" בערך של תא. בדרך כלל ערך של תא יוקף במרכאות אם הערך כולל פסיק. אחרת, ייבוא הנתונים יפרש את הפסיק כהתחלה של תא חדש (ראה למעלה).

דוגמה:

ghi678,"1,035.20",Green,S

הערך "1,035.20" יטופל כתא יחיד (עם זאת, ייבוא הנתונים יראה אותו כמחרוזת, לא כערך מטבע).

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

"שגיאה: פורמט CSV לא חוקי בשורה x."

מעברי שורה

מעברי שורה בתוך קובץ CSV משמשים כדי לציין התחלה של שורה חדשה. ייבוא הנתונים אינו תומך במעברי שורה בתוך תאים גם אם הם מוקפים במירכאות. מעברי שורה נוספים בתוך שורה יגרמו לשגיאה במספר העמודות בשורה זו או בשורות הבאות ותופיע הודעת שגיאה כזו:

"שגיאה: פורמט שורות לא חוקי ב-CSV"

השלבים הבאים

האם המידע הועיל?
איך נוכל לשפר את המאמר?