מדריך למפתחים בנושא ייבוא נתונים

Google Analytics Management API מאפשר גישה פרוגרמטית לתכונה ייבוא נתונים של Google Analytics.

מבוא

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

שני המשאבים ב-Management API שמאפשרים ייבוא נתונים הם:

• המשאב מקור נתונים מותאם אישית, שנקרא 'מערך נתונים' בממשק האינטרנט, משמש כמאגר של הקבצים שהעלית. אוסף של מקורות נתונים מותאמים אישית מייצג את כל קבוצות הנתונים שמשויכות לנכס ב-Google Analytics.
• המשאב Upload, שמייצג קובץ שהועלה. אוסף של משאבי העלאה מייצג את כל הקבצים שהעליתם לקבוצת נתונים.

תרחישים לדוגמה

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

• ייבוא נתוני התאמות
  • נתוני החזרים כספיים
• ייבוא נתונים מורחבים
  • נתוני משתמש
  • נתוני קמפיין
  • נתונים גיאוגרפיים
  • נתוני תוכן
  • נתוני מוצרים
• ייבוא של נתוני סיכום
  • נתוני עלות

ייבוא נתוני התאמות

נתוני החזרים כספיים

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

כדי ללמוד כיצד לייבא נתונים של החזרים כספיים ל-Google Analytics, ראה דוגמה לייבוא נתוני החזרים כספיים.

ייבוא נתונים מורחבים

נתוני משתמשים

אפשר להעלות נתונים של משתמשים שלא מאפשרים זיהוי אישי מכלים חיצוניים של ניהול קשרי לקוחות (CRM) וליצור קהלים לרימרקטינג ב-Google Ads עבור פלחי המשתמשים החשובים ביותר לעסק.

בקישורים הבאים מוסבר איך לייבא נתוני משתמשים ל-Google Analytics כדי ליצור קהלים לרימרקטינג ב-Google Ads:

• ייבוא נתוני משתמשים כדי ליצור קהלים לרימרקטינג ב-Google Ads.

נתוני קמפיינים

אפשר לייבא נתוני קמפיינים ל-Google Analytics כדי להתאים אישית את הניתוח של ביצועי הקמפיינים לעסק.

הוראות לייבוא נתוני קמפיינים ל-Google Analytics מפורטות במאמר ייבוא נתוני קמפיין באמצעות ממשק ה-API לניהול.

נתונים גיאוגרפיים

אפשר לייבא מיפויים של מזהים גיאוגרפיים לאזורים, וכך לאפשר דוחות על נתוני Google Analytics לפי אזור מותאם אישית. לדוגמה, בארצות הברית ייתכן שאתם פועלים בקבוצות של מדינות במזרח, במרכז ובמערב אירופה. באירופה, ייתכן שאתם פועלים בקבוצות של מדינות בצפון, במרכז ובדרום אמריקה. כשמייבאים נתונים, אפשר להשתמש במפתחות ga:regionId, ga:cityId, ga:countryIsoCode או ga:subContinentCode כמפתחות. מזהי הערים ומזהי המדינות מפורטים בטבלת הטירגוט הגיאוגרפי. ניתן למצוא את קוד ה-ISO ואת קוד המשנה של המדינה בטבלאות ISO-3166-1 alpha-2 ו-UN M.49, בהתאמה.

למידע נוסף על ייבוא נתונים גיאוגרפיים, ראו דוגמה לייבוא נתונים גיאוגרפיים.

נתוני תוכן

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

כדי ללמוד איך לייבא נתוני תוכן ל-Google Analytics, אפשר לעיין בדוגמה לייבוא נתוני תוכן.

נתוני מוצרים

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

הוראות לייבוא נתוני מוצרים ל-Google Analytics מפורטות במאמר ייבוא נתוני מוצרים באמצעות ה-Management API.

ייבוא נתוני סיכום

נתוני עלות

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

למידע נוסף על ייבוא נתוני עלות ל-Google Analytics, אפשר לעיין במאמר ייבוא נתוני עלות באמצעות ממשק ה-API לניהול.

מושגים

סטטוס עיבוד

לאחר העלאת קובץ, סטטוס ההעלאה יהיה PENDING עד שההעלאה אומתה ותעובד. אם העיבוד יושלם בהצלחה, הסטטוס ישתנה ל-COMPLETED.

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

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

הערה: מדי פעם אפשר לשלוח שאילתות ב-Management API כדי להציג את ההעלאות ולבדוק את השדה status.

סיכום נתוני עלות לעומת החלפה

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

• summation (ברירת מחדל) – הנתונים החדשים יתווספו לכל נתוני ההתאמה הקודמים והמדדים יסוכמו.
• overwrite – הנתונים החדשים יחליפו את כל הנתונים התואמים הקודמים.

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

סיכום ברמת השורה של נתוני עלות לעומת החלפה

אפשר גם לשנות את ההתנהגות של קבוצת הנתונים בכל קובץ שמעלים. לשם כך צריך לכלול את העמודה ga:importBehavior בכותרת. בכל שורה אפשר להגדיר את הערך של ga:importBehavior בתור SUMMATION או OVERWRITE.

לדוגמה, הקובץ הבא יחליף את נתוני העלות הקודמים של Facebook/cpc ושל Yahoo/cpc, אבל השורה של Bing/cpc תתווסף לכל נתוני העלות הקיימים של אותו תאריך עם השילוב של מקור/אמצעי הגעה לאתר הספציפי הזה.

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

פורמט ומגבלות

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

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

מגבלות הקובץ

• קידוד: UTF-8
• מגבלת גודל הקובץ: 1GB

מגבלות הכותרת

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

מגבלות שורה

• יש מגבלת שורות של 1MB.

עיצוב תא

• האורך המקסימלי של תאים הוא 2,048 תווים.
• רווחים בהתחלה ובסוף של תא יוסרו.
• כדי לציין פסיק בתוך תא, ערך התא צריך להיות בתוך מירכאות כפולות. למשל: source1,"medium,ether",group1,100 – ערך התא השני הוא בינוני.
• כדי לציין מירכאות כפולות בתוך תא, בנוסף להתחלה ולסיום של מירכאות כפולות, משתמשים בתו בריחה (escape) מהמירכאות הכפולות עם מירכאות כפולות נוספות. למשל: source1,"medium""ether",group1,100 – ערך התא השני הוא medium"ether.