הערות מוצר

גרסה 17 (05.06.2024)

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

מודעות

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

נכסים

• נוסף enum חדש: 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. כך תוכלו להשתמש בעיבוד ברצף (batch processing) כדי ליצור ולנהל קמפיינים שלמים למיקסום הביצועים. כדאי לעיין במדריך הייעודי החדש שלנו.

קמפיינים

• שינינו את השם של Discovery ל'יצירת ביקוש' בכל השדות, טיפוסים בני מנייה (enum) ושגיאות בכל המשאבים ב-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

‫Google בעלי מקצוע

• נוסף LocalServicesLeadService.AppendLeadConversation() שמשמש לצירוף LocalServicesLeadConversation חדש ל-LocalServicesLead, ששולח את ההודעות למשתמשים בערוצים מתאימים כמו SMS, בהתאם לאופן שבו הליד נוצר.
  • הגודל של AppendLeadConversationRequest.conversations מוגבל ל-1,000.
  • אפשר לציין רק את LocalServicesLead עם lead_type שמוגדר ל-LeadType.MESSAGE ב-Conversation.local_services_lead.
• נוספו ערכי 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 ניתן לשינוי.

גרסה 16.1.0 (24.04.2024)

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

ניהול חשבון

• CustomerNegativeCriterion.ip_block שתומך בהוספת כתובת IP כקריטריון שלילי ברמת הלקוח.
• ערך enum חדש: ProductLinkError.LINK_EXISTS.
• ערך enum חדש: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

נכסים

• תמיכה בנכסים שקשורים לקמפיינים ליצירת ביקוש עבור ad_group_ad_asset_view ו-asset_field_type_view.
• ערך enum חדש: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

קהלים

• ערך 'טיפוסים בני מנייה (enum)' חדש: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER שמגביל את מספר רשימות המשתמשים הדומות ל-1,000.

קמפיינים

• תמיכה בהחזרת סימולציות של הצעות מחיר לקמפיינים עם יעד החזר על הוצאות פרסום בקמפיינים לקידום אפליקציות באמצעות הדוח campaign_simulation.
• ערך enum חדש: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• ערך enum חדש: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• ערך enum חדש: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

המרות

• SkAdNetworkConversionValueSchema.postback_mappings שתומך בתכונות של SKAdNetwork 4.0.
• נוספה תמיכה באזהרות לגבי CustomerSkAdNetworkConversionValueSchemaService בתור MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. כשהערך הוא true, כל שגיאה שלא חוסמת את הפעולה שקשורה לכשלים בפעולות יוחזרו כMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• ערכי enum חדשים ב-CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

קריטריונים

• שדות חדשים ב-BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• טיפוסים בני מנייה (enum) חדשים: BrandRequestRejectionReason.
• ערך enum חדש: CriterionType.LIFE_EVENT.

ניסויים

• ערך enum חדש: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

‫Google בעלי מקצוע

• local_services_lead.credit_details.credit_state ו-local_services_lead.credit_details.credit_state_last_update_date_time שמחזירים את מצב האשראי ואת חותמת הזמן של העדכון של מצב הזיכוי, בהתאמה.
• הפקודה local_services_lead_conversation.message_details.attachment_urls מחזירה את כתובות ה-URL שאפשר להשתמש בהן כדי להוריד את תוכן הקובץ המצורף.

סרטונים

• customer.video_brand_safety_suitability וBrandSafetySuitability שתומכים באחזור נתוני התאימות של הסרטון להגנה על המותג ברמת הלקוח.
• ערך enum חדש: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

גרסה 16 (21.02.2024)

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

ניהול חשבון

• הועברו advertising_partner מ-AccountLink ל-ProductLink ול-ProductLinkInvitation.
• הסרת את data_partner ואת google_ads מהמרחב המשותף AccountLink.
• האתר IdentityVerificationService נוסף כדי לנהל את תהליך אימות המפרסם.
  • StartIdentityVerification() משמש להתחלת סשן אימות באמצעות ה-verification_program שמסופק. היא יוצרת סשן אימות חדש ומחזירה תגובה ריקה עבור אימות שנוצר.
    • ההוספה IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION נוספה.
  • GetIdentityVerification() יכול לשמש לאחזור פרטי אימות, שמחזירים כמה אובייקטים של IdentityVerification. כל IdentityVerification כולל:
    • verification_program – סוג התוכנית לאימות הזהות (IDV)
    • identity_verification_requirement שכולל פרטים שקשורים לתאריך היעד האחרון שבו המפרסם צריך להשלים את האימות
    • verification_progress שכולל פרטים שקשורים לסשן האימות, כולל:
      • program_status מייצג את הסטטוס הנוכחי של סשן האימות
      • action_url מפנה את הלקוח לכתובת URL כדי להשלים את האימות.
      • invitation_link_expiration_time מייצג את תאריך התפוגה של action_url
  • ערכים לדוגמה:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • שגיאות:
    • IdentityVerificationError
• ההוספה AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT נוספה.

נכסים

• שינויים ב-asset_group:
  • נוספה תמיכה בפלחים שקשורים לזמן, כמו segments.year ו-segments.month.
  • הוא הפך את campaign למשאב משויך במקום למשאב פילוח.

קמפיינים

• שינויים בקמפיינים ליצירת ביקוש:
  • נוספה תמיכה בהגדרה של Campaign.shopping_setting לקמפיין קיים ליצירת ביקוש.
  • הוספתם את המזהה ShoppingSetting.disable_product_feed כדי להשבית את פיד המוצרים האופציונלי בקמפיינים ליצירת ביקוש.
  • נוסף Ad.demand_gen_product_ad והשדה DemandGenProductAdInfo התואם, שזמינים בקמפיינים ליצירת ביקוש עם ערך null בשדה Campaign.shopping_setting.
• הוספתם את השדות הבאים אל AdGroup כדי להראות אם קבוצת המודעות מציגה מודעות או את הסיבות לכך:
  • primary_status
  • primary_status_reasons
• הוספתם את השדות הבאים לשדה AdGroupAd כדי לבדוק אם המודעה שבקבוצת המודעות מוצגת או למה היא לא מוצגת:
  • primary_status
  • primary_status_reasons
• הוסיפו את הערכים הבאים אל AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

ניסוי

• הוספת את Experiment.sync_enabled כדי לציין אם צריך להפעיל את הסנכרון בניסוי. כאשר הסנכרון מופעל, השינויים שמתבצעים בקמפיין המקורי בזמן שהניסוי פועל, מועתקים לקמפיין הניסוי באופן אוטומטי.
• ההוספה ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE נוספה.
• ההוספה CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL נוספה.

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

• הוספנו את השדות הבאים ל-ListingDimensionInfo עבור מודעה בפלטפורמת 'דברים שאפשר לעשות' כדי לאפשר יצירת קבוצות של כרטיסי מוצר על סמך המדינה והעיר שבהן פעילות הנסיעות זמינה:
  • activity_state
  • activity_city
• נוספה תמיכה בפלחים הבאים ל-travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

‫Google בעלי מקצוע

• הוספנו את LocalServicesVerificationArtifact.business_registration_check_verification_artifact ואת BusinessRegistrationCheckArtifact כדי לאפשר למפרסמים לעקוב אחרי ההתקדמות בתהליך אימות הרישום של העסק.
• הוספנו משאב חדש local_services_employee כדי לאפשר למפרסמים לאחזר את פרטי העובדים שהוסיפו.

תכנון

• המשתמש score הוסר מ-AudienceInsightsAttributeMetadata.

המלצות

• נוספה האפשרות RecommendationService.GenerateRecommendations() שמחזירה המלצות על סמך ההגדרות שצוינו, כמו סוגי ההמלצות וסוגי ערוצי פרסום. האפשרות הזו שימושית במיוחד במהלך יצירת הקמפיין.
• ההוספה RecommendationMetrics.conversions_value נוספה.
• במילות מפתח מומלצות עם סוג התאמה לא מוגדר למילות מפתח, recommended_match_type מוגדר עכשיו ל-UNSPECIFIED במקום ל-UNKNOWN.
• הוספנו את סוגי ההמלצות הבאים:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN מומלץ להצטרף לשיטת הבידינג 'מקסימום ערך המרות'
  • IMPROVE_GOOGLE_TAG_COVERAGE שממליץ לפרוס את Google Tag בדפים נוספים
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN שממליץ להפעיל את התכונה 'התאמת כתובת URL סופית' בקמפיינים למיקסום הביצועים
  • ההמלצה REFRESH_CUSTOMER_MATCH_LIST היא לעדכן רשימת לקוחות שלא עודכנה ב-90 הימים האחרונים
  • CUSTOM_AUDIENCE_OPT_IN הממליץ ליצור קהל בהתאמה אישית
  • השיטה LEAD_FORM_ASSET מומלץ להוסיף נכסי השארת פרטים ברמת הקמפיין או הלקוח
  • IMPROVE_DEMAND_GEN_AD_STRENGTH הממליץ לשפר את חוזק המודעה בקמפיינים ליצירת ביקוש

קמפיינים של שופינג

• הוספנו את CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT וגם CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS כדי לספק שגיאות מפורטות יותר בקמפיינים של שופינג שמקושרים לחשבון Comparison Shopping Service Center.
• הוסיפו את הערכים הבאים אל AssetGroupListingGroupFilterError:
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

יעדים במחזור החיים

• הוספנו את update ל-CustomerLifecycleGoalOperation ול-CampaignLifecycleGoalOperation כדי שסוגי הפעולות האלה יהיו תואמים לסוגי הפעולות האחרים ב-API.

גרסה 15 (18.10.2023)

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

ניהול חשבון

• אם החשבון שלכם מושעה בגלל פעילות לא מורשית בחשבון, הערכים customer.status ו-customer_client.status מוחזרים בתור SUSPENDED. בעבר, הם הוחזרו בתור ENABLED.
• נוספה תמיכה בהוספה ובהסרה של קישור בין חשבון Google Ads לבין חשבון Merchant Center:
  • נוספו ProductLink.merchant_center ו-MerchantCenterIdentifier.
  • ההוספה LinkedProductType.MERCHANT_CENTER נוספה.
• הוספנו את ProductLinkInvitationService ואת ProductLinkInvitation כדי לתמוך בעדכון של הזמנת קישור שנשלחה ממוצרים אחרים, שזמינים לחשבונות Hotel Center ו-Merchant Center.
• בוצעה הסרה של MerchantCenterLinkService.
  • כדי לקשר חשבונות Google Ads לחשבונות Merchant Center, צריך להשתמש ב-ProductLinkInvitationService וב-ProductLinkService.
• האפשרות AccountLink.hotel_center הוסרה ואין תמיכה בעדכון של הזמנות קישורים מחשבונות Hotel Center באמצעות AccountLinkService.
  • כדי לעדכן הזמנת קישור מחשבון Hotel Center, יש להשתמש ב- ProductLinkInvitationService.

נכסים

• הערך ImageAdInfo.media_file הוחלפה ב-ImageAdInfo.image_asset כדי לתמוך בהוספה ובהסרה של תמונות באמצעות הנכסים. כתוצאה מכך, הסרנו גם את MediaFileService, שכבר לא נחוץ.
• התג ListingGroupFilterDimension.webpage נוסף כדי לתמוך ביצירת מסנן של קבוצות של כרטיסי מוצר, שמבוסס על תוויות מותאמות אישית ומחרוזות משנה של כתובות URL.
  • החלפנו גם את AssetGroupListingGroupFilter.vertical ב-AssetGroupListingGroupFilter.listing_source וב-ListingGroupFilterListingSource
• הוספתם את asset_group_asset.source כדי להציג את מקור הנכס של קבוצת הנכסים.
• הוספתם את ad_group_ad_asset_view.source כדי להציג את המקור של נכס שמצורף למודעה של קבוצת המודעות.

קהלים

• להתאמה ללקוחות, מוסיפים CustomerMatchUserListMetadata.consent כדי לתמוך בקבלת הסכמה. החל מ-6 במרץ 2024 אם משתמשים ב-EEA לא הביעו הסכמה, ערך ההסכמה יקבע כאי הבעת הסכמה. נתונים ממשתמשים ב-EEA שלא הביעו הסכמה לא יעובדו, ולא ניתן יהיה להשתמש בהם לצורך התאמה אישית של מודעות באמצעות 'התאמה ללקוחות'. מידע נוסף זמין במדריך בנושא התאמה ללקוחות.
• למכירות בחנות הפיזית, מוסיפים את המאפיין UserData.consent כדי לתמוך בשליחת הסכמה. מידע נוסף זמין במדריך שלנו בנושא מכירות בחנות הפיזית. אם אתם משתמשים בתכונה 'התאמה ללקוחות' בשילוב עם מכירות בחנות הפיזית, תוכלו למצוא מידע נוסף בקטע שאלות נפוצות.
• הוספתם את UserList.lookalike_user_list כדי לתמוך ביצירת פלח דומה לרשימה קיימת, קהל שנוצר על סמך קהל המקור הקיים שסופק. אפשר להשתמש בפלחים דומים רק בקמפיין ליצירת ביקוש.

קמפיינים

• עדכונים בקמפיינים למיקסום הביצועים:

  • AssetGroupSignal תומך עכשיו בשני סוגי אותות שאפשר לצרף לקבוצת נכסים כדי לשפר את הטירגוט:
    • AssetGroupSignal.audience
      • נוספו Audience.scope ו-Audience.asset_group כדי להגביל את השימוש בקהל לקבוצת נכסים ספציפית. צריך להגדיר את Audience.asset_group אם ורק אם Audience.scope הוא ASSET_GROUP.
    • AssetGroupSignal.search_theme
      • נוסף CriterionType.SEARCH_THEME כדי לתמוך בסוג הקריטריון החדש הזה. אפשר להשתמש בסוג הקריטריון החדש הזה רק בקמפיינים למיקסום ביצועים כדי ליצור AssetGroupSignal, על ידי אכלוס הקהל AssetGroupSignal.search_theme בקריטריון SearchThemeInfo.
  • התג AssetGroupSignalOperation.exempt_policy_violation_keys נוסף כדי לתמוך בבקשת הפטור כשמוסיפים אותות של קבוצות נכסים.
  • נוסף asset_group_top_combination_view חדש כדי לדווח על הנכסים שמניבים את הביצועים הטובים ביותר ברמת קבוצת הנכסים.
  • עכשיו אפשר לשלוח שאילתות לגבי asset_group עם שדות מדדים כדי לתמוך באחזור הביצועים של קמפיין למיקסום ביצועים.
  • במסמך PerformanceMaxUpgradeStatus, השם של UPGRADE_ELIGIBLE השתנה ל-UPGRADE_ELIGIBLE.

• בקמפיינים ליצירת ביקוש ובקמפיינים עם יעד עלות להמרה Discovery, הסימולציות של הצעת המחיר לפי יעד עלות להמרה (campaign_simulation.target_cpa_point_list.points) ברמת הקמפיין מחזירות עכשיו את הערך TargetCpaSimulationPoint.interactions במקום TargetCpaSimulationPoint.clicks.

• הוספנו את האובייקט BrandSuggestionService שיכול להציע מותגים על סמך קידומת המותג שסיפקתם והרשימת המותגים שלא נכללים. אפשר להשתמש במותגים האלה כדי ליצור קריטריון מסוג BRAND, להוסיף אותו ל-BRANDS קבוצה משותפת ולאחר מכן לצרף אותו לקמפיין באמצעות יצירת CampaignCriterion עם brand_list מוגדר לקבוצה המשותפת. אפשר לטרגט את הקריטריונים של הקמפיינים בקמפיינים לרשת החיפוש ולהחריג אותם בקמפיינים למיקסום הביצועים, בהתאמה.

  • שדות:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • ערכים לדוגמה:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• הוספת את Campaign.asset_automation_settings[] כדי להציג את סטטוס האוטומציה של כל סוג נכס.

• הוספנו את הערכים הבאים ל-enum CampaignPrimaryStatusReason:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

המרות

• נוספו CallConversion.consent ו-ClickConversion.consent כדי לתמוך בשליחת הסכמה. לפרטים נוספים מומלץ לעיין במדריך להמרות מסוג שיחות ובמדריך להמרות קליקים.
• הוספנו את השדות הבאים שקשורים להמרות ב-SKAdNetwork, שזמינים בעקבות שליחת שאילתות לגבי ההמרות באמצעות customer או campaign:
  • פלחים:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • מדדים:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• הערך metrics.sk_ad_network_conversions הוחלף בערך metrics.sk_ad_network_installs.
• נוספה תמיכה באבחון של העלאות של המרות אופליין
  • העברתם את השדה offline_conversion_upload_client_summary משדה במשאב customer לדוח ברמה העליונה. אפשר להשתמש בדוח הזה כדי לקבל פרטים שימושיים על סטטוס העלאת ההמרות, כמו מספר האירועים שהושלמו, שיעור ההצלחה ואחוז השגיאות.
    • אזהרה: המרה שהועלתה אבל מובילה לשגיאה ConversionUploadError.CLICK_NOT_FOUND עדיין נחשבת כמוצלחת, אבל היא מסומנת גם כ-OfflineConversionAlert.
  • הוספנו את job_id כפרמטר אופציונלי לסוגי הבקשות הבאים, כדי שאפשר יהיה לקבץ באופן לוגי מספר בקשות העלאה למשימה רעיונית אחת:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • הוספת את INVALID_JOB_ID לשגיאות הבאות:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • הטקסט INVALID_CONVERSION_ACTION הוחלף ב-NO_CONVERSION_ACTION_FOUND וב-INVALID_CONVERSION_ACTION_TYPE בשגיאות הבאות:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• הוספנו שלושה דוחות כדי לתמוך בשיוך חוצה-רשתות של ארגז החול לפרטיות ב-Android ללא הפניות לכתובת אחרת:
  • android_privacy_shared_key_google_campaign שמכיל את shared_campaign_key וכמה שדות שעוזרים לקודד את המפתח.
  • android_privacy_shared_key_google_ad_group שמכיל את shared_ad_group_key וכמה שדות שעוזרים לקודד את המפתח.
  • android_privacy_shared_key_google_network_type שמכיל את shared_network_type_key וכמה שדות שעוזרים לקודד את המפתח.
• ההוספה ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS נוספה. כשמפעילים את השגיאה הזו, ConversionActionOperation כשמנסים להשתמש באחד ממודלים של שיוך מבוסס-כללים שהוצאו משימוש, נכשלים. בעבר, הפעולה נכשלה עם השגיאה UNKNOWN.

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

• נוספה תמיכה בשדות הבאים ב-travel_activity_group_view וב-travel_activity_performance_view:
  • פלחים:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • מדדים:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

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

• התג LocalServicesSettings והשדות שלו נוספו לדוח customer כדי להחזיר את הסטטוסים המפורטים של רישיון וביטוח של מפרסם ב-'Google בעלי מקצוע'.
• נוספו הדוחות החדשים הבאים לגבי Local Services:
  • local_services_lead מכיל את כל הפרטים שקשורים ללידים ב-מודעות 'Google בעלי מקצוע', כמו lead_charged, lead_type ו-lead_status.
    • ערכים לדוגמה:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation מכיל פרטים על ההודעה ועל שיחת הטלפון, כמו conversation_channel, call_duration_millis ו-call_recording_url.
    • כתובת ה-URL להקלטה של שיחות הטלפון מאומתת מול חשבון היעד של הלקוח וחשבונות הניהול שלו.
  • local_services_verification_artifact מחזירה נתונים של מפרסם ב-'Google בעלי מקצוע', כמו בדיקת רקע, רישיונות עסק ונתוני ביטוח עסק. אפשר לגשת לכל מסמך שקשור לרישיון ולביטוח דרך כתובת URL.
    • ערכים לדוגמה:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

תכנון

• נוספה תמיכה בהחזרה Forecast.views ו-PlannedProductForecast.views בשביל ReachPlanService.ListPlannableProducts בסוגי המוצרים הרלוונטיים.
• נוספה תמיכה בהחזרת PlannableTargeting.surface_targeting ל-ReachPlanService.ListPlannableProducts, שמתארת את הפלטפורמות הזמינות למוצר.
• נוסף enum חדש ב-ReachPlanSurface.
• נוספה תמיכה בטירגוט Target frequency (תדירות הטירגוט) באמצעות הפונקציה AdvancedProductTargeting.target_frequency_settings, שמחזירה את הערך PlannedProductForecast.average_frequency.
• הוספת את AudienceInsightsService.GenerateSuggestedTargetingInsights כדי להחזיר את ההצעות לקהלים שניתן לטרגט.
• הוסיפו את הערכים הבאים אל ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

המלצות

• נוסף RecommendationSubscriptionService שמנהל את המינויים להמלצות:
  • משאב: RecommendationSubscription
  • שדה: MutateOperation.recommendation_subscription_operation
  • ערכים לדוגמה: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • שגיאות:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• הוספנו את סוגי ההמלצות הבאים:
  • FORECASTING_SET_TARGET_CPA שממליץ להגדיר יעד עלות להמרה לקמפיינים שלא צוינה מראש, לפני אירוע עונתי שצפוי להגדיל את תנועת הגולשים.
  • SET_TARGET_CPA שממליץ להגדיר יעד עלות להמרה לקמפיינים שלא צוין בהם יעד.
  • SET_TARGET_ROAS שממליץ להגדיר יעד החזר על הוצאות פרסום לקמפיינים שלא צוין בהם יעד.

דיווח

• נוספו המדדים החדשים הבאים, שאפשר לשלוח להם שאילתות באמצעות campaign (זמין לקמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות) וגם segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

קמפיינים של שופינג

• בוצעה הסרה של ShoppingSetting.sales_country, שהערכים שלו מוחזרים עכשיו בתור ShoppingSetting.feed_label.
  • תוכלו להמשיך להשתמש בפיד ספציפי של Merchant Center בקמפיין באמצעות השדה ShoppingSetting.feed_label. צריך להגדיר אותו לערך של תווית הפיד או לקוד המדינה בן שתי האותיות שהשתמשתם בו בעבר ב-ShoppingSetting.sales_country. לפרטים נוספים אפשר לעיין במאמר התמיכה בנושא תוויות פיד.
• הוסרה התלות של קטגוריות מוצרים בקוד מדינה בדוחות. קבוצת מזהי הקטגוריות הנתמכים לא השתנתה.
  • החלפנו את השדות הבאים שנעשה בהם שימוש ב-shopping_performance_view:
    • segments.product_bidding_category_level1 עם segments.product_category_level1
    • segments.product_bidding_category_level2 עם segments.product_category_level2
    • segments.product_bidding_category_level3 עם segments.product_category_level3
    • segments.product_bidding_category_level4 עם segments.product_category_level4
    • segments.product_bidding_category_level5 עם segments.product_category_level5
  • הוחלפה הערך product_bidding_category_constant ב-product_category_constant, שמחזיר את כל ההתאמות הזמינות של קטגוריה מסוימת בשדה חוזר.
  • הערך ListingDimensionInfo.product_bidding_category הוחלף בערך ListingDimensionInfo.product_category.
  • הערך ListingGroupFilterDimension.product_bidding_category הוחלף בערך ListingGroupFilterDimension.product_category.
• התמיכה בהוספת Campaign.shopping_setting לקמפיינים לרשת החיפוש הוסרה. אם תנסו ליצור קמפיין לרשת החיפוש עם Campaign.shopping_setting או עם Campaign.shopping_setting לקמפיין קיים לרשת החיפוש, התוצאה תהיה OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• הסרנו את התמיכה בהוספה של CampaignCriterion.listing_scope לקמפיינים לרשת החיפוש. הוספה של CampaignCriterion.listing_scope לקמפיין קיים לרשת החיפוש תוביל עכשיו ל-OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• נוספו המדדים הבאים של המרות עם נתונים מעגלות קניות:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • אפשר לבחור את כל המדדים האלה בדוחות הבאים:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

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

• נוסף CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals כדי להגדיר יעדי צירוף לקוחות ברמת הלקוח.
  • לדיווח: customer_lifecycle_goal
• נוסף CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals כדי להגדיר יעדי צירוף לקוחות ברמת הקמפיין.
  • לדיווח: campaign_lifecycle_goal
• ההוספה CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN נוספה.
• הוסיפו את הערכים הבאים אל ConversionGoalCampaignConfigError:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

סרטונים

• נוספה תמיכה בטירגוט ל-Google TV ברמת הקמפיין:
  • הוספת את NetworkSettings.target_google_tv_network
  • ההוספה AdNetworkType.GOOGLE_TV נוספה.
• נוספה תמיכה בטירגוט YouTube ברמת הקמפיין:
  • הוספת את NetworkSettings.target_youtube
  • באפליקציה AdNetworkType, ממוזגים YOUTUBE_WATCH ו-YOUTUBE_SEARCH ל-YOUTUBE.
  • ההוספה CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE נוספה.

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

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