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

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

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

ב-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.

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

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

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

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

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

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

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

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

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

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

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

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

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

מצב לא תקף

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

בקשה לא חוקית

בקשה שלא תצליח כי היא תעביר את הקמפיין או המשאב למצב לא תקין. לדוגמה, Google Ads API יציג שגיאה אם תנסו ליצור AssetGroup בקמפיין שלא מיועד למוצרי קמעונאות (חוץ מקמפיינים למיקסום הביצועים של "Google בעלי מקצוע") בלי לכלול את הנכסים המינימליים הנדרשים. לכן צריך לכלול את 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 אחד (הדרישה המינימלית), בקשה להסיר רק את ה-MARKETING_IMAGE הזה AssetGroupAsset תחזיר שגיאה. עם זאת, בקמפיינים למוצרי קמעונאות מסוג מיקסום ביצועים, אפשר להחזיר AssetGroup להסתמכות על נכסים שנוצרו אוטומטית ב-Google Merchant Center על ידי הסרת כל הקישורים המותאמים אישית של AssetGroupAsset בבקשה אחת.

בקבוצות נכסים בקמפיינים למיקסום הביצועים למוצרי קמעונאות שנוצרו בלי נכסים מותאמים אישית משויכים, בבקשות הבאות לקשר נכסים מותאמים אישית (מלבד נכסי HTML5 מסוג MEDIA_BUNDLE) צריך לוודא שמוגדר לפחות final_urls אחד ב-AssetGroup (לאכלס אותו קודם אם הוא הושמט במקור) ולספק את כל הנכסים המינימליים הנדרשים (כולל נכסים שקשורים למותג ברמת הקמפיין אם ספר המותג מופעל) בבקשה אטומית אחת. אל תקשרו נכסים אופציונליים שמצורפים למודעה כמו YOUTUBE_VIDEO לבד, ואל תוסיפו נכסים שמצורפים למודעה באופן מצטבר בבקשות נפרדות. אם תקשרו רק נכסים אופציונליים בהתאמה אישית, קבוצת הנכסים תהיה במצב לא נתמך שלא מאפשר לבצע עריכות בממשק המשתמש של Google Ads. פרטים נוספים זמינים במאמר קישור קבוצות נכסים לנכסים בקמפיינים למיקסום הביצועים למוצרי קמעונאות.