v17.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 های موجود در پاسخ را نشان می دهد. - اگر خطایی رخ دهد، روش به جای URL ها
partial_failure_error
را برمی گرداند.
- قسمت
تغییر تاریخ
- نوع منبع تغییر وضعیت جدید:
ASSET_GROUP
.
تبدیل ها
- فیلد بخش جدید برای نسخه SKAdNetwork :
segments.sk_ad_network_version
-
offline_conversion_upload_conversion_action_summary
که عیبیابی آپلود تبدیل را در سطح اقدام تبدیل نشان میدهد. - معیارهای زیر به گزارشهای تشخیصی آفلاین اضافه میشوند تا تعداد تبدیلهای آپلود شده را که هنوز در حال پردازش هستند، نشان دهند:
برنامه ریزی
-
AudienceInsights.GenerateAudienceOverlapInsights()
که یک ویژگی اولیه ورودی و مجموعهای از ویژگیهای مخاطب را میپذیرد و تخمینهای همپوشانی دسترسی بالقوه YouTube را بین ویژگی اصلی و ویژگیهای مخاطب برمیگرداند.
گزارش نویسی
- پشتیبانی از تقسیم بندی
per_store_view
بر اساسsegments.date
فیلم های
- پشتیبانی برای بازیابی اطلاعات مربوط به استراتژیهای پیشنهادی استاندارد زیر برای کمپینهای ویدیویی با استفاده از گزارشها، مانند
ad_group
،campaign
:-
Campaign.fixed_cpm
(CPM ثابت (هزینه در هزار نمایش)) -
Campaign.target_cpv
(CPV هدف (هزینه هر بازدید))
-
-
Campaign.video_campaign_settings
که به شما امکان می دهد با استفاده از فیلدهای گزارش زیر تعیین کنید که تبلیغات ویدیویی در کدام موجودی نمایش داده شود: -
segments.ad_format_type
که به شما امکان میدهد گزارشهای زیر را بر اساس نوع قالب تبلیغ ویدیویی تقسیمبندی کنید:
v17 (05-06-2024)
ویژگی ها و تغییرات زیر در نسخه 17 اضافه شده است.
تبلیغات
-
AdService.getAd
حذف شد. اینAdService
با سایر خدمات موجود در Google Ads API مطابقت می دهد. برای روش توصیه شده برای واکشی تبلیغات و سایر انواع منابع ، به بازیابی اشیا مراجعه کنید. - اعتبارسنجی های بیشتری برای
ImageAdInfo.image_asset
در رابطه با ابعاد و قالب اضافه شده است. اگر تصویر نامعتبر باشد ممکن است خطاهای زیر ایجاد شود:
دارایی های
- فهرست جدید اضافه شد:
ClickType.AD_IMAGE
- گزارشهای جدید زیر را با معیارهای جدید برای کمپینهای حداکثر عملکرد و جستجو اضافه کرد:
مخاطبان
-
OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED
اضافه شد.OPERATION_LEVEL_CONSENT_PROVIDED
مشاغل دسته ای
-
BatchJobError.REQUEST_TOO_LARGE
اضافه شد، که زمانی کهAddBatchJobOperationsRequest
ارسال شده بزرگتر از 10484504 بایت باشد پرتاب می شود. - پشتیبانی برای تنظیم
MutateOperation.asset_group_operation
هنگام استفاده ازBatchJobService
اضافه شد. این به شما امکان می دهد از پردازش دسته ای برای ایجاد و مدیریت کل کمپین های Performance Max استفاده کنید. راهنمای اختصاصی جدید ما را ببینید.
کمپین ها
- در همه زمینهها، فهرستبندیها، خطاهای همه منابع در سراسر Google Ads API، مانند کمپینها، تبلیغات و داراییها، Discovery به Gen Demand تغییر نام داد. برای مثال،
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
اضافه شد
خدمات محلی
- اضافه شد
LocalServicesLeadService.AppendLeadConversation()
برای الحاق یکLocalServicesLeadConversation
جدید بهLocalServicesLead
استفاده می شود که بسته به نحوه ایجاد لید، پیام ها را از طریق کانال های مناسب مانند SMS برای کاربران ارسال می کند.- اندازه
AppendLeadConversationRequest.conversations
به 1000 محدود است. - فقط
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
می شود.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 پشتیبانی میکند.- هنگام استفاده از
GoogleAdsService.Search
یاGoogleAdsService.SearchStream
میتوانید معیارهای گزارشshopping_product
را با استفاده ازsegments.date
فیلتر کنید. تقسیم بندی بر اساس تاریخ مجاز نیست و یک خطای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
-
- هنگام ایجاد
DemandGenVideoResponsiveAdInfo
AdVideoAsset.ad_video_asset_info
را برای پشتیبانی از اولویتهای موجودی برای داراییهای ویدیو اضافه کرد. - (فقط حساب های مجاز) Made
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
.
دارایی های
- پشتیبانی از داراییهای مربوط به 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.
-
یادداشت های انتشار بایگانی شده
برای یادداشتهای انتشار آرشیو شده، نسخههای Sunsetted را ببینید.