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

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

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

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

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

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

• תקציב הקמפיין
• קמפיין
• נכסים של קמפיין (רק בקמפיינים שמופעלים בהם ספר מותג)
• קבוצות נכסים
• נכסים בקבוצת נכסים
• נכסים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

חשוב לציין שבקמפיינים למוצרי קמעונאות צריך לאכלס את השדה Campaign.shopping_settings. בנוסף, כתובת ה-URL של 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 יצליחו רק אם הבקשה תעמוד בכל הדרישות של הנכסים שמצורפים למודעה. במילים אחרות, אי אפשר להוסיף נכסים לקבוצות הנכסים האלה באופן מצטבר.