עיבוד באצווה מאפשר לשלוח קבוצה של פעולות, שיכולות להיות תלויות זו בזו, לכמה שירותים בלי לחכות באופן סינכרוני להשלמת הפעולות. אפשר להשתמש בעיבוד אצווה כדי ליצור ולנהל קמפיינים למיקסום הביצועים.
במדריך הזה מפורטים פרטים ספציפיים לקמפיינים למיקסום הביצועים כשעובדים עם עיבוד באצווה. במדריך הכללי לעיבוד אצווה מוסבר על עיבוד אצווה, ובמדריך ליצירת בקשות יש מידע מפורט על יצירת בקשות ליצירה או לניהול של קמפיינים למיקסום הביצועים.
כדי ליצור קמפיין למיקסום ביצועים באמצעות עיבוד באצווה, פועלים לפי השלבים הבאים:
יצירת משימת אצווה חדשה
כדי ליצור משאב BatchJob, פועלים לפי השלב ליצירת משימה של עיבוד אצווה כללי.
הכנת רשימה של פעולות שינוי
כדי ליצור קמפיינים למיקסום הביצועים, צריך לבצע פעולות ליצירת כמה משאבים קשורים, שמפורטים במדריך לבניית בקשות. יוצרים MutateOperation לכל משאב שרוצים לכלול בעבודת האצווה.
הדרישות של CampaignOperation ושל CampaignAssetOperation
כשמפעילים הנחיות מיתוג בקמפיין (מידע נוסף על הנחיות מיתוג), צריך לקשר נכסי מותג לקמפיין באמצעות משאבי CampaignAsset. בנוסף, במשימה של עיבוד באצווה, יצירת המשאבים האלה CampaignAsset צריכה להתרחש מיד אחרי יצירת המשאב Campaign עצמו. אם משאבי CampaignAsset לא נוצרים מיד אחרי משאב Campaign (כשהפעלתם את ספר המותג – ראו פתרון בעיות), הבקשה תיכשל ותחזיר את קוד השגיאה CampaignError שמציין שנכסים חסרים.
הוספת פעולות ליצירת CampaignAsset בהמשך אותה רשימה של פעולות לא תמנע את השגיאה הזו.
הדרישות של AssetGroupOperation ושל AssetGroupAssetOperation
הפעולות מהסוג MutateOperation שיוצרות משאבי AssetGroup ו-AssetGroupAsset בעבודת אצווה חייבות להיות רציפות ללא פעולות אחרות ביניהן, בגלל האופן שבו הפעולות האלה מקובצות יחד במהלך העיבוד. אחרת, הבקשה תחזיר את השגיאה AssetGroupError שמציינת שחסרים נכסים, גם אם הפעולות שנדרשות כדי לעמוד בדרישות המינימליות לגבי נכסים מופיעות בהמשך רשימת הפעולות.
AssetGroupListingGroupFilterOperation שיטות מומלצות
כשעובדים עם מסננים של קבוצות כרטיסי מוצר בהקשר של AssetGroupListingGroupFilter, מומלץ להוסיף פעולות AssetGroupListingGroupFilterOperation שמטרתן אותו AssetGroup לעבודה בקבוצות ברצף, כדי שהמערכת תתייחס לקבוצת הפעולות כאטומית במהלך פיצול הקבוצות. מידע נוסף על פיצול של קבוצות מוצרים ועל גורמים אחרים שמשפיעים על קבוצות מוצרים זמין במאמר מדריך לעיבוד אצווה של קבוצות מוצרים.
הוספת פעולות שינוי למשימה
מוסיפים את פעולות השינוי משלב 2 לרשימה וקוראים ל-AddBatchJobOperations כדי להוסיף את רשימת השינויים לעבודת האצווה שנוצרה בשלב 1.
פועלים לפי השלב להוספת פעולות במדריך הכללי לעיבוד אצווה כדי להוסיף את רשימת פעולות השינוי.
הפעלת משימה באצווה
כדי לאפשר הפעלה של המשימות שהועלו, צריך להתקשר אל RunBatchJob. דוגמה מופיעה בשלב הפעלת העבודה בקבוצה במדריך הכללי לעיבוד בקבוצות.
אחזור הסטטוס של העבודה
משימות אצווה מתחילות כפעולות ממושכות, ובדרך כלל לוקח זמן עד שהן מסתיימות.
אחרי שמפעילים את העבודה, משתמשים בשיטה GetOperation של הפעולה הממושכת כדי לבדוק את סטטוס העבודה עד שהיא מסתיימת.
כשכל המשימות בקבוצה מסתיימות, קוראים ל-ListBatchJobResults כדי להדפיס את הסטטוסים והתגובות שלהן בהתאם לשלב list all batch job results במדריך הכללי לעיבוד קבוצות.