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

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

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

ב-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 ייכנסו לתוקף רק אם הבקשה עומדת בכל הדרישות. במילים אחרות, לא תוכלו להוסיף נכסים לקבוצות הנכסים האלה בהדרגה.