גרסה 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
הוא סוג התוכנית לאימות הזהותidentity_verification_requirement
שמכיל פרטים שקשורים לתאריך היעד שבו המפרסם צריך לסיים את תהליך האימותverification_progress
שמכיל פרטים שקשורים לסשן האימות, כולל:program_status
מייצג את הסטטוס הנוכחי של סשן האימות הזה- הקוד
action_url
מפנה את הלקוח לכתובת URL כדי להשלים את האימות. invitation_link_expiration_time
מייצג את תאריך התפוגה שלaction_url
- טיפוסים בני מנייה (enums):
- שגיאות:
- הקוד
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
התואם, שזמינים לקמפיינים ליצירת ביקוש עם ערך לא nullCampaign.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:
- הוספנו את
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, ערך ההסכמה יקבע כאי הבעת הסכמה. הנתונים ממשתמשים באזור הכלכלי האירופי שלא הביעו הסכמה לא יעובדו, ולא תהיה אפשרות להשתמש בהם להתאמה אישית של מודעות באמצעות 'התאמה ללקוחות'. לפרטים נוספים, קראו את המדריך להתאמה ללקוחות. - לגבי מכירות בחנות הפיזית, הוספנו את הפרמטר
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
לקבוצה המשותפת. אפשר לטרגט את הקריטריונים של הקמפיינים בקמפיינים לרשת החיפוש ולהחריג אותם בקמפיינים למיקסום ביצועים, בהתאמה.- שדות:
- טיפוסים בני מנייה (enums):
Campaign.asset_automation_settings[]
נוסף כדי להציג את סטטוס האוטומציה של כל סוג נכס.הוספת את הערכים הבאים למספר
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_lead
תוכלו למצוא את כל הפרטים שקשורים ללידים ב-Local Services Ads, כמוlead_charged
,lead_type
,lead_status
.- טיפוסים בני מנייה (enums):
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
, שמתארת את הפלטפורמות הזמינות של המוצר. - הוספתי טיפוסים בני
ReachPlanSurface
חדשים. - נוספה תמיכה בטירגוט טירגוט לתדירות באמצעות
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
מומלץ להגדיר יעד עלות להמרה (CPA) בקמפיינים שלא צוין עבורם יעד כזה, לפני אירוע עונתי שצפוי להגדיל את נפח התנועה.SET_TARGET_CPA
מומלץ להגדיר יעד עלות להמרה בקמפיינים שלא צוין עבורם יעד עלות להמרה.SET_TARGET_ROAS
שמומלץ להגדיר יעד החזר על הוצאות פרסום (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
. - נוספו המדדים הבאים של המרות עם נתונים מעגלות קניות (CwCD):
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
להגדרת יעדים של צירוף לקוחות ברמת הלקוח. - נוסף
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
להגדרת יעדים לצירוף לקוחות ברמת הקמפיין. 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 ברמת הקמפיין:
- תמיכה נוספת בטירגוט ל-YouTube ברמת הקמפיין:
NetworkSettings.target_youtube
נוסף- בסרטון
AdNetworkType
, מוזגוYOUTUBE_WATCH
ו-YOUTUBE_SEARCH
לתוךYOUTUBE
. CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
נוסף.
גרסה 14.1.0 (09.08.2023)
התכונות והעדכונים החדשים הבאים הושקו בגרסה 14.1.
ניהול חשבון
Customer.customer_agreement_setting
אפשר לראות אם הלקוח אישר את התנאים וההגבלות של נכס השארת הפרטים
נכסים
- שדות חדשים ב-
AssetGroup
, שמאפשרים לראות אם קבוצת הנכסים מציגה מודעות או את הסיבות לכך:primary_status
primary_status_reasons
- שדות חדשים ב-
AssetGroupAsset
, שמאפשרים לראות אם הנכס של קבוצת הנכסים מוצג או את הסיבות לכך:primary_status
primary_status_details
primary_status_reasons
- ערכים חדשים בסוג החשבון
CallToActionType
:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- ערכים חדשים במספרים
AssetLinkError
:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
חיוב
- שדות חדשים ב-
Invoice
וב-AccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
קמפיינים
ערכים חדשים בסוג החשבון
CampaignPrimaryStatusReason
:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(חשבונות ברשימת ההיתרים בלבד)
DiscoveryCampaignSettings
עםupgraded_targeting
:- אם השדה
upgraded_targeting
מוגדר ל-true
, אפשר להוסיף מיקום ושפה כקריטריון של קבוצת מודעות
- אם השדה
קריטריונים
ערך 'טיפוסים בני מנייה (enum) חדש':
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(חשבונות ברשימת ההיתרים בלבד) תמיכה בהוספת
LanguageInfo
ו-LocationInfo
בתורAdGroupCriterion
:- האפשרות הזו זמינה רק בקמפיין Discovery שהטירגוט המשודרג מופעל בו
ניסויים
- ערכים חדשים במספרים
ExperimentError
:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
המלצות
- סוגים חדשים של המלצות:
PerformanceMaxOptInRecommendation
שמומלץ ליצור את הקמפיין הראשון למיקסום הביצועים בחשבוןImprovePerformanceMaxAdStrengthRecommendation
מומלץ לשפר את העוצמה של קבוצת הנכסים בקמפיין למיקסום הביצועיםMigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
מומלץ להעביר קמפיין של מודעות דינמיות לרשת החיפוש לקמפיין למיקסום ביצועים
דיווח
- מדדים ופלחים חדשים לגבי לקוחות חדשים לעומת חוזרים:
- תצוגות חדשות ב-
customer_search_term_insight
וב-campaign_search_term_insight
:metrics.search_volume
מציג את טווח הנפח של קטגוריית תובנות לגבי מונחי חיפוש
שופינג
- שדות חדשים לקבוצות של כרטיסי מוצר:
- שדה חדש:
ShoppingSetting.advertising_partner_ids
- ערכים חדשים במספרים
CampaignError
:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
סרטונים
- (חשבונות ברשימת ההיתרים בלבד)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
והחשבונות התואמים להםDiscoveryVideoResponsiveAdInfo
גרסה 14 (07.06.2023)
התכונות והעדכונים החדשים הבאים הושקו בגרסה 14.
קמפיינים
המרות
נוספה תמיכה בזיהוי המרות ב-Google Analytics ובקביעה אם המרה מיובאת מנכס Universal Analytics או מנכס GA4:
- נוספו הערכים הבאים ל-
ConversionActionType
:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
- הוספת את
ConversionAction.google_analytics_4_settings
- נוספו הערכים הבאים ל-
הוספנו את הקוד
Customer.offline_conversion_client_summaries
, שמסכם את פרטי הסטטוס והאבחון של ההעלאות וההתאמות של ההמרות אופליין שבוצעו על ידי הלקוח.- טיפוסים בני מנייה (enums)
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- טיפוסים בני מנייה (enums)
הוספנו את
job_id
לתגובות שהוחזרו על ידיConversionAdjustmentUploadService.UploadConversionAdjustments
ו-ConversionUploadService.UploadClickConversions
על מנת לשייך תשובה ל-OfflineConversionUploadSummary.job_id
.
קריטריונים
נוספה תמיכה באחזור, ביצירה ובעדכון של מילות מפתח שליליות ברמת החשבון:
- שדות:
- טיפוסים בני מנייה (enums):
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- שגיאות:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
מודעות להזמנת חדרים
- שינית את השם של
SuggestTravelAssetsRequest.place_id
לשםSuggestTravelAssetsRequest.place_ids
תכנון
- הסרנו את השיטות הבאות מ-
KeywordPlanService
:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- הוספנו את
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
כדי לתמוך ביצירת מדדי תחזית לקמפיינים של מילות מפתח בלי שיהיה צורך ליצור קודם תוכנית מילות מפתח. - הוסרה התמיכה באחזור הדוח
campaign_criterion_simulation
- הוספנו תמיכה ב-
YOUTUBE_DYNAMIC_LINEUP
כמאפיין ב-AudienceInsightsService.ListAudienceInsightsAttributes
. - נוסף
DynamicLineupAttributeMetadata.sample_channels
, שמשמש בתגובותGenerateAudienceCompositionInsights
כדי לספק ערוצים לדוגמה בתוך חבילות ערוצים.
המלצות
- התווסף
DynamicImageExtensionOptInRecommendation
, שממליץ להפעיל בחשבון תוספי תמונות דינמיים - הוספנו את
LowerTargetRoasRecommendation
, שממליץ להקטין את יעד ההחזר על הוצאות הפרסום - הוספת
RaiseTargetCpaRecommendation
עם המלצה להעלות את יעד העלות להמרה - הוספת את
ResponsiveSearchAdAssetRecommendation.current_ad
דיווח
- נוספו ל-
ServedAssetFieldType
הערכים הבאים, שזמינים מ-ad_group_ad_asset_view.pinned_field
:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
נתוני הגרסה שהועברו לארכיון
להצגת נתוני הגרסה שהועברו לארכיון, אפשר לעיין בגרסאות ללא שינוי.