גרסה 17 (05.06.2024)
התכונות והשינויים הבאים נוספו בגרסה 17.
מודעות
- בוצעה הסרה של
AdService.getAd
. כךAdService
מותאם לשירותים אחרים ב-Google Ads API. במאמר אחזור אובייקטים מוסבר מהי הדרך המומלצת לאחזור מודעות וסוגי משאבים אחרים. - נוספו עוד אימותים לגבי
ImageAdInfo.image_asset
לגבי מאפיינים ופורמט. אם התמונה לא תקינה, יכול להיות שיוצגו השגיאות הבאות:
נכסים
- נוסף enum חדש:
ClickType.AD_IMAGE
- הוספנו את הדוחות החדשים הבאים עם מדדים חדשים בקמפיינים למיקסום הביצועים ובקמפיינים לרשת החיפוש:
קהלים
משימות באצווה
- נוסף
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
.
- השם של
- המדדים הבאים מוחזרים עכשיו עם התשובה, גם כשהם אפס. כך הם תואמים למדדים אחרים.
קריטריונים
- נוספו לשדות הבאים אל
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
שמסופק. היא יוצרת סשן אימות חדש ומחזירה תגובה ריקה עבור אימות שנוצר.GetIdentityVerification()
יכול לשמש לאחזור פרטי אימות, שמחזירים כמה אובייקטים שלIdentityVerification
. כלIdentityVerification
כולל:verification_program
– סוג התוכנית לאימות הזהות (IDV)identity_verification_requirement
שכולל פרטים שקשורים לתאריך היעד האחרון שבו המפרסם צריך להשלים את האימותverification_progress
שכולל פרטים שקשורים לסשן האימות, כולל:program_status
מייצג את הסטטוס הנוכחי של סשן האימותaction_url
מפנה את הלקוח לכתובת URL כדי להשלים את האימות.invitation_link_expiration_time
מייצג את תאריך התפוגה שלaction_url
- ערכים לדוגמה:
- שגיאות:
- ההוספה
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
עבור מודעה בפלטפורמת 'דברים שאפשר לעשות' כדי לאפשר יצירת קבוצות של כרטיסי מוצר על סמך המדינה והעיר שבהן פעילות הנסיעות זמינה: - נוספה תמיכה בפלחים הבאים ל-
travel_activity_performance_view
:
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
.
- כדי לקשר חשבונות Google Ads לחשבונות Merchant Center, צריך להשתמש ב-
- האפשרות
AccountLink.hotel_center
הוסרה ואין תמיכה בעדכון של הזמנות קישורים מחשבונות Hotel Center באמצעותAccountLinkService
.- כדי לעדכן הזמנת קישור מחשבון Hotel Center, יש להשתמש ב-
ProductLinkInvitationService
.
- כדי לעדכן הזמנת קישור מחשבון Hotel Center, יש להשתמש ב-
נכסים
- הערך
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
מוגדר לקבוצה המשותפת. אפשר לטרגט את הקריטריונים של הקמפיינים בקמפיינים לרשת החיפוש ולהחריג אותם בקמפיינים למיקסום הביצועים, בהתאמה.הוספת את
Campaign.asset_automation_settings[]
כדי להציג את סטטוס האוטומציה של כל סוג נכס.הוספנו את הערכים הבאים ל-enum
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
המרות
- נוספו
CallConversion.consent
ו-ClickConversion.consent
כדי לתמוך בשליחת הסכמה. לפרטים נוספים מומלץ לעיין במדריך להמרות מסוג שיחות ובמדריך להמרות קליקים. - הוספנו את השדות הבאים שקשורים להמרות ב-SKAdNetwork, שזמינים בעקבות שליחת שאילתות לגבי ההמרות באמצעות
customer
אוcampaign
: - הערך
metrics.sk_ad_network_conversions
הוחלף בערךmetrics.sk_ad_network_installs
. - נוספה תמיכה באבחון של העלאות של המרות אופליין
- העברתם את השדה
offline_conversion_upload_client_summary
משדה במשאבcustomer
לדוח ברמה העליונה. אפשר להשתמש בדוח הזה כדי לקבל פרטים שימושיים על סטטוס העלאת ההמרות, כמו מספר האירועים שהושלמו, שיעור ההצלחה ואחוז השגיאות.- אזהרה: המרה שהועלתה אבל מובילה לשגיאה
ConversionUploadError.CLICK_NOT_FOUND
עדיין נחשבת כמוצלחת, אבל היא מסומנת גם כ-OfflineConversionAlert
.
- אזהרה: המרה שהועלתה אבל מובילה לשגיאה
- הוספנו את
job_id
כפרמטר אופציונלי לסוגי הבקשות הבאים, כדי שאפשר יהיה לקבץ באופן לוגי מספר בקשות העלאה למשימה רעיונית אחת: - הוספת את
INVALID_JOB_ID
לשגיאות הבאות: - הטקסט
INVALID_CONVERSION_ACTION
הוחלף ב-NO_CONVERSION_ACTION_FOUND
וב-INVALID_CONVERSION_ACTION_TYPE
בשגיאות הבאות:
- העברתם את השדה
- הוספנו שלושה דוחות כדי לתמוך בשיוך חוצה-רשתות של ארגז החול לפרטיות ב-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
:- פלחים:
- מדדים:
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
.- ערכים לדוגמה:
local_services_lead_conversation
מכיל פרטים על ההודעה ועל שיחת הטלפון, כמוconversation_channel
,call_duration_millis
ו-call_recording_url
.- כתובת ה-URL להקלטה של שיחות הטלפון מאומתת מול חשבון היעד של הלקוח וחשבונות הניהול שלו.
local_services_verification_artifact
מחזירה נתונים של מפרסם ב-'Google בעלי מקצוע', כמו בדיקת רקע, רישיונות עסק ונתוני ביטוח עסק. אפשר לגשת לכל מסמך שקשור לרישיון ולביטוח דרך כתובת URL.
תכנון
- נוספה תמיכה בהחזרה
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
שמנהל את המינויים להמלצות: - הוספנו את סוגי ההמלצות הבאים:
FORECASTING_SET_TARGET_CPA
שממליץ להגדיר יעד עלות להמרה לקמפיינים שלא צוינה מראש, לפני אירוע עונתי שצפוי להגדיל את תנועת הגולשים.SET_TARGET_CPA
שממליץ להגדיר יעד עלות להמרה לקמפיינים שלא צוין בהם יעד.SET_TARGET_ROAS
שממליץ להגדיר יעד החזר על הוצאות פרסום לקמפיינים שלא צוין בהם יעד.
דיווח
- נוספו המדדים החדשים הבאים, שאפשר לשלוח להם שאילתות באמצעות
campaign
(זמין לקמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות) וגםsegments.device
:
קמפיינים של שופינג
- בוצעה הסרה של
ShoppingSetting.sales_country
, שהערכים שלו מוחזרים עכשיו בתורShoppingSetting.feed_label
.- תוכלו להמשיך להשתמש בפיד ספציפי של Merchant Center בקמפיין באמצעות השדה
ShoppingSetting.feed_label
. צריך להגדיר אותו לערך של תווית הפיד או לקוד המדינה בן שתי האותיות שהשתמשתם בו בעבר ב-ShoppingSetting.sales_country
. לפרטים נוספים אפשר לעיין במאמר התמיכה בנושא תוויות פיד.
- תוכלו להמשיך להשתמש בפיד ספציפי של Merchant Center בקמפיין באמצעות השדה
- הוסרה התלות של קטגוריות מוצרים בקוד מדינה בדוחות.
קבוצת מזהי הקטגוריות הנתמכים לא השתנתה.
- החלפנו את השדות הבאים שנעשה בהם שימוש ב-
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
- אפשר לבחור את כל המדדים האלה בדוחות הבאים:
יעדים מאוחדים
- נוסף
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
נוספה.
- הוספת את
נתוני הגרסה שהועברו לארכיון
נתוני הגרסה של נתוני הגרסה שהועברו לארכיון מופיעים בקטע גרסאות מנותקות.