نسخه 16.1.0 (24-04-2024)
ویژگی ها و تغییرات زیر در نسخه 16.1 اضافه شده است.
مدیریت حساب
-
CustomerNegativeCriterion.ip_block
که از افزودن IP به عنوان یک معیار منفی در سطح مشتری پشتیبانی می کند. - مقدار enum جدید:
ProductLinkError.LINK_EXISTS
. - مقدار enum جدید:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
دارایی های
- پشتیبانی از داراییهای مربوط به Demand Gen به
ad_group_ad_asset_view
وasset_field_type_view
. - مقدار enum جدید:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
مخاطبان
- مقدار enum جدید:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
که تعداد لیست های مشابه کاربر را که مشتری می تواند داشته باشد به 1000 محدود می کند.
کمپین ها
- پشتیبانی از شبیهسازیهای پیشنهادی کمپین هدف ROAS برای کمپینهای برنامه با استفاده از گزارش
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
. - مقدار شماره جدید:
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
-
- شماره جدید:
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
که نشانیهای اینترنتی را برمیگرداند که میتوان از آنها برای دانلود محتویات پیوست استفاده کرد.
فیلم های
-
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
را نشان می دهد
-
-
- فهرست ها:
- خطاها:
-
-
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
اضافه شد.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.
دارایی های
- تغییرات
asset_group
:- پشتیبانی از بخشهای مرتبط با زمان، مانند
segments.year
وsegments.month
اضافه شده است. - به جای تقسیمبندی منبع،
campaign
را به یک منبع منتسب تبدیل کرد.
- پشتیبانی از بخشهای مرتبط با زمان، مانند
کمپین ها
- تغییرات در کمپین های تقاضای نسل:
- پشتیبانی برای تنظیم
Campaign.shopping_setting
به کمپین نسل تقاضای موجود اضافه شد. -
ShoppingSetting.disable_product_feed
برای غیرفعال کردن فید محصول اختیاری کمپینهای Demand Gen اضافه شد. -
Ad.demand_gen_product_ad
وDemandGenProductAdInfo
مربوطه اضافه شد که برای کمپین های Demand Gen با یک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
اضافه شد.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE. -
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
اضافه شد.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.
هتل و سفر
- فیلدهای زیر را به آگهی
ListingDimensionInfo
for a Things to do اضافه کرد تا امکان ایجاد گروههای فهرستبندی بر اساس ایالت و شهری که فعالیت سفر در آن در دسترس است را فراهم کند: - پشتیبانی برای بخشهای زیر به
travel_activity_performance_view
اضافه شد:
خدمات محلی
-
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
وBusinessRegistrationCheckArtifact
اضافه شد تا به تبلیغکنندگان امکان نظارت بر روند تأیید ثبت کسب و کار را بدهد. - یک منبع جدید
local_services_employee
اضافه کرد تا به تبلیغکنندگان اجازه دهد اطلاعات کارمندانی را که اضافه کردهاند بازیابی کنند.
برنامه ریزی
-
score
ازAudienceInsightsAttributeMetadata
حذف شد.
توصیه ها
-
RecommendationService.GenerateRecommendations()
اضافه شد که توصیه هایی را بر اساس تنظیمات مشخص شده، مانند انواع توصیه ها و انواع کانال های تبلیغاتی، برمی گرداند. این به ویژه در طول ساخت کمپین مفید است. -
RecommendationMetrics.conversions_value
اضافه شد. - کلیدواژههای توصیهشده با نوع تطابق کلمه کلیدی تنظیمنشده، اکنون
recommended_match_type
به جایUNKNOWN
رویUNSPECIFIED
تنظیم کردهاند. - انواع توصیه های زیر را اضافه کرد:
-
MAXIMIZE_CONVERSION_VALUE_OPT_IN
که شرکت در استراتژی پیشنهاد قیمت حداکثر تبدیل را توصیه می کند -
IMPROVE_GOOGLE_TAG_COVERAGE
که استفاده از Google Tag را در صفحات بیشتری توصیه می کند -
PERFORMANCE_MAX_FINAL_URL_OPT_IN
که توصیه میکند بسط URL نهایی را برای کمپینهای Performance Max خود روشن کنید -
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
اضافه شد.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS به منظور ارائه خطاهای دقیقتر برای کمپینهای حساب خرید مرکز خرید مرتبط با یک Comparison . - مقادیر زیر را به
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
حذف شد و پشتیبانی از بهروزرسانی دعوتنامههای پیوند از حسابهای مرکز هتل با استفاده ازAccountLinkService
.- برای به روز رسانی یک دعوت نامه پیوند از حساب مرکز هتل، از
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
اضافه شد تا منبع دارایی آگهی گروه آگهی را نشان دهد.
مخاطبان
- برای Customer Match،
CustomerMatchUserListMetadata.consent
را اضافه کرد تا از ارائه رضایت پشتیبانی کند. از 6 مارس 2024، اگر رضایت کاربران منطقه اقتصادی اروپا وجود نداشته باشد، ارزش رضایت بهعنوان عدم رضایت تعیین میشود. دادههای کاربران بدون رضایت EEA پردازش نمیشوند و نمیتوانند برای شخصیسازی آگهی با استفاده از «تطابق با مشتری» استفاده شوند. راهنمای مطابقت مشتری ما را برای جزئیات بیشتر بررسی کنید. - برای فروش فروشگاه،
UserData.consent
را اضافه کرد تا از ارائه رضایت پشتیبانی کند. برای جزئیات بیشتر ، راهنمای فروش فروشگاه ما را بررسی کنید. اگر از «تطابق مشتری» با فروش فروشگاه استفاده میکنید، سؤالات متداول را برای اطلاعات بیشتر مرور کنید. -
UserList.lookalike_user_list
اضافه شد تا از ایجاد یک بخش Lookalike پشتیبانی کند، مخاطبی که براساس مخاطبان اولیه موجود ایجاد شده است. بخشهای مشابه را میتوان فقط در کمپین نسل تقاضا استفاده کرد.
کمپین ها
به روز رسانی کمپین های Performance Max:
-
AssetGroupSignal
اکنون از دو نوع سیگنال پشتیبانی میکند که میتوانند برای هدفیابی پیشرفته به یک گروه دارایی متصل شوند:-
AssetGroupSignal.audience
-
Audience.scope
وAudience.asset_group
برای محدود کردن استفاده مخاطبان به یک گروه دارایی خاص اضافه شد.Audience.asset_group
باید تنظیم شود اگر و فقط اگرAudience.scope
ASSET_GROUP
باشد.
-
-
AssetGroupSignal.search_theme
- برای پشتیبانی از این نوع معیار جدید،
CriterionType.SEARCH_THEME
اضافه شد. این نوع معیار جدید را فقط میتوان در کمپینهای Performance Max برای ایجادAssetGroupSignal
با پر کردنAssetGroupSignal.search_theme
با معیارSearchThemeInfo
استفاده کرد.
- برای پشتیبانی از این نوع معیار جدید،
-
-
AssetGroupSignalOperation.exempt_policy_violation_keys
برای پشتیبانی از درخواست معافیت هنگام افزودن سیگنال گروه دارایی اضافه شد. - یک
asset_group_top_combination_view
جدید برای گزارش داراییهای با عملکرد برتر در سطح گروه دارایی اضافه کرد. - هم اکنون
asset_group
را می توان با فیلدهای متریک برای پشتیبانی از بازیابی عملکرد کمپین حداکثر عملکرد جستجو کرد. - در
PerformanceMaxUpgradeStatus
، نامUPGRADE_ELIGIBLE
بهUPGRADE_ELIGIBLE
تغییر یافت.
-
برای کمپینهای Demand Gen و Discovery Target CPA، شبیهسازیهای پیشنهادی CPA هدف در سطح کمپین (
campaign_simulation.target_cpa_point_list.points
) اکنونTargetCpaSimulationPoint.interactions
را به جایTargetCpaSimulationPoint.clicks
برمیگرداند.BrandSuggestionService
اضافه شد که می تواند مارک هایی را بر اساس پیشوند مارک ارائه شده و لیست مستثنی شده مارک ها پیشنهاد کند. این مارکها را میتوان برای ایجاد یک معیارBRAND
استفاده کرد، به مجموعه مشترکBRANDS
اضافه کرد و سپس با ایجاد یکCampaignCriterion
با مجموعهbrand_list
به مجموعه مشترک، به کمپین پیوست. معیارهای کمپین را می توان به ترتیب در کمپین های جستجو هدف قرار داد و در کمپین های حداکثر عملکرد حذف کرد.- زمینه های:
- فهرست ها:
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
میشود. خطای CLICK_NOT_FOUND همچنان به عنوان موفقیتآمیز محسوب میشود، اما بهعنوانOfflineConversionAlert
نیز پرچمگذاری میشود.
- هشدار : تبدیلی که آپلود میشود اما منجر به خطای
-
job_id
بهعنوان یک پارامتر اختیاری برای انواع درخواستهای زیر اضافه کرد تا بتوانید بهطور منطقی چندین درخواست آپلود را در یک کار مفهومی گروهبندی کنید: -
INVALID_JOB_ID
به خطاهای زیر اضافه شد: - در خطاهای زیر
INVALID_CONVERSION_ACTION
باNO_CONVERSION_ACTION_FOUND
وINVALID_CONVERSION_ACTION_TYPE
جایگزین شد:
-
- سه گزارش برای پشتیبانی از انتساب بین شبکهای Sandbox Privacy 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
اضافه شد.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
-
تبلیغات خدمات محلی
-
LocalServicesSettings
و فیلدهای آن به گزارشcustomer
برای بازگرداندن مجوز و وضعیت بیمه دقیق تبلیغکننده خدمات محلی اضافه شد. - گزارشهای جدید زیر را برای خدمات محلی اضافه کرد:
-
local_services_lead
شامل تمام جزئیات مربوط به آگهیهای خدمات محلی است، مانندlead_charged
،lead_type
،lead_status
.- فهرست ها:
-
local_services_lead_conversation
حاوی جزئیات پیام و مکالمه تلفنی مانندconversation_channel
،call_duration_millis
،call_recording_url
است.- URL ضبط تماس تلفنی با حساب مشتری هدف و حسابهای مدیر آن تأیید میشود.
-
local_services_verification_artifact
مصنوعات تبلیغ کننده خدمات محلی مانند بررسی پیشینه، مجوزهای کسب و کار و داده های بیمه کسب و کار را برمی گرداند. هرگونه اسناد مرتبط با مجوز و بیمه را می توان از طریق یک 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
که توصیه میکند برای کمپینهایی که CPA مشخصی ندارند، یک CPA هدف تعیین کنید. -
SET_TARGET_ROAS
که توصیه میکند یک ROAS هدف را برای کمپینهایی که مشخص نشدهاند تعیین کنید.
-
گزارش نویسی
- سنجههای جدید زیر را اضافه کرد که میتوان با
campaign
(در دسترس برای کمپینهای Display، Video، Discovery، و App) وsegments.device
پرسوجو کرد:
خريد كردن
-
ShoppingSetting.sales_country
حذف شد که مقادیر آن اکنون به عنوانShoppingSetting.feed_label
برگردانده شده است.- میتوانید با استفاده از فیلد
ShoppingSetting.feed_label
، از یک فید Merchant Center خاص برای کمپین استفاده کنید. باید روی مقدار برچسب فید یا کد کشور دو حرفی که قبلاً برای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
- همه این معیارها با گزارش های زیر قابل انتخاب هستند:
-
اهداف یکپارچه
- برای پیکربندی اهداف جذب مشتری در سطح مشتری،
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
اضافه شد.- گزارش:
customer_lifecycle_goal
- گزارش:
-
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
برای پیکربندی اهداف جذب مشتری در سطح کمپین اضافه شد.- گزارش:
campaign_lifecycle_goal
- گزارش:
-
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
اضافه شد.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
اضافه شد.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 با هدف ارتقا یافته فعال است
آزمایش
- مقادیر جدید در Enum
ExperimentError
:-
DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
-
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
-
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
-
توصیه ها
- انواع جدید توصیه ها:
-
PerformanceMaxOptInRecommendation
که توصیه می کند اولین کمپین Performance Max را در حساب کاربری ایجاد کنید -
ImprovePerformanceMaxAdStrengthRecommendation
که بهبود قدرت گروه دارایی در کمپین Performance Max را توصیه می کند. -
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 معرفی شدند.
کمپین ها
-
CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD
اضافه شد.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD
تبدیل ها
پشتیبانی برای شناسایی تبدیلهای 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
اضافه شد.
شاخص
پشتیبانی اضافه شده برای بازیابی، ایجاد و به روز رسانی کلمات کلیدی منفی در سطح حساب :
- زمینه های:
- فهرست ها:
-
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
-
-
CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST
اضافه شد.CANNOT_TARGET_SIMILAR_USER_LIST
تبلیغات هتل
- تغییر نام
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
اضافه شد که کاهش ROAS هدف را توصیه می کند -
RaiseTargetCpaRecommendation
اضافه شد که افزایش CPA هدف را توصیه می کند -
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
-
یادداشت های انتشار بایگانی شده
برای یادداشتهای انتشار آرشیو شده، نسخههای Sunsetted را ببینید.