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

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

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

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

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

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

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

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

קיבוץ פעולות באמצעות בקשות שינוי (mutate)

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