בקשות הנוגעות למבנה

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

יוצרים קמפיינים למיקסום הביצועים

ב-Google Ads API, ישויות של קמפיינים למיקסום ביצועים מיוצגות כשילוב של מספר משאבים ייחודיים.

קמפיינים רגילים למיקסום הביצועים

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

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

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

  • צריך ליצור את המשאבים CampaignBudget, Campaign ו-Asset בבקשות נפרדות לפני שיוצרים את המשאבים AssetGroup ו-AssetGroupAsset.
  • כוללים את כל המשאבים האלה בבקשת שינוי אחת.

אפשר ליצור את המשאבים CampaignBudget, Campaign ו-Asset בבקשות קודמות נפרדות, אבל הקמפיין למיקסום הביצועים לא יוכל להציג מודעות עד שייווצרו גם המשאבים AssetGroup ו-AssetGroupAsset.

הדרישות המינימליות לקמפיין תקין למיקסום הביצועים להצגת מודעות

תמונה

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

אפשר לכלול פעולות ליצירת משאבים של AssetGroupSignal באותה בקשה שיוצרת את המשאבים AssetGroup ו-AssetGroupAsset. לחלופין, אפשר ליצור ישויות AssetGroupSignal בבקשה נפרדת אחרי יצירת AssetGroup.

קמפיין למיקסום ביצועים עם אפשרויות נוספות

תמונה

קמפיינים למיקסום הביצועים למפרסמים בתחום הקמעונאות

קמפיינים קמעונאיים הם ייחודיים כי יש שתי דרכים נפרדות ליצור קבוצות נכסים שמובילות לקמפיין תקין להצגת מודעות:

  • קבוצות נכסים ללא נכסים
  • קבוצות נכסים שמכילות את כל הנכסים הנדרשים (מועדף)

כשבוחרים להחריג נכסים מקבוצות נכסים, Google משתמשת באופן אוטומטי בנכסים שסופקו בחשבון Merchant Center המקושר כדי ליצור מודעות. עם זאת, מומלץ לספק נכסים שייכללו בכל מלאי שטחי הפרסום. כדי להציג מודעות בקמפיינים למיקסום הביצועים לקמעונאים, צריך לצבור את המשאבים המינימליים הבאים.

  • CampaignBudget
  • Campaign (עם ShoppingSettings מאוכלס)
  • AssetGroup
  • AssetGroupListingGroupFilter

חשוב לציין שצריך לאכלס את השדה Campaign.shopping_settings בקמפיינים של קמעונאות. בנוסף, הערך final_urls שרשומה בכל AssetGroup צריך להתאים לכתובות URL שמשויכות למספר החשבון ב-Merchant Center שצוין ב-Campaign.shopping_settings. לסיום, לכל AssetGroup צריך להיות עץ קבוצה תקין של כרטיסי מוצר שמשויך אליו או מורכב ממשאב אחד או יותר של AssetGroupListingGroupFilter. לכל הפחות, צריך ליצור עץ צומת אחד כדי להביא בחשבון את כל המוצרים בפיד שצוין ב-Merchant Center.

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

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

תמונה

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

קמפיין למיקסום הביצועים בתחום הקמעונאות עם אפשרויות נוספות

תמונה

מצב לא חוקי לעומת בקשות לא חוקיות

כשעובדים עם קמפיינים למיקסום ביצועים ב-Google Ads API, יש הבחנה חשובה בין מצבים לא חוקיים לבין בקשות לא חוקיות.

מצב לא תקף
הקמפיין לא כשיר להצגת מודעות בגלל ההגדרות שלו. לדוגמה, תוכלו ליצור משאב Campaign עצמאי עם advertising_channel_type של PERFORMANCE_MAX. למרות שהבקשה ליצירת הקמפיין מבוצעת בהצלחה, הוא לא יוכל להופיע עד שתוסיפו לקמפיין לפחות AssetGroup אחד. אם הבקשות מצליחות אבל הקמפיין או קבוצות הנכסים לא מציגים מודעות, אפשר להשתמש ב-CampaignPrimaryStatus, ב-CampaignPrimaryStatusReason, ב-AssetGroupPrimaryStatus וב-AssetGroupPrimaryStatusReason כדי לבדוק מה הסיבה, כפי שמפורט במדריך לפתרון בעיות.
בקשה לא חוקית
בקשה שלא תצליח כי היא תעביר את הקמפיין או המשאב למצב לא תקין. לדוגמה, Google Ads API יציג שגיאה אם מנסים ליצור AssetGroup לקמפיין שאינו קמעונאי בלי לכלול את הנכסים המינימליים הנדרשים. לכן צריך לכלול את AssetGroup ואת המשאבים שלו ב-AssetGroupAsset באותה בקשה. המשמעות היא גם שכל המשאבים של AssetGroupAsset חייבים לעמוד במפרט הנכון של field_type נתון, כדי למנוע כשל בבקשה כולה.

פעולות קבוצתיות עם בקשות שינוי

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

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

סדר הפעולות

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

אם בוחרים ליצור משאבי נכסים באותה בקשת שינוי בכמות גדולה שיוצרת את AssetGroup ואת המשאבים AssetGroupAsset, כל הערכים של הפרמטר AssetOperations צריכים להופיע לפני כל הערכים של AssetGroupAssetOperations, כפי שמוצג בתרשים.

תמונה

שרת Google Ads מקבץ יחד AssetGroupAssetOperations ברצף ובודק אם AssetGroup עומד בדרישות המינימליות של הנכסים אחרי הפעולה האחרונה בקבוצה. אם בבקשה עוברים בין AssetOperations ל-AssetGroupAssetOperations, שרת ה-API יבדוק את הדרישות המינימליות לגבי הנכסים אחרי ה-AssetGroupAssetOperation הראשון ויחזיר שגיאה בלי להמשיך בשאר הפעולות שבבקשה. כתוצאה מכך, אף אחד מהנכסים בבקשה לא יתווסף לחשבון Google Ads שלכם. בנוסף, המערכת לא תיצור את AssetGroup או אף אחד מהמשאבים המשויכים של AssetGroupAsset.

עדכון קבוצות נכסים

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

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