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

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

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

תמונה

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

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

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

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