הערות מוצר

גרסה 19.1 (16.04.2025)

התכונות והשינויים הבאים נוספו בגרסה 19.1.

נכסים

• הוספנו שדה asset_coverage ל-AssetGroup שמציג מידע על פערים בקבוצת הנכסים.
  • שדה המשנה ad_strength_action_items מחזיר רשימה של פעולות שהמפרסם יכול לבצע כדי לשפר את חוזק המודעה של קבוצת נכסים.

קמפיינים

• עכשיו אפשר לדרג או לספק משוב על לידים בקמפיינים של 'Google בעלי מקצוע'. במסגרת השינוי הזה, גרסה 19.1
  • נוסף שירות חדש בשם LocalServicesLeadService. אפשר להשתמש ב-method‏ ProvideLeadFeedback כדי להעלות דירוג ומשוב על לידים.
  • נוסף שדה חדש בשם lead_feedback_submitted ל-LocalServicesLead כדי לקבוע אם נשלחה משוב ללידים.
• הוספנו עמודת מדדים חדשה biddable_cohort_app_post_install_conversions לקמפיינים לקידום אפליקציות.

יצירת ביקוש

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

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

  • מודעת וידאו In-stream ב-YouTube
  • מודעות וידאו בגוף הפיד ב-YouTube
  • YouTube Shorts
  • Discover
  • Gmail
  • רשת המדיה

• חשף סוג נכס חדש בשם TALL_PORTRAIT_MARKETING_IMAGE. סוג הנכס הזה קשור לשדה tall_portrait_marketing_images בפורמט של מודעה עם כמה נכסים ליצירת ביקוש.

היסטוריית שינויים

• נוספה תמיכה בשלושה סוגי משאבים נוספים ב-ChangeStatusResourceType:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• אפשר לאחזר את שלושת הסוגים המפורטים האלה מהדוח change_status.

המרות

• מעכשיו אפשר להגדיר את השדה google_ads_conversion_customer בזמן יצירת לקוח חדש באמצעות Google Ads API. בעבר, השדה הזה היה לקריאה בלבד.
• עכשיו אפשר לציין את סוג הלקוח שמשויך להמרה בזמן העלאת המרות אופליין.
• הוספנו שדה חדש session_attributes ל-ClickConversion.

מודעות 'Google בעלי מקצוע'

• הוספנו RPC חדש ProvideLeadFeedback ל-LocalServicesLeadService כדי לספק משוב על האיכות של LocalServicesLead.
• נוסף שדה חדש lead_feedback_submitted למשאב LocalServicesLead, שמאשר אם נשלחה משוב לגבי משאב ספציפי.

שירותי תכנון

• הוספנו תמיכה בתחזיות חודשיות של תדירות טירגוט ב-ReachPlanService.GenerateReachForecast.
  • מפתחים יכולים להגדיר את הערך TargetFrequencyTimeUnit.MONTHLY ב-TargetFrequencySettings כשהם משתמשים בקוד המוצר הניתן לתכנון TARGET_FREQUENCY כדי ליצור תחזית חודשית של פוטנציאל החשיפה לפי תדירות היעד.
• הוספנו שיטה חדשה, ReachPlanService.GenerateConversionRates, שמאפשרת למפרסמים לבקש הצעות לשיעורי המרה למוצרים נתמכים שאפשר לתזמן.
• תחזיות ביקוש בקמפיינים ליצירת ביקוש ב-ReachPlanService.GenerateReachForecast:
  • עכשיו מפתחים יכולים לבקש תחזיות של היקף החשיפה בקמפיינים ליצירת ביקוש. מפתחים יכולים להשתמש בקוד המוצר החדש DEMAND_GEN_MAX_CONVERSIONS שאפשר לתכנן כדי ליצור תחזיות של פוטנציאל החשיפה בקמפיינים ליצירת ביקוש.
  • הוספנו את השדה החדש conversion_rate, שמאפשר למפתחים שמבקשים תחזיות של פוטנציאל החשיפה בקמפיינים ליצירת ביקוש לציין שיעור המרה. אפשר לאחזר הצעות לשיעורי המרה באמצעות השיטה החדשה ReachPlanService.GenerateConversionRates. השדה הזה נדרש לבקשות לתחזיות של קמפיינים ליצירת ביקוש. אין תמיכה במוצרים אחרים שאפשר לתזמן.
  • נוספ שדה חדש conversions לתחזיות שמוחזרות. השדה הזה מכיל את מספר ההמרות בנקודה מסוימת על עקומת פוטנציאל החשיפה. אפשר לעקוב אחרי המרות רק במוצר DEMAND_GEN_MAX_CONVERSIONS שאפשר לתזמן.

המלצות

• השדה החדש ad_strength זמין ב-ImprovePerformanceMaxAdStrengthRecommendation, והוא מחזיר את הציון הנוכחי של חוזק המודעה בקבוצת הנכסים שמשויכת להמלצה.

קניות

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

סרטונים

• נוספה תמיכה בקריאה בלבד במודעות אודיו. מידע נוסף על התכונה הזו זמין במרכז העזרה של Google Ads. השינויים האלה חושפים:
  • AdvertisingChannelSubType חדש בשם YOUTUBE_AUDIO.
  • AdGroupType חדש בשם YOUTUBE_AUDIO.
  • ספירה חדשה של פורמטים של מודעות בשם YOUTUBE_AUDIO_AD, והשדות התואמים שלה YouTubeAudioAdInfo.
• הוספנו מדדים ופלחים חדשים למדדי פוטנציאל החשיפה לשאילתות עם התאמה לפי דמוגרפיה. במסגרת השינויים האלה,
  • נוספו שתי עמודות מדדים חדשות בשמות coviewed_impressions ו-primary_impressions.
  • הוספנו שני פלחים חדשים בשמות adjusted_age_range ו-adjusted_gender.
  • אם בוחרים אחד משני הפלחים החדשים לצד שדה של מדד פוטנציאל החשיפה (coviewed_impressions,‏ primary_impressions,‏ unique_users או average_impression_frequency_per_user), צריך לבחור גם את הפלח השני כדי לאחזר נתונים סטטיסטיים תקפים בעמודות האלה.
  • התכונה הזו זמינה כרגע רק ללקוחות ברשימת ההיתרים.

גרסה 19 (26 בפברואר 2025)

התכונות והשינויים הבאים נוספו בגרסה 19.

ניהול חשבון

• הוספנו את הערכים הבאים ל-CustomerError כדי להביא בחשבון שינויים קרובים:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

מודעות

• הוספנו את DemandGenMultiAssetAdInfo.tall_portrait_marketing_images כדי לתמוך בנכסי תמונות לאורך ביחס גובה-רוחב של 9:16 במודעות ליצירת ביקוש.

נכסים

• (בחשבונות שמופיעים ברשימת ההיתרים בלבד) נוספה תמיכה בנכסי שליחת הודעות באמצעות Asset.business_message_asset,‏ BusinessMessageAsset והמשתנים הבאים מסוג enum והשגיאות הבאות.
  • Enums:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • שגיאות:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• הוספנו את AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW כדי לתמוך ביצירה אוטומטית של תצוגה מקדימה של דף נחיתה.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS הסכימו עכשיו כברירת מחדל להצגת מודעות וידאו רספונסיביות ליצירת ביקוש.
• (לחשבונות ברשימת ההיתרים בלבד. רשימת ההיתרים סגורה כרגע) נוספו Asset.app_deep_link_asset ו-AppDeepLinkAsset.

המרות

• יעדי המרה
  • LifecycleGoalValueSettings.high_lifetime_value הסתיימה תקופת הבטא והיא זמינה עכשיו לשינוי.
  • נוספה השדה CustomerLifecycleGoal.owner_customer כדי להציג את שם המשאב של הלקוח שבבעלותו היעד של מחזור החיים של הלקוח.
• ConversionActionType.SALESFORCE הוצא משימוש.

פידים

• הוסרו כל הישויות שקשורות לפיד, כמו Feed,‏ FeedMapping,‏ FeedService,‏ AdGroupFeed,‏ feed_placeholder_view וכו'. עכשיו המשתמשים צריכים להשתמש ב-assets כדי להשיג את אותה מטרה. בהערות לגבי המעבר מפורטת רשימה של כל הישויות שהוסרו.

מלונות ונסיעות

• הפכנו את השדות min_days ו-max_days של ValueRuleItineraryAdvanceBookingWindow לשדות optional כדי לאפשר לציין את הערך 0. כך אפשר לטרגט חיפושים של נסיעות שמתרחשים היום.

מיקסום ביצועים

• (רק לחשבונות ברשימת ההיתרים) הנחיות למיתוג
  • אפשר לשנות את Campaign.brand_guidelines_enabled רק כשיוצרים קמפיין למיקסום הביצועים.
  • האפשרות הזו לא תואמת לקמפיינים למיקסום הביצועים לענף התיירות והאירוח.
  • כדי להפעיל הנחיות מיתוג בקמפיינים קיימים למיקסום הביצועים, משתמשים באפשרות CampaignService.EnablePMaxBrandGuidelines שנוספה לאחרונה. אין תמיכה בהשבתה של הנחיות המיתוג.
  • הוספנו את Campaign.brand_guidelines ואת BrandGuidelines כדי לאפשר להגדיר את הצבעים ומשפחת הגופנים של המותג.
  • ערכים חדשים של שגיאות:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• הוספנו את AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS כדי לתמוך ביצירה אוטומטית של נכסי וידאו משופרים בקמפיינים למיקסום הביצועים.

תכנון

• (לחשבונות ברשימת ההיתרים בלבד) הוספנו את האפשרות ContentCreatorInsightsService.GenerateTrendingInsights שמאפשרת למשתמשים לראות ב-YouTube נושאי תוכן פופולריים בהתאם להגדרות קהל נתונות.
• נוספה הפונקציה GenerateCreatorInsightsRequest.country_locations[] כדי לציין מדינות לחיפוש לפי הקריטריונים הנתונים
• הוספנו את GenerateCreatorInsightsRequest.search_brand כדי לציין מותג לחיפוש יוצרים
• הוספנו שדות חדשים ל-YouTubeChannelInsights כדי לספק פרטים נוספים על הערוצים לבקשות search_channels:
  • channel_url
  • channel_description
  • top_videos
• נוספו שדות מטא-נתונים חדשים ל-AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

סרטונים

• אחרי השקת DataLinkService.CreateDataLink, הוספנו את השיטות הבאות כדי לאפשר שינוי של קישורי נתונים שנוצרו בעבר:
  • RemoveDataLink כדי להסיר קישורי נתונים בחשבון Google Ads
  • UpdateDataLink כדי לאשר, לדחות ולבטל קישורי נתונים בחשבון Google Ads
• הוסר התמיכה ב-VIDEO_OUTSTREAM מהמאפיינים הבאים של enum:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

גרסה 18 (16.10.2024)

התכונות והעדכונים החדשים הבאים נוספו בגרסה 18.

ניהול חשבון

• (לחשבונות ברשימת ההיתרים בלבד) הוספנו את DataLinkService.CreateDataLink, שמאפשר לקשר חשבון Google Ads לסרטונים של יוצרים שמתארחים בערוץ YouTube של היוצרים. קישור סרטונים מאפשר לחשבון Google Ads להציג סוגי מודעות ששותפים תומכים בהם באמצעות סרטונים של יוצרים.

קבוצות של מודעות

• הוספנו את הערך AdGroup.exclude_demographic_expansion שמאפשר להחריג את האפשרות להרחיב את המאפיינים הדמוגרפיים כשהערך של optimized_targeting_enabled הוא true. זו תכונה שהייתה נתמכת בעבר רק בקמפיינים ליצירת ביקוש.

מודעות

• הוספנו את השדה AdGroupAd.ad_group_ad_asset_automation_settings, שמאפשר להביע הסכמה או לבטל את ההסכמה ליצירת נכסים אוטומטית במודעות.
• נוספו הערכים הבאים ל-AssetAutomationType:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• הוספנו את השדה AdNetworkType.GOOGLE_OWNED_CHANNELS, שמשמשים מודעות שמוצגות בערוצים שבבעלות Google, כמו YouTube,‏ Gmail ופיד Discover.

נכסים

• השם של AssetType.DISCOVERY_CAROUSEL_CARD השתנה ל-AssetType.DEMAND_GEN_CAROUSEL_CARD.

קמפיינים

• נוספה המאפיין metrics.store_visits_last_click_model_attributed_conversions, שמציג את מספר הביקורים בחנות הפיזית שמשויכים לפי מודל 'קליק אחרון' בקמפיין.
• נוספו לקמפיין המדדים הבאים שקשורים לצפיות בסרטונים:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• נוספה המאפיין metrics.results_conversions_purchase, שמציג את מספר ההמרות לרכישה בתוצאות של יעדי ההמרה המאוחדים בקמפיין.
• שינינו את ערך ברירת המחדל של DemandGenCampaignSettings.upgraded_targeting מ-false ל-true.

קריטריון

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

מלונות ונסיעות

• תמיכה בפידים של נתוני נסיעות במודעות לרשת החיפוש
  • הוספנו את המאפיין ClickType.TRAVEL_ASSETS כדי לאפשר פילוח של מדדים של פידים של נתוני נסיעות במודעות לרשת החיפוש.
  • הוספנו את השדה AssetSetType.TRAVEL_FEED, שאפשר להשתמש בו כדי להביע הסכמה או סירוב לשימוש בפיד בנושא נסיעות במודעות לרשת החיפוש.
• (בחשבונות שרשומים ברשימה המורשית בלבד) הוספנו את מסלול הנסיעה בתור כלל חדש לקביעת ערך המרה עם השדות והערכים החדשים הבאים:
  • ConversionValueRule.itinerary_condition יחד עם ValueRuleItineraryCondition, שמאפשרים לציין חלון להזמנה מראש, משך מסלול הנסיעה וימים בשבוע להתחלת הנסיעה
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• הוספנו את הפלחים הבאים לדוחות campaign ו-ad_group כדי לאפשר פילוח של נתוני הביצועים על סמך יעדים ספציפיים (ערים, מדינות ואזורים) בקמפיינים לקידום מלונות ובקמפיינים לרשת החיפוש:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

שירותים מקומיים

• אם ההקלטה של השיחה לא קיימת ללידים של שירותים מקומיים, הערך של PhoneCallDetails.call_recording_url יהיה ריק במקום לספק כתובת URL לא חוקית.
• הוספנו את CategoryBid.target_cpa_bid_micro, שמאפשר להגדיר יעד עלות להמרה לקטגוריה דרך Campaign.local_services_campaign_settings.

מיקסום ביצועים

• תמיכה בספר המותג
  • הוספנו את השדה Campaign.brand_guidelines_enabled, שמציג אם הנחיות המיתוג מופעלות בקמפיין נתון למיקסום הביצועים. אם ההגדרה מופעלת, צריך לקשר נכסים עם field_type שמוגדר להם BUSINESS_NAME,‏ LOGO,‏ LANDSCAPE_LOGO כמשאבים מסוג CampaignAsset במקום כמשאבים מסוג AssetGroupAsset.
  • הוספנו את השגיאות CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED ו-CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, שמציינות שלקמפיינים למיקסום הביצועים שהופעלה בהם ההנחיה 'הנחיות למותגים' אין את המשאבים הנדרשים CampaignAsset שמקושרים לקמפיין.
  • כשההנחיות למיתוג מופעלות, צריך לקשר לקמפיין לפחות נכס אחד עם הערך BUSINESS_NAME ב-field_type ולפחות נכס אחד עם הערך LOGO ב-CampaignAsset כמשאבים. קמפיינים למיקסום הביצועים למכירות אונליין עם פיד מוצרים חייבים לעמוד בדרישות האלה רק אם יש נכסים שמקושרים לקבוצות הנכסים של הקמפיין.
  • נוספו הערכים הבאים ל-AssetLinkError:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, שמופיעה כשמנסים לקשר נכסי מותג לקמפיינים כמשאבים מסוג CampaignAsset במקום כמשאבים מסוג AssetGroupAsset בקמפיינים למיקסום הביצועים שבהם לא מופעל ספר מותג.
    • השגיאה BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, שמופיעה כשמנסים לקשר נכסי מותג לקמפיינים כמשאבים מסוג AssetGroupAsset במקום כמשאבים מסוג CampaignAsset בקמפיינים למיקסום הביצועים כשהנחיות המיתוג מופעלות.
• הוספנו את הפונקציה performance_max_placement_view, שמציגה את החשיפות במיקומי המודעות שבהם הוצגו המודעות בקמפיינים למיקסום הביצועים.
• הוספת AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

תכנון

• (לחשבונות ברשימת ההיתרים בלבד) הוספנו שירות חדש עם השיטה ContentCreatorInsightsService.GenerateCreatorInsights, שמאפשר למשתמשים לקבל תובנות על היוצרים המובילים ב-YouTube. כך הלקוחות יכולים לחפש יוצרים לפי שילוב של טירגוט לפי קהל וטירגוט לפי תוכן, או לקבל תובנות על יוצרים לפי רשימה של מזהי ערוצים ב-YouTube.
• עדכונים לגבי AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • העברת audience, ‏ baseline_audience ו-data_month אל audience_definition.
  • הוספנו את הערך audience_description כדי ליצור הצעות לטירגוט מתיאור טקסט בפורמט חופשי באמצעות AI גנרטיבי.
• נוספה הפונקציה AudienceInsightsService.GenerateTargetingSuggestionMetrics, שמציגה מדדים של פוטנציאל החשיפה לשילובים נתונים של טירגוט לפי קהל.

המלצות

• עכשיו אפשר להשתמש ב-RecommendationService.GenerateRecommendations כדי ליצור המלצות לגבי הצעות לתקציב מותאם אישית במהלך יצירת הקמפיין. לשם כך, צריך לכלול את סוג ההמלצה CAMPAIGN_BUDGET ב-GenerateRecommendationsRequest.recommendation_types[]. אפשר לעשות זאת בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש.

דיווח

• החלפתם את השדות summary_row_setting ו-return_total_results_count של SearchGoogleAdsRequest בשדה search_settings, שהסוג שלו הוא SearchSettings, בשדות הבאים:
  • omit_results
  • return_summary_row
  • return_total_results_count
• נוספו המדדים החדשים הבאים לגבי קליקים פסולים כלליים, כמו קליקים שנוצרו על ידי בוטים או סורקים, או קליקים עם דפוסים לא סדירים. אפשר להריץ שאילתות לגביהן באמצעות הדוח campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• נוספו הערכים הבאים ל-QuotaError:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

גרסה 17.1.0‏ (07.08.2024)

התכונות והעדכונים החדשים הבאים נוספו בגרסה 17_1.

נכסים

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() מאפשר לכם להסיר נכסים דיגיטליים שנוצרו באופן אוטומטי שמשויכים למודעות רספונסיביות לרשת החיפוש.

קהלים

• ערכי enum חדשים ב-UserListCustomerTypeCategory:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

קמפיינים

• ShareablePreviewService.GenerateShareablePreviews() יוצר את כתובות ה-URL shareable_preview_url בתגובה לתצוגות מקדימות של מודעות שניתן לשתף בקבוצות נכסים שפועלות או מושהות.
  • השדה expiration_date_time מציין את תאריך התפוגה של כתובות ה-URL בתשובה.
  • אם מתרחשת שגיאה, השיטה מחזירה את הערך partial_failure_error במקום את כתובות ה-URL.

היסטוריית שינויים

• סוג משאב חדש לשינוי סטטוס: ASSET_GROUP.

המרות

• שדה פלח חדש לגרסה של SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, שמציג אבחון של העלאת ההמרות ברמת פעולת ההמרה.
• המדדים הבאים מתווספים לדוחות האבחון אופליין כדי לציין את מספר ההמרות שהועלו שעדיין נמצאות בטיפול:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

תכנון

• AudienceInsights.GenerateAudienceOverlapInsights(), שמקבלת מאפיין ראשי קלט ואוסף של מאפייני קהל, ומחזירה את האומדנים של חפיפה של פוטנציאל החשיפה ב-YouTube בין המאפיין הראשי לבין מאפייני הקהל.

דיווח

• תמיכה בפילוח של per_store_view על סמך segments.date

סרטונים

• תמיכה באחזור מידע שקשור לשיטות הבידינג הרגילות הבאות בקמפיינים של מודעות וידאו באמצעות דוחות, כמו ad_group,‏ campaign:
  • Campaign.fixed_cpm (עלות קבועה לאלף חשיפות (CPM))
  • Campaign.target_cpv (יעד עלות לצפייה (CPV))
• Campaign.video_campaign_settings שמאפשר לכם לקבוע באילו מלאי שטחי פרסום אפשר להציג את מודעות הווידאו, באמצעות שדות הדוח הבאים:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, שמאפשר לפלח את הדוחות הבאים לפי סוג הפורמט של מודעות הווידאו:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

גרסה 17 (05.06.2024)

התכונות והשינויים הבאים נוספו בגרסה 17.

מודעות

• בוצעה הסרה של AdService.getAd. כך AdService תואם לשירותים אחרים ב-Google Ads API. במאמר אחזור אובייקטים מוסבר איך מאחזרים מודעות וסוגי משאבים אחרים.
• נוספו בדיקות אימות נוספות ל-ImageAdInfo.image_asset לגבי המאפיינים והפורמט. אם התמונה לא תקינה, יכול להיות שיופיעו השגיאות הבאות:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

נכסים

• נוספה קבוצת ערכים חדשה: ClickType.AD_IMAGE
• הוספנו את הדוחות החדשים הבאים עם מדדים חדשים לקמפיינים למיקסום הביצועים ולקמפיינים לרשת החיפוש:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

קהלים

• הוספת את OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

משימות באצווה

• נוספה השגיאה BatchJobError.REQUEST_TOO_LARGE, שתופיע אם הערך של AddBatchJobOperationsRequest שנשלח גדול מ-10484504 בייט.
• הוספנו תמיכה בהגדרה של MutateOperation.asset_group_operation כשמשתמשים ב-BatchJobService. כך תוכלו להשתמש בעיבוד באצווה כדי ליצור ולנהל קמפיינים שלמים למיקסום הביצועים. במדריך הייעודי שלנו מוסבר איך עושים את זה.

קמפיינים

• שינינו את השם של Discovery ל'יצירת ביקוש' בכל השדות, המאפיינים המפורטים והשגיאות של כל המשאבים ב-Google Ads API, כמו קמפיינים, מודעות ונכסים. לדוגמה, AdvertisingChannelType.DISCOVERY הוא עכשיו AdvertisingChannelType.DEMAND_GEN.
• הוספנו את האפשרות Campaign.keyword_match_type כדי שתוכלו להגדיר את סוג ההתאמה של מילות המפתח לכל מילות המפתח בקמפיין.

המרות

• בהמרות מ-SKAdNetwork,
  • השם של segments.sk_ad_network_conversion_value השתנה ל-segments.sk_ad_network_fine_conversion_value.
  • הוספת את segments.sk_ad_network_redistributed_fine_conversion_value.
• המדדים הבאים מוחזרים עכשיו בתגובה גם אם הם אפס. כך הם תואמים למדדים אחרים.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

קריטריונים

• הוספה לשדות הבאים ב-AdGroupCriterion כדי להציג אם הקריטריון של קבוצת המודעות פעיל או את הסיבות לכך שהוא לא פעיל:
  • primary_status
  • primary_status_reasons
• נוספה תמיכה ב-metrics.search_impression_share ל-gender_view
• נוספה תמיכה ב-metrics.phone_calls ל-keyword_view

שירותים מקומיים

• הוספה של LocalServicesLeadService.AppendLeadConversation() שמשמשת להוספת LocalServicesLeadConversation חדש ל-LocalServicesLead, שמאפשרת לשלוח הודעות למשתמשים דרך ערוצים מתאימים כמו SMS, בהתאם לאופן שבו הליד נוצר.
  • הגודל של AppendLeadConversationRequest.conversations מוגבל ל-1,000.
  • אפשר לציין ב-Conversation.local_services_lead רק את LocalServicesLead עם הערך lead_type שמוגדר כ-LeadType.MESSAGE.
• נוספו ערכי enum חדשים למאפיין ConversationType:
  • WHATSAPP כדי לייצג שיחה שהתחילה דרך WhatsApp.
  • ADS_API כדי לייצג שיחה שהתחילה באמצעות השיטה החדשה LocalServicesLeadService.AppendLeadConversation().
• הוספנו את השדות החדשים הבאים אל local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

דיווח

• עכשיו אפשר לבחור רק שדות שקשורים למוצר מקושר אחד מתוך כל המוצרים המקושרים כששולחים שאילתה ל-product_link. בחירת מספר שדות של כמה מוצרים מקושרים תגרום להצגת השגיאה QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. לדוגמה, אי אפשר לבחור את product_link.advertising_partner.customer וגם את product_link.data_partner.data_partner_id באותה שאילתה.
• העברה של page_size אל GoogleAdsService.Search תוביל לשגיאה RequestError.PAGE_SIZE_NOT_SUPPORTED.

קניות

• נוסף דוח חדש, shopping_product, שמתאים לדף מוצרים בממשק המשתמש של Google Ads. הוא תומך בהחזרת נתונים שקשורים למצב הנוכחי של מוצרים מחשבונות Google Merchant Center שמקושרים לחשבון Google Ads.
  • אפשר לסנן מדדים מהדוח shopping_product באמצעות segments.date כשמשתמשים ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream. אסור לבצע פילוח לפי תאריך, והפעולה הזו תגרום להצגת השגיאה ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

יעדים מאוחדים

• הוספנו את UserListCustomerTypeService.MutateUserListCustomerTypes() כדי להגדיר סוגי לקוחות בקהלים.
• בוצעה הסרה של CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. כדי להגדיר את הגדרות הקהלים של היעדים שקשורים למחזור החיים של הלקוחות, צריך להשתמש ב-UserListCustomerTypeService.MutateUserListCustomerTypes() במקום ב-.
  • כדי לצרף או לבטל את הצירוף של רשימת משתמשים, מגדירים את הערך של UserListCustomerType.customer_type_category לערך UserListCustomerTypeCategory.PURCHASERS כדי לכלול אותה או להחריג אותה מהגדרת לקוח קיימת לצורך יעדי מחזור החיים של הלקוח, בהתאמה. פרטים נוספים זמינים במאמר פילוח קהלים.

סרטונים

• הוספנו את הערכים הבאים ל-ContentLabelType. אפשר להחריג את ContentLabelTypes האלה ברמת הלקוח:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• הוספנו את AdVideoAsset.ad_video_asset_info כדי לתמוך בהעדפות לגבי מלאי שטחי פרסום לנכסי וידאו בזמן יצירת DemandGenVideoResponsiveAdInfo.
• (חשבונות ברשימת ההיתרים בלבד) הופכים את Campaign.video_brand_safety_suitability למשתנה.

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

גרסאות שהוצאו משימוש – כאן אפשר למצוא נתוני גרסה ששמורים בארכיון.