הערות מוצר

גרסה 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

נכסים

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

קמפיינים

• השם של קמפיינים מסוג 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

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

• הוספת את 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.

קמפיינים

• תמיכה בהחזרת Target סימולציות של הצעות מחיר לקמפיינים עבור קמפיינים לקידום אפליקציות שנעשה בהם שימוש דיווח 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.

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

• 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 שזו סוג התוכנית לאימות הזהות.
    • 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

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

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

ניהול חשבון

• אם החשבון שלכם מושעה בגלל חשבון לא מורשה activity, customer.status וגם customer_client.status מוחזרים עכשיו בתור SUSPENDED. בעבר, הם הוחזרו בתור ENABLED
• נוספה תמיכה בהוספה ובהסרה של קישור בין חשבון Google Ads לבין חשבון Merchant Center:
  • תאריך ההוספה ProductLink.merchant_center ו- MerchantCenterIdentifier
  • תאריך ההוספה LinkedProductType.MERCHANT_CENTER
• תאריך ההוספה ProductLinkInvitationService ו- ProductLinkInvitation לתמיכה עדכון הזמנת קישור שנשלחה ממוצרים אחרים, שזמינה למלון Center ו-Merchant מרכז חשבונות.
• בוצעה הסרה של 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 שלא הביעו הסכמה לא יעובדו, ולא ניתן יהיה להשתמש בהם להצגת מודעות התאמה אישית באמצעות התאמה ללקוחות. כדאי לקרוא את מדריך בנושא התאמה ללקוחות אפשר לקבל פרטים נוספים.
• עבור מכירות בחנות הפיזית, הוספתם את 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[] כדי להציג את סטטוס האוטומציה של כל סוג נכס.

• הוסיפו את הערכים הבאים אל CampaignPrimaryStatusReason טיפוסים בני מנייה (enum):

  • 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 להחזרת מוצר מקומי הסטטוסים המפורטים של רישיון וביטוח של מפרסם השירותים.
• נוספו הדוחות החדשים הבאים עבור Local שירותים:
  • local_services_lead מכיל את כל הערכים פרטים שקשורים ל-Google בעלי מקצוע Ads לידים כמו 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, שמתארת את הפלטפורמות הזמינות למוצר.
• נוסף פריט חדש ReachPlanSurface 'טיפוסים בני מנייה (enum)'.
• תמיכה נוספת בטירגוט Target תדירות באמצעות 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 שממליץ להגדיר יעד עלות להמרה (CPA) לקמפיינים שאין להם מראש, לפני אירוע עונתי שצפוי לעלות .
  • SET_TARGET_CPA שממליץ להגדיר יעד עלות להמרה (CPA) לקמפיינים שאין להם יעד כזה שציינת.
  • SET_TARGET_ROAS שממליץ להגדיר יעד החזר על הוצאות פרסום לקמפיינים שאין להם יעד כזה שציינת.

דיווח

• נוספו המדדים החדשים הבאים, שאפשר לשלוח להם שאילתות campaign (זמין בקמפיינים לרשת המדיה, בקמפיינים של מודעות וידאו, בקמפיינים מסוג Discovery וגם בקמפיינים מסוג 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

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

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