תזמון העברות ב-Merchant Center
לפני שמתחילים
לפני שיוצרים העברת נתונים ב-Merchant Center:
- מוודאים שביצעתם את כל הפעולות שנדרשות כדי להפעיל את שירות העברת נתונים ל-BigQuery.
- יוצרים מערך נתונים ב-BigQuery לאחסון הנתונים מ-Merchant Center.
- באזור של מערך הנתונים, אנחנו תומכים בשימוש באפשרות ברירת המחדל, 'מספר אזורים', בארה"ב או באיחוד האירופי.
- אם רוצים ליצור מערך נתונים באזור ספציפי, העברת הנתונים ב-Merchant Center נתמכת רק באזורים הבאים:
us-east4 (Northern Virginia),asia-northeast1 (Tokyo),asia-southeast1 (Singapore),australia-southeast1 (Sydney),europe-north1 (Finland),europe-west2 (London),europe-west6 (Zurich).
- אם אתם מתכוונים להגדיר התראות על הפעלת העברה ב-Pub/Sub, אתם צריכים הרשאות
pubsub.topics.setIamPolicy. אם מגדירים רק התראות באימייל, לא צריך הרשאות Pub/Sub. מידע נוסף זמין במאמר בנושא התראות על הפעלות של שירות העברת נתונים ל-BigQuery.
ההרשאות הנדרשות
ודאו שהענקתם את ההרשאות הבאות.
התפקידים הנדרשים ב-BigQuery
כדי לקבל את ההרשאות שנדרשות ליצירת העברת נתונים באמצעות שירות העברת נתונים ל-BigQuery, צריך לבקש מהאדמין להקצות לכם את תפקיד BigQuery Admin (roles/bigquery.admin) ב-IAM בפרויקט.
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה כולל את ההרשאות שנדרשות ליצירת העברת נתונים בשירות העברת נתונים ל-BigQuery. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור העברת נתונים באמצעות שירות העברת הנתונים ל-BigQuery, נדרשות ההרשאות הבאות:
-
הרשאות של שירות העברת נתונים ל-BigQuery:
-
bigquery.transfers.update -
bigquery.transfers.get
-
-
הרשאות ב-BigQuery:
-
bigquery.datasets.get -
bigquery.datasets.getIamPolicy -
bigquery.datasets.update -
bigquery.datasets.setIamPolicy -
bigquery.jobs.create
-
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
מידע נוסף מופיע במאמר בנושא מתן גישה ל-bigquery.admin.
התפקידים הנדרשים ב-Merchant Center
הרשאת גישה רגילה לחשבון Merchant Center שמשמש להגדרת ההעברה. אם הגדרתם העברה באמצעות חשבון שירות, לחשבון השירות צריכה להיות גישה לחשבון Merchant Center. כדי לאמת את הגישה, לוחצים על הקטע משתמשים בממשק המשתמש של Merchant Center.
כדי לגשת לנתונים של השוואת מחירים ביחס לשוק, תובנות לגבי מחירים ומוצרים הכי נמכרים, אתם צריכים לעמוד בדרישות הסף לשימוש ב-Market Insights.
הגדרת העברה של חשבון Merchant Center
כדי להגדיר העברת נתונים לדיווח ב-Merchant Center, צריך:
- מספר חשבון Merchant או מספר חשבון מרובה לקוחות: זהו מספר החשבון שמוצג בממשק המשתמש של Merchant Center.
כדי ליצור העברת נתונים לדיווח ב-Merchant Center:
המסוף
עוברים לדף 'העברות נתונים' במסוף Google Cloud .
לוחצים על Create transfer (יצירת העברה).
בדף Create Transfer:
- בקטע Source type, בוחרים באפשרות Google Merchant Center בשדה Source.
בקטע שם הגדרת ההעברה, בשדה שם מוצג, מזינים שם להעברת הנתונים, למשל
My Transfer. שם ההעברה יכול להיות כל ערך שיעזור לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
בקטע אפשרויות תזמון:
- בוחרים תדירות חזרה. אם בוחרים באפשרות שעות, ימים, שבועות או חודשים, צריך לציין גם תדירות. אפשר גם לבחור באפשרות בהתאמה אישית כדי לציין תדירות חזרה מותאמת אישית. אם בוחרים באפשרות על פי דרישה, העברת הנתונים תתבצע כשמפעילים אותה באופן ידני.
- אם רלוונטי, בוחרים באפשרות התחלה מיידית או התחלה בשעה שנקבעה, ומזינים תאריך התחלה ומשך זמן הפעלה.
- בשדה תאריך התחלה ושעת הפעלה, מזינים את התאריך והשעה שבהם רוצים להתחיל את ההעברה. הערך הזה צריך להיות לפחות 24 שעות אחרי השעה הנוכחית ב-UTC. אם בחרתם באפשרות Start now (אני רוצה להתחיל), האפשרות הזו מושבתת.
אם לא משנים את אפשרויות התזמון ומשאירים את האפשרות התחלה עכשיו, ההפעלה הראשונה של העברת הנתונים מתחילה באופן מיידי ונכשלת עם הודעת השגיאה הבאה:
No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer.ההפעלה הבאה שתוזמן אמורה לפעול בהצלחה. אם הנתונים בחשבון Merchant שלכם מוכנים באותו תאריך לפי שעון UTC, אתם יכולים להגדיר מילוי חוסרים להרצה של היום.
בקטע הגדרות יעד, בשדה מערך נתונים של היעד, בוחרים את מערך הנתונים שיצרתם לאחסון הנתונים.
בקטע פרטי מקור הנתונים, בשדה מספר חשבון Merchant, מזינים את מספר חשבון Merchant או את מזהה חשבון מרובה לקוחות. בוחרים את הדוחות שרוצים להעביר. פרטים נוספים זמינים במאמר בנושא דוחות נתמכים.
בתפריט Service Account בוחרים חשבון שירות מתוך חשבונות השירות שמשויכים לפרויקטGoogle Cloud . אתם יכולים לשייך חשבון שירות להעברת הנתונים במקום להשתמש בפרטי הכניסה של המשתמש. מידע נוסף על שימוש בחשבונות שירות בהעברות נתונים זמין במאמר שימוש בחשבונות שירות.
- אם נכנסתם באמצעות זהות מאוחדת, תצטרכו חשבון שירות כדי ליצור העברת נתונים. אם נכנסתם באמצעות חשבון Google, לא חייבים להשתמש בחשבון שירות להעברה.
- לחשבון השירות צריכות להיות ההרשאות הנדרשות.
(אופציונלי) בקטע אפשרויות להתראות:
לוחצים על Save.
BQ
מזינים את הפקודה bq mk ומספקים את האפשרות ליצירת העברה –
--transfer_config. נדרשים גם הדגלים הבאים:
--data_source--target_dataset--display_name--params
אפשר גם להשתמש בדגל --project_id כדי לציין פרויקט מסוים. אם לא מציינים את --project_id, נעשה שימוש בפרויקט שמוגדר כברירת מחדל.
bq mk \ --transfer_config \ --project_id=project_id \ --target_dataset=dataset \ --display_name=name \ --params='parameters' \ --data_source=data_source --service_account_name=service_account_name
כאשר:
- project_id הוא מזהה הפרויקט.
- dataset הוא מערך נתוני היעד להגדרת ההעברה.
- name הוא השם המוצג של הגדרת ההעברה. שם ההעברה יכול להיות כל ערך שיאפשר לכם לזהות את ההעברה אם תצטרכו לשנות אותה בהמשך.
- parameters מכיל את הפרמטרים של הגדרת ההעברה שנוצרה בפורמט JSON. לדוגמה:
--params='{"param":"param_value"}'.- כדי להעביר נתונים מ-Merchant Center, צריך לספק את הפרמטר
merchant_id. - הפרמטר
export_productsמציין אם להעביר נתוני מוצרים ובעיות במוצרים. הפרמטר הזה נכלל כברירת מחדל, גם אם לא מציינים את הפרמטרexport_products. Google ממליצה לכלול את הפרמטר הזה באופן מפורש ולהגדיר אותו לערך true. - הפרמטר
export_regional_inventoriesמציין אם להעביר נתוני מלאי אזוריים. - הפרמטר
export_local_inventoriesמציין אם להעביר נתוני מלאי בחנות מקומית. - הפרמטר
export_price_competitivenessמציין אם להעביר נתונים של השוואת מחירים ביחס לשוק. - הפרמטר
export_price_insightsמציין אם להעביר את נתוני מדדי המחירים. - הפרמטר
export_best_sellers_v2מציין אם להעביר נתונים של המוצרים הכי נמכרים. - הפרמטר
export_performanceמציין אם להעביר נתוני ביצועים של מוצרים.
- כדי להעביר נתונים מ-Merchant Center, צריך לספק את הפרמטר
- data_source הוא מקור הנתונים –
merchant_center. - service_account_name הוא שם חשבון השירות שמשמש לאימות העברת הנתונים. חשבון השירות צריך להיות בבעלות אותו
project_idששימש ליצירת ההעברה, וצריכות להיות לו כל ההרשאות הנדרשות.
לדוגמה, הפקודה הבאה יוצרת העברת נתונים של Merchant Center בשם My Transfer באמצעות מספר חשבון Merchant 1234 וערכת נתונים של יעד mydataset. העברת הנתונים נוצרת בפרויקט שמוגדר כברירת מחדל.
bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center
בפעם הראשונה שמריצים את הפקודה, מקבלים הודעה כמו זו:
[URL omitted] Please copy and paste the above URL into your web browser and
follow the instructions to retrieve an authentication code.
פועלים לפי ההוראות בהודעה ומדביקים את קוד האימות בשורת הפקודה.
אם רק עכשיו יצרתם את העברת הנתונים הזו, יכול להיות שתצטרכו לחכות עד יום אחד עד שהנתונים של חשבון של מוכר/ת שלכם יוכנו ויהיו זמינים להעברה.הפעלה מתוזמנת הבאה אמורה לפעול בהצלחה. אם הנתונים בחשבון Merchant שלכם מוכנים באותו תאריך לפי שעון UTC, אתם יכולים להגדיר השלמה חסרה להרצה של היום.
API
משתמשים בשיטה projects.locations.transferConfigs.create ומספקים מופע של המשאב TransferConfig.
פתרון בעיות בהגדרת העברה של חשבון Merchant Center
אם נתקלתם בבעיות בהגדרת העברת הנתונים, אפשר לעיין במאמר פתרון בעיות בהגדרת העברת נתונים בשירות העברת נתונים ל-BigQuery, בקטע בעיות בהעברת נתונים ב-Merchant Center.