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