מבוא להעברות נתונים ב-Klaviyo

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

במאמר טעינת נתוני Klaviyo ל-BigQuery מוסבר איך לתזמן העברה של נתוני Klaviyo.

אפשרויות להטמעת נתונים

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

העברות מלאות או מצטברות

כדי לציין איך הנתונים ייטענו ב-BigQuery, בוחרים בהעדפת הכתיבה Full או Incremental בהגדרות ההעברה כשמגדירים העברה מ-Klaviyo. העברות מצטברות נתמכות בגרסת Preview.

אתם יכולים להגדיר העברת נתונים מלאה כדי להעביר את כל הנתונים ממערכי הנתונים של Klaviyo בכל העברת נתונים.

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

מצב כתיבה של הוספה

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

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

בהעברות מ-Klaviyo, מומלץ לבחור עמודה שמתעדכנת רק כשהרשומה נוצרת, ולא משתנה בעדכונים הבאים – לדוגמה, העמודה CREATED_AT.

מצב כתיבה של Upsert

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

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

  • כדי שהמחבר של Klaviyo יוכל לעקוב אחרי שינויים בטבלת המקור, נדרשת עמודת סימן מים.
    • בוחרים עמודת סימן מים שמתעדכנת בכל פעם ששורה משתנה. אנחנו ממליצים על עמודות שדומות לעמודה UPDATED_AT או LAST_MODIFIED.

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

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

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

מיפוי סוגי נתונים

בטבלה הבאה מפורטים סוגי הנתונים ב-Klaviyo וסוגי הנתונים התואמים ב-BigQuery:

סוג הנתונים של Klaviyo סוג הנתונים ב-BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

תמחור

בשלב התצוגה המקדימה של התכונה, אין עלות להעברת נתונים מ-Klaviyo ל-BigQuery.

המאמרים הבאים