یادداشت های انتشار

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 که عیب‌یابی آپلود تبدیل را در سطح اقدام تبدیل نشان می‌دهد.
• معیارهای زیر به گزارش‌های تشخیصی آفلاین اضافه می‌شوند تا تعداد تبدیل‌های آپلود شده را که هنوز در حال پردازش هستند، نشان دهند:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary :
    • pending_count

برنامه ریزی

• AudienceInsights.GenerateAudienceOverlapInsights() که یک ویژگی اولیه ورودی و مجموعه‌ای از ویژگی‌های مخاطب را می‌پذیرد و تخمین‌های همپوشانی دسترسی بالقوه YouTube را بین ویژگی اصلی و ویژگی‌های مخاطب برمی‌گرداند.

گزارش

• پشتیبانی از تقسیم بندی per_store_view بر اساس segments.date

ویدیوها

• پشتیبانی برای بازیابی اطلاعات مربوط به استراتژی‌های پیشنهادی استاندارد زیر برای کمپین‌های ویدیویی با استفاده از گزارش‌ها، مانند ad_group ، campaign :
  • Campaign.fixed_cpm (CPM ثابت (هزینه در هزار نمایش))
  • Campaign.target_cpv (CPV هدف (هزینه هر بازدید))
• Campaign.video_campaign_settings که به شما امکان می دهد با استفاده از فیلدهای گزارش زیر تعیین کنید که تبلیغات ویدیویی در کدام موجودی نمایش داده شود:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type که به شما امکان می‌دهد گزارش‌های زیر را بر اساس نوع قالب تبلیغ ویدیویی تقسیم‌بندی کنید:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05-06-2024)

ویژگی ها و تغییرات زیر در نسخه 17 اضافه شده است.

تبلیغات

• AdService.getAd حذف شد. این AdService با سایر خدمات موجود در Google Ads API مطابقت می دهد. برای روش توصیه شده برای واکشی تبلیغات و سایر انواع منابع، به بازیابی اشیا مراجعه کنید.
• اعتبارسنجی های بیشتری برای ImageAdInfo.image_asset در رابطه با ابعاد و قالب اضافه شده است. اگر تصویر نامعتبر باشد ممکن است خطاهای زیر ایجاد شود:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

دارایی ها

• فهرست جدید اضافه شد: ClickType.AD_IMAGE
• گزارش‌های جدید زیر را با معیارهای جدید برای کمپین‌های حداکثر عملکرد و جستجو اضافه کرد:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

مخاطبان

• 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 اضافه شد.
• معیارهای زیر اکنون با پاسخ بازگردانده می شوند حتی زمانی که صفر باشند. این باعث می شود آنها با سایر معیارها سازگار باشند.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

معیارها

• به فیلدهای زیر به AdGroupCriterion اضافه شد تا نشان دهد آیا معیار گروه آگهی در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• پشتیبانی از metrics.search_impression_share برای gender_view اضافه شد
• پشتیبانی از metrics.phone_calls برای keyword_view اضافه شد

خدمات محلی

• اضافه شد LocalServicesLeadService.AppendLeadConversation() برای الحاق یک LocalServicesLeadConversation جدید به LocalServicesLead استفاده می شود که بسته به نحوه ایجاد لید، پیام ها را از طریق کانال های مناسب مانند SMS برای کاربران ارسال می کند.
  • اندازه AppendLeadConversationRequest.conversations به 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 ارائه شده استفاده می شود. یک جلسه تأیید جدید ایجاد می کند و یک پاسخ خالی را برای تأیید ایجاد شده با موفقیت برمی گرداند.
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION اضافه شد.
  • GetIdentityVerification() می تواند برای بازیابی اطلاعات تأیید استفاده شود که چندین شی از IdentityVerification را برمی گرداند. هر IdentityVerification شامل:
    • verification_program که نوع برنامه تایید هویت است
    • identity_verification_requirement که حاوی جزئیات مربوط به مهلتی است که تبلیغ‌کننده باید تأیید را در آن به پایان برساند.
    • verification_progress که حاوی جزئیات مربوط به جلسه تأیید است از جمله:
      • program_status وضعیت فعلی این جلسه تأیید را نشان می دهد
      • action_url مشتری را به یک URL هدایت می کند تا تأیید را تکمیل کند.
      • invitation_link_expiration_time تاریخ انقضای action_url را نشان می دهد
  • فهرست ها:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • خطاها:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT اضافه شد.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 اضافه کرد تا امکان ایجاد گروه‌های فهرست‌بندی بر اساس ایالت و شهری که فعالیت سفر در آن در دسترس است را فراهم کند:
  • activity_state
  • activity_city
• پشتیبانی برای بخش‌های زیر به travel_activity_performance_view اضافه شد:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

خدمات محلی

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact و BusinessRegistrationCheckArtifact اضافه شد تا به تبلیغ‌کنندگان امکان نظارت بر روند تأیید ثبت کسب و کار را بدهد.
• یک منبع جدید local_services_employee اضافه کرد تا به تبلیغ‌کنندگان اجازه دهد اطلاعات کارمندانی را که اضافه کرده‌اند بازیابی کنند.

برنامه ریزی

• score از AudienceInsightsAttributeMetadata حذف شد.

توصیه ها

• RecommendationService.GenerateRecommendations() اضافه شد که توصیه هایی را بر اساس تنظیمات مشخص شده، مانند انواع توصیه ها و انواع کانال های تبلیغاتی، برمی گرداند. این به ویژه در طول ساخت کمپین مفید است.
• RecommendationMetrics.conversions_value اضافه شد.
• کلیدواژه‌های توصیه‌شده با نوع تطابق کلمه کلیدی تنظیم‌نشده، اکنون recommended_match_type به جای 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 سازگار باشد. ## یادداشت های انتشار بایگانی شده

برای یادداشت‌های انتشار آرشیو شده ، نسخه‌های Sunsetted را ببینید.

،

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 که عیب‌یابی آپلود تبدیل را در سطح اقدام تبدیل نشان می‌دهد.
• معیارهای زیر به گزارش‌های تشخیصی آفلاین اضافه می‌شوند تا تعداد تبدیل‌های آپلود شده را که هنوز در حال پردازش هستند، نشان دهند:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary :
    • pending_count

برنامه ریزی

• AudienceInsights.GenerateAudienceOverlapInsights() که یک ویژگی اولیه ورودی و مجموعه‌ای از ویژگی‌های مخاطب را می‌پذیرد و تخمین‌های همپوشانی دسترسی بالقوه YouTube را بین ویژگی اصلی و ویژگی‌های مخاطب برمی‌گرداند.

گزارش

• پشتیبانی از تقسیم بندی per_store_view بر اساس segments.date

ویدیوها

• پشتیبانی برای بازیابی اطلاعات مربوط به استراتژی‌های پیشنهادی استاندارد زیر برای کمپین‌های ویدیویی با استفاده از گزارش‌ها، مانند ad_group ، campaign :
  • Campaign.fixed_cpm (CPM ثابت (هزینه در هزار نمایش))
  • Campaign.target_cpv (CPV هدف (هزینه هر بازدید))
• Campaign.video_campaign_settings که به شما امکان می دهد با استفاده از فیلدهای گزارش زیر تعیین کنید که تبلیغات ویدیویی در کدام موجودی نمایش داده شود:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type که به شما امکان می‌دهد گزارش‌های زیر را بر اساس نوع قالب تبلیغ ویدیویی تقسیم‌بندی کنید:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05-06-2024)

ویژگی ها و تغییرات زیر در نسخه 17 اضافه شده است.

تبلیغات

• AdService.getAd حذف شد. این AdService با سایر خدمات موجود در Google Ads API مطابقت می دهد. برای روش توصیه شده برای واکشی تبلیغات و سایر انواع منابع، به بازیابی اشیا مراجعه کنید.
• اعتبارسنجی های بیشتری برای ImageAdInfo.image_asset در رابطه با ابعاد و قالب اضافه شده است. اگر تصویر نامعتبر باشد ممکن است خطاهای زیر ایجاد شود:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

دارایی ها

• فهرست جدید اضافه شد: ClickType.AD_IMAGE
• گزارش‌های جدید زیر را با معیارهای جدید برای کمپین‌های حداکثر عملکرد و جستجو اضافه کرد:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

مخاطبان

• 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 اضافه شد.
• معیارهای زیر اکنون با پاسخ بازگردانده می شوند حتی زمانی که صفر باشند. این باعث می شود آنها با سایر معیارها سازگار باشند.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

معیارها

• به فیلدهای زیر به AdGroupCriterion اضافه شد تا نشان دهد آیا معیار گروه آگهی در حال ارائه است یا دلایل عدم ارائه آن:
  • primary_status
  • primary_status_reasons
• پشتیبانی از metrics.search_impression_share برای gender_view اضافه شد
• پشتیبانی از metrics.phone_calls برای keyword_view اضافه شد

خدمات محلی

• اضافه شد LocalServicesLeadService.AppendLeadConversation() برای الحاق یک LocalServicesLeadConversation جدید به LocalServicesLead استفاده می شود که بسته به نحوه ایجاد لید، پیام ها را از طریق کانال های مناسب مانند SMS برای کاربران ارسال می کند.
  • اندازه AppendLeadConversationRequest.conversations به 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 ارائه شده استفاده می شود. یک جلسه تأیید جدید ایجاد می کند و یک پاسخ خالی را برای تأیید ایجاد شده با موفقیت برمی گرداند.
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION اضافه شد.
  • GetIdentityVerification() می تواند برای بازیابی اطلاعات تأیید استفاده شود که چندین شی از IdentityVerification را برمی گرداند. هر IdentityVerification شامل:
    • verification_program که نوع برنامه تایید هویت است
    • identity_verification_requirement که حاوی جزئیات مربوط به مهلتی است که تبلیغ‌کننده باید تأیید را در آن به پایان برساند.
    • verification_progress که حاوی جزئیات مربوط به جلسه تأیید است از جمله:
      • program_status وضعیت فعلی این جلسه تأیید را نشان می دهد
      • action_url مشتری را به یک URL هدایت می کند تا تأیید را تکمیل کند.
      • invitation_link_expiration_time تاریخ انقضای action_url را نشان می دهد
  • فهرست ها:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • خطاها:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT اضافه شد.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 اضافه کرد تا امکان ایجاد گروه‌های فهرست‌بندی بر اساس ایالت و شهری که فعالیت سفر در آن در دسترس است را فراهم کند:
  • activity_state
  • activity_city
• پشتیبانی برای بخش‌های زیر به travel_activity_performance_view اضافه شد:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

خدمات محلی

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact و BusinessRegistrationCheckArtifact اضافه شد تا به تبلیغ‌کنندگان امکان نظارت بر روند تأیید ثبت کسب و کار را بدهد.
• یک منبع جدید local_services_employee اضافه کرد تا به تبلیغ‌کنندگان اجازه دهد اطلاعات کارمندانی را که اضافه کرده‌اند بازیابی کنند.

برنامه ریزی

• score از AudienceInsightsAttributeMetadata حذف شد.

توصیه ها

• RecommendationService.GenerateRecommendations() اضافه شد که توصیه هایی را بر اساس تنظیمات مشخص شده، مانند انواع توصیه ها و انواع کانال های تبلیغاتی، برمی گرداند. این به ویژه در طول ساخت کمپین مفید است.
• RecommendationMetrics.conversions_value اضافه شد.
• کلیدواژه‌های توصیه‌شده با نوع تطابق کلمه کلیدی تنظیم‌نشده، اکنون recommended_match_type به جای 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 سازگار باشد. ## یادداشت های انتشار بایگانی شده

برای یادداشت‌های انتشار آرشیو شده ، نسخه‌های Sunsetted را ببینید.