עיבוד ברצף (batch processing) בקמפיינים למיקסום ביצועים

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

במדריך הזה תמצאו פרטים ספציפיים לקמפיינים למיקסום הביצועים כשעובדים עם עיבוד ברצף (batch processing). במדריך הכללי לעיבוד באצווה מופיע מידע כללי על עיבוד ברצף (batch processing), ובמדריך לבקשות מבנה יש מידע מפורט על בניית בקשות ליצירה או לניהול של קמפיינים למיקסום הביצועים.

כדי ליצור קמפיין למיקסום הביצועים באמצעות עיבוד ברצף (batch processing), יש לפעול לפי השלבים הבאים:

יצירת משימה חדשה באצווה

פועלים לפי השלב הכללי ליצירת משימות בעיבוד באצווה כדי ליצור משאב BatchJob.

הכנת רשימה של פעולות שינוי

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

דרישות לגבי AssetGroupOperation וAssetGroupAssetOperation

הערה: הדרישה הזו חלה רק על משאבים של AssetGroup עם משאבים משויכים של Asset שמשתמשים בAssetGroupAsset כדי לעמוד בדרישות המינימליות לגבי נכסים.

הפעולות מסוג MutateOperation שיוצרות משאבים במשימה מסוג AssetGroup ו-AssetGroupAsset במשימה באצווה צריכות להיות עוקבות בלי לבצע פעולות אחרות באמצע, בגלל האופן שבו הפעולות האלה מקובצות יחד בזמן העיבוד. אחרת, הבקשה תקפיץ הודעת AssetGroupError שמציינת שחלק מהנכסים חסרים, גם אם הפעולות שנדרשות כדי לעמוד בדרישות המינימליות של הנכסים נכללות מאוחר יותר ברשימת הפעולות.

AssetGroupListingGroupFilterOperation שיטות מומלצות

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

כשעובדים עם מסננים של קבוצות של כרטיסי מוצר בהקשר של AssetGroupListingGroupFilter, מומלץ להוסיף AssetGroupListingGroupFilterOperation פעולות שמטרגטות את אותן AssetGroup למשימה באצווה ברצף, כדי שהמערכת תטפל בקבוצת הפעולות באופן אטומי במהלך הפיצול ברצף. לקבלת מידע נוסף על חלוקה לקבוצות של כרטיסי מוצר ועל גורמים אחרים שמשפיעים על קבוצות של כרטיסי מוצר, קראו את המדריך לעיבוד ברצף (batch processing) של קבוצות כרטיסי מוצר.

הוספת פעולות השינוי למשימה

מוסיפים את פעולות השינוי משלב 2 לרשימה ומפעילים את AddBatchJobOperations כדי להוסיף את רשימת השינויים במשימה באצווה שנוצרה בשלב 1. כדי להוסיף את הרשימה של פעולות השינוי, מבצעים את השלב Add actions (הוספת פעולות) במדריך הכללי לעיבוד ברצף (batch processing).

הרצת המשימה באצווה

מאפשרים למשימות שהועלו להתחיל לפעול באמצעות קריאה ל-RunBatchJob. לדוגמה, ראו את השלב הרצת המשימה באצווה במדריך הכללי לעיבוד ברצף (batch processing).

אחזור סטטוס המשימה

משימות באצווה מתחילות כפעולות ממושכות ובדרך כלל מסתיימות תוך זמן קצר. אחרי שמתחילים את המשימה, משתמשים ב-method של הפעולה הממושכת GetOperation כדי לסקרים את סטטוס המשימה עד שמסתיימת.

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