שדרוג לגרסה העדכנית ביותר

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

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

הנה רשימת משימות שתעזור לכם להתחיל בתהליך השדרוג:

  1. נקודת הקצה (endpoint) משתנה כשמחליפים גרסאות ראשיות. מעדכנים את ספריות הלקוח כך שישתמשו בנקודת הקצה החדשה ביותר.
  2. מומלץ לעבור על נתוני הגרסה כדי לראות את השינויים שהושקו בכל אחד מהגרסאות.
  3. בטבלאות הבאות מפורטים תחומים ספציפיים שכדאי להתמקד בהם בגרסה שאליה אתם משדרגים.

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

מגרסה 17 לגרסה 18

שינויים בשירותים וברכיבים שלהם
GoogleAdsService Search וSearchStream בקשות

אם הבקשה שלכם תעבור ויסות כי היא יקרה מדי, השגיאה תהיה QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION או QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION במקום QuotaError.RESOURCE_EXHAUSTED. לעיון בבלוג פוסט לקבלת פרטים נוספים.
GoogleAdsService השדות summary_row_setting ו-return_total_results_count ב-SearchGoogleAdsRequest הם עכשיו חלק מהאובייקט החדש SearchSettings.
AssetType השם של ערך ה-enum DISCOVERY_CAROUSEL_CARD השתנה ל-DEMAND_GEN_CAROUSEL_CARD. השינוי הזה תואם לשינוי הקודם כדי לשנות את השם של קמפיינים מסוג Discovery לקמפיינים ליצירת ביקוש.
AudienceInsightsService.GenerateSuggestedTargetingInsights השדות audience,‏ baseline_audience ו-data_month הועברו לשדה audience_definition.
DemandGenCampaignSettings ערך ברירת המחדל של השדה upgraded_targeting הוא עכשיו true במקום false.
LocalServicesLeadConversation השדה phone_call_details.call_recording_url לא יאוכלס יותר בשיחות סטטיות.

מגרסה 16 לגרסה 17

שינויים בשירותים וברכיבים שלהם
GoogleAdsService Search וSearchStream בקשות

אם השאילתה יקרה מדי, יכול להיות שהבקשה תוגבל. אם כן, תופיע הודעת השגיאה QuotaError.RESOURCE_EXHAUSTED. פרטים נוספים זמינים בפוסט הזה בבלוג.
GoogleAdsService בקשות Search.

מתבצעת העברה של page_size אל GoogleAdsService.Search תוביל לשגיאה RequestError.PAGE_SIZE_NOT_SUPPORTED.
הפקודה Campaign והפקודה Ad

בקמפיינים עם AdvertisingChannelType של DISCOVERY, עכשיו יופיע AdvertisingChannelType של DEMAND_GEN.

בנוסף, השמות של סוגי המודעות ושל השדות בדוחות ישתנו בחלק מהמודעות:

  • המיקום של DISCOVERY_MULTI_ASSET_ADD יהיה DEMAND_GEN_MULTI_ASSET_ADD ושדה הדיווח התואם ad_group_ad.ad.discovery_multi_asset_ad יהיה ad_group_ad.ad.demand_gen_multi_asset_ad
  • המיקום של DISCOVERY_CAROUSEL_AD יהיה DEMAND_GEN_CAROUSEL_AD ושדה הדיווח התואם ad_group_ad.ad.discovery_carousel_ad יהיה ad_group_ad.ad.demand_gen_carousel_ad
  • המיקום של DISCOVERY_VIDEO_RESPONSIVE_AD יהיה DEMAND_GEN_VIDEO_RESPONSIVE_AD ושדה הדיווח התואם ad_group_ad.ad.discovery_video_responsive_ad יהיה ad_group_ad.ad.demand_gen_video_responsive_ad
AdService נקודת הקצה GetAd תוסר. כך אפשר להשתמש ב-AdService באותו אופן שבו משתמשים בשירותים אחרים ב-Google Ads API. במדריך שלנו בנושא אחזור אובייקטים מוסבר איך כדאי לאחזר מודעות וסוגים אחרים של משאבים.
CustomerLifecycleGoal ו-CampaignLifecycleGoal הדרך שבה מנהלים פלחים ליעדים של מחזור חיים השתנתה. בקטע פילוח הקהלים במסמכי העזרה בנושא יעדים שקשורים למחזור החיים של הלקוחות מפורטת סקירה כללית.
ProductLink כשמריצים בקשה של GoogleAdsService או של שידור חי של חיפוש עבור product_link, אפשר לבחור עכשיו רק שדות שקשורים למוצר מקושר אחד. בחירת כמה שדות ממוצרים מקושרים שונים יובילו QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE שגיאה.
דיווח שם השדה metrics.sk_ad_network_conversion_value שונה לשם metrics.sk_ad_network_fine_conversion_value.