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

نسخه ۲۳.۱ (۲۰۲۶-۰۲-۲۵)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در نسخه ۲۳.۱ اضافه شده‌اند.

برای راهنمایی به بخش ارتقا به آخرین نسخه مراجعه کنید.

مدیریت حساب

  • دامنه advertising_partner_properties.allowed_domain به منابع ProductLinkInvitation و ProductLink اضافه شد. شریک تبلیغاتی فقط می‌تواند روی این دامنه تبلیغ کند.
  • فیلد contains_eu_political_advertising به منبع Customer اضافه شد. این فیلد وضعیت اعلان سطح حساب را بازیابی می‌کند که آیا حاوی تبلیغات سیاسی هدفمند علیه اتحادیه اروپا است یا خیر، و یک EuPoliticalAdvertisingStatusEnum را برمی‌گرداند.

کمپین‌ها

  • پشتیبانی از دستورالعمل‌های متنی اضافه شده است که می‌تواند با کمپین‌های Performance Max و Search برای کنترل برنامه‌نویسی‌شده‌ی متن‌های تولیدشده توسط هوش مصنوعی استفاده شود.
  • برای ارائه دلایل وضعیت اصلی برای کمپین‌هایی با استراتژی پیشنهاد قیمت FIXED_CPM ، CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED ، CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING ، CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED و CampaignPrimaryStatusReason.BOOKING_CANCELLED اضافه شدند.
  • Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure و Campaign.VideoCampaignSettings.booking_details (فقط خواندنی) اضافه شدند.
  • Campaign.missing_eu_political_advertising_declaration برای پشتیبانی از جستجو و فیلتر کردن کمپین‌هایی که فاقد اعلامیه در مورد محتوای تبلیغات سیاسی هدفمند علیه اتحادیه اروپا هستند، اضافه شد.

تبدیل‌ها

  • برای پشتیبانی از ردیابی کاربرانی که یک تبلیغ را تماشا می‌کنند و بعداً ویدیویی از همان کانال را تماشا می‌کنند، ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS اضافه شد.

عمومی

  • CANNOT_TARGET_ONLY_UNDETERMINED به CriterionErrorEnum اضافه شد. این خطا هنگام تلاش برای هدف قرار دادن فقط دسته نامشخص در ابعاد جمعیتی، بازگردانده می‌شود.

مشوق‌ها

  • دو کد خطای جدید به IncentiveErrorEnum اضافه شد: MAX_INCENTIVES_REDEEMED و ACCOUNT_TOO_OLD . این خطاها می‌توانند برای درخواست‌های انجام شده در تاریخ ۱۱ مارس ۲۰۲۶ یا بعد از آن بازگردانده شوند.

برنامه‌ریزی

گزارش‌ها

  • معیارهای جدیدی اضافه شده است که گزارش می‌دهند چند کاربر تبلیغ شما را حداقل دو، سه، چهار، پنج یا ده بار دیده‌اند: unique_users_two_plus ، unique_users_three_plus ، unique_users_four_plus ، unique_users_five_plus و unique_users_ten_plus .
  • VERTICAL_ADS_DATA_FEED به SearchTermMatchSourceEnum اضافه شد تا از فیدهای داده تبلیغاتی عمودی (مثلاً هدف‌گیری موجودیت تبلیغات مسافرتی) پشتیبانی کند.

YouTubeVideoUpload

  • سرویس YouTubeVideoUpload برای پشتیبانی از آپلود و مدیریت ویدیوها در یوتیوب، و منبع YouTubeVideoUpload برای پشتیبانی از دریافت وضعیت آپلود و فراداده اضافه شد. این ویژگی فقط برای REST و کتابخانه کلاینت پایتون پشتیبانی می‌شود.

نسخه ۲۳ (۲۰۲۶-۰۱-۲۸)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در نسخه ۲۳ اضافه شده‌اند.

تبلیغات

  • AD_SHARING_NOT_ALLOWED به AdGroupAdErrorEnum اضافه شد. این خطا هنگام تلاش برای اشتراک‌گذاری یک تبلیغ بین چندین گروه تبلیغاتی نمایش داده می‌شود، که دیگر مجاز نیست.
  • انواع قالب‌های جدید به AdFormatType اضافه شد: TEXT ، VERTICAL_ADS_BOOKING_LINK ، VERTICAL_ADS_PROMOTION .
  • پشتیبانی از CallAd و CallAdInfo در نسخه ۲۳ حذف شد. برای اطلاعات بیشتر به «درباره تبلیغات تماس» مراجعه کنید.

دارایی‌ها

صورتحساب

کمپین‌ها

تبدیل‌ها

  • قابلیت YOUTUBE_FOLLOW_ON_VIEWS به ConversionActionCategory اضافه شد تا از ردیابی کاربرانی که یک تبلیغ را تماشا می‌کنند و بعداً ویدیویی از همان کانال را تماشا می‌کنند، پشتیبانی شود.

تقاضای ژنرال

مشوق‌ها

  • پشتیبانی از مشوق‌های «خودت انتخاب کن» (CYO) اضافه شده است که به شرکا اجازه می‌دهد تا به صورت برنامه‌نویسی‌شده مشوق‌های گوگل ادز را برای مشتریان خود دریافت و اعمال کنند:

    • IncentiveService اضافه شد:
      • متد FetchIncentive امکان دریافت مشوق‌های موجود برای یک کاربر را بر اساس کشور، زبان و در صورت تمایل ایمیل کاربر فراهم می‌کند. این متد می‌تواند گزینه‌های مشوق شخصی‌سازی‌شده‌ی «انتخاب خودتان» (CYO) را بازگرداند.
      • روش ApplyIncentive امکان اعمال یک مشوق انتخابی توسط کاربر را به یک حساب کاربری خاص در گوگل ادز فراهم می‌کند.
    • منبع فقط خواندنی AppliedIncentive اضافه شد که از طریق GoogleAdsService.Search و GoogleAdsService.SearchStream قابل جستجو است. این منبع جزئیات مربوط به مشوق‌های استفاده‌شده، از جمله وضعیت آنها، پیشرفت انجام، مبالغ پاداش و تاریخ‌های مربوطه را ارائه می‌دهد.
    • کدهای خطای جدیدی در IncentiveErrorEnum اضافه شد تا مشکلات مربوط به واکشی انگیزه یا برنامه را مدیریت کند.
    • INVALID_EMAIL_ADDRESS به AuthenticationErrorEnum اضافه شد.

  • برای تسهیل مدیریت دقیق‌تر و جزئی‌تر خطاها در برنامه‌ها، در نسخه‌های آینده کدهای خطای بیشتری به IncentivesService اضافه خواهیم کرد. توصیه می‌کنیم اطلاعیه‌ها و یادداشت‌های انتشار آتی را برای این کدهای خطای جدید زیر نظر داشته باشید تا مطمئن شوید برنامه‌های شما می‌توانند این حالت‌های جدید خطا را مدیریت کنند.

برنامه‌ریزی

توصیه‌ها

  • فیلد is_new_customer به GenerateRecommendationsRequest اضافه شد. وقتی برای توصیه‌هایی از نوع CAMPAIGN_BUDGET روی true تنظیم شود، با استفاده از مدلی برای مشتریان جدید توصیه‌هایی تولید می‌کند. این فقط برای مشتریانی که هیچ کمپینی ندارند توصیه می‌شود.

گزارش‌ها

  • معیارها و تقسیم‌بندی

    • AdGroupAdAssetView اکنون از معیارهای نمایش، عملکرد و تبدیل برای RESPONSIVE_DISPLAY_AD پشتیبانی می‌کند.
    • بخش ad_sub_network_type برای تفکیک دقیق‌تر عملکرد در یک شبکه تبلیغاتی اضافه شد. در ابتدا، این بخش برای کمپین‌های DemandGen در یوتیوب (درون پخش، درون فید، شورت) در دسترس است. این بخش باید همراه با ad_network_type انتخاب شود.
    • تفکیک نوع شبکه تبلیغاتی برای کمپین‌های Performance Max فعال شد.
    • UserLocationView و GeographicView اکنون از معیارهای تقسیم‌بندی‌شده بر اساس تاریخ تبدیل پشتیبانی می‌کنند:
      • conversions_by_conversion_date ،
      • all_conversions_by_conversion_date ،
      • conversions_value_by_conversion_date ،
      • all_conversions_value_by_conversion_date ،
      • value_per_conversions_by_conversion_date ،
      • value_per_all_conversions_by_conversion_date ،
      • cross_device_conversions_by_conversion_date ،
      • cross_device_conversions_value_by_conversion_date .

  • بخش‌های جدید برای تبلیغات عمودی

  • دیدگاه‌های جدید:

    • PerStoreView برای جستجوی جزئیات مکان فروشگاه اضافه شد.
    • MatchedLocationInterestView برای کمپین‌های AI Max اضافه شد که معیارهای عملکرد را بر اساس مکان‌های جغرافیایی که کاربران به آنها علاقه نشان داده‌اند، تفکیک می‌کند.

  • حداکثر عملکرد:

    • تفکیک نوع شبکه تبلیغاتی برای کمپین‌های Performance Max فعال شد.

  • حذف‌ها:

    • معیارهای برچسب عملکرد دارایی‌های تجمیعی حذف شدند. شمارش برچسب عملکرد دیگر برای جستجو و نمایش بازگردانده نمی‌شود.

خرید

  • ShoppingPerformanceView اکنون از معیارهای زیر که بر اساس تاریخ تبدیل تقسیم‌بندی شده‌اند، پشتیبانی می‌کند: conversions_by_conversion_date ، all_conversions_by_conversion_date ، conversions_value_by_conversion_date ، all_conversions_value_by_conversion_date ، value_per_conversions_by_conversion_date ، value_per_all_conversions_by_conversion_date .
  • ShoppingPerformanceView اکنون از معیارهای رقابتی زیر پشتیبانی می‌کند: search_budget_lost_impression_share ، search_rank_lost_impression_share ، search_budget_lost_absolute_top_impression_share ، search_rank_lost_absolute_top_impression_share .
  • product_image_uri به ShoppingProduct اضافه شد.

تبلیغات عمودی

  • تنظیمات vertical_ads_format_setting به کمپین‌های AdGroup for Search با استفاده از فیدهای مسافرتی اضافه شد و امکان کنترل بر روی فرمت‌های تبلیغاتی که می‌توانند ارائه شوند را فراهم کرد.
  • نوع معیار vertical_ads_item_group_rule_list به AdGroupCriterion اضافه شد. vertical_ads_item_group_rule به SharedCriterion اضافه شد. این معیارها امکان هدف قرار دادن گروه‌های آیتم در کمپین‌های جستجو با فیدهای مسافرتی را فراهم می‌کنند.
  • اکنون می‌توانید یک فید داده تبلیغات عمودی را به یک کمپین جستجو که AI Max را اجرا می‌کند متصل کنید تا تبلیغات مسافرتی لینک‌های رزرو و تبلیغات ملک را در کنار تبلیغات متنی شما نشان دهد. در سطح گروه تبلیغاتی، می‌توانید با استفاده از vertical_ads_format_setting کنترل کنید که کدام قالب‌ها نمایش داده شوند و مجموعه‌ای از قوانین گروه آیتم را برای هدف قرار دادن زیرمجموعه‌ای از موجودیت‌های خود از فید داده تبلیغات عمودی تعریف کنید. علاوه بر این، اکنون می‌توان گزارش‌ها را هم بر اساس AdFormatType و هم بر اساس ابعاد از فید داده تبلیغات عمودی تقسیم‌بندی کرد.

ویدئو

  • فیلد AdVideoAssetInfo.ad_video_asset_feature_control اضافه شد.
  • کد خطای CampaignCriterionError.INVALID_VIDEO_LINEUP_ID اضافه شد.
  • معیارهای سنجش میزان شنیداری بودن تبلیغات صوتی در یوتیوب اضافه شد که گزارش می‌داد آیا یک تبلیغ شنیداری است و میزان شنیداری بودن آن بر اساس تعداد دفعات نمایش قابل اندازه‌گیری است.

نسخه ۲۲.۱ (۲۰۲۶-۰۲-۲۵)

ویژگی جدید زیر در نسخه ۲۲.۱ اضافه شده است.

مدیریت حساب

  • فیلد contains_eu_political_advertising به منبع Customer اضافه شد. این فیلد وضعیت اعلان سطح حساب را بازیابی می‌کند که آیا حاوی تبلیغات سیاسی هدفمند علیه اتحادیه اروپا است یا خیر، و یک EuPoliticalAdvertisingStatusEnum را برمی‌گرداند.

کمپین‌ها

  • Campaign.missing_eu_political_advertising_declaration برای پشتیبانی از جستجو و فیلتر کردن کمپین‌هایی که فاقد اعلامیه در مورد محتوای تبلیغات سیاسی هدفمند علیه اتحادیه اروپا هستند، اضافه شد.

نسخه ۲۲ (۲۰۲۵-۱۰-۱۵)

ویژگی‌ها و به‌روزرسانی‌های جدید زیر در نسخه ۲۲ اضافه شده‌اند.

دارایی‌ها

  • LANDING_PAGE_PREVIEW به عنوان یک نوع فیلد تصویر جدید اضافه شد.
  • سرویس AssetGenerationService (نسخه بتا) معرفی شد:
    • این سرویس امکان تولید متن و تصویر را با استفاده از هوش مصنوعی مولد فراهم می‌کند. این سرویس در ابتدا فقط برای تعداد محدودی از شرکت‌کنندگان در نسخه بتای بسته در دسترس است.
    • GenerateText : متن را بر اساس ورودی‌هایی مانند URL نهایی، فرم‌های آزاد، کلمات کلیدی و محتوای کمپین موجود تولید می‌کند.
    • GenerateImages : تصاویر را بر اساس ورودی‌هایی مانند URL نهایی، فرم‌های آزاد، محتوای کمپین موجود یا با تغییر محتوا تصاویر محصول موجود، تولید می‌کند.
    • خطاهای هنگام تولید دارایی با کدهایی از AssetGenerationErrorEnum بازگردانده می‌شوند.

کمپین‌ها

تقاضای ژنرال

  • استراتژی پیشنهاد قیمت TargetCPC برای کمپین‌های Demand Gen اضافه شد. این استراتژی، پیشنهادها را برای به حداکثر رساندن کلیک‌ها در هزینه به ازای هر کلیک (CPC) هدف تنظیم شده، تنظیم می‌کند.
    • با استفاده از Campaign.target_cpc هدف CPC در سطح کمپین را تنظیم کنید.
    • با استفاده از AdGroup.target_cpc_micros در سطح گروه تبلیغاتی، آن را لغو کنید.
  • یک AssetAutomationType جدید اضافه شد: * GENERATE_DESIGN_VERSIONS_FOR_IMAGES : برای DemandGenMultiAssetAds موجود است. در صورت فعال بودن، این گزینه عناصر طراحی را اضافه می‌کند و فایل‌های متنی را در فایل‌های تصویری جاسازی می‌کند تا فایل‌های تصویری جدید با نسبت‌های ابعاد مختلف ایجاد شود. DemandGenMultiAssetAds جدید به طور پیش‌فرض انتخاب می‌شوند.
  • یک AssetAutomationType جدید اضافه شد: * GENERATE_VIDEOS_FROM_OTHER_ASSETS : برای DemandGenMultiAssetAds موجود است. در صورت فعال بودن، با استفاده از سایر دارایی‌ها مانند تصاویر و متن، ویدیو تولید می‌کند. سپس می‌توان از این ویدیوها برای ایجاد DemandGenVideoResponsiveAds جدید استفاده کرد. DemandGenMultiAssetAds جدید به طور پیش‌فرض انتخاب می‌شوند.
  • نام فیلد BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros را به minimum_budget_amount_micros تغییر داد.

عمومی

  • محدودیت ۱۰،۰۰۰ عملیات برای هر درخواست AddBatchJobOperations اضافه شد.
  • مدیریت فیلد page_size در ListBatchJobResultsRequest به‌روزرسانی شد:
    • اگر page_size تنظیم نشده باشد یا ۰ باشد، اکنون به طور پیش‌فرض روی حداکثر ۱۰۰۰ قرار می‌گیرد (قبلاً INVALID_PAGE_SIZE برگردانده می‌شد).
    • اگر page_size از ۱۰۰۰ بیشتر شود، API اکنون خطای INVALID_PAGE_SIZE را برمی‌گرداند (قبلاً به‌طور بی‌صدا روی ۱۰۰۰ محدود می‌شد).
  • یک کد خطای جدید اضافه شد: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED تا نشان دهد چه زمانی از محدودیت نرخ فعال‌سازی پروفایل پرداخت عبور شده است.

حداکثر عملکرد

  • مقادیر جدید AssetAutomationType برای کمپین‌های Performance Max اضافه شد:
    • GENERATE_IMAGE_ENHANCEMENT : ایجاد خودکار تصاویر بهبود یافته مانند برش خودکار را فعال می‌کند. به طور پیش‌فرض فعال است.
    • GENERATE_IMAGE_EXTRACTION : منبع‌یابی خودکار تصاویر از URLهای نهایی را فعال می‌کند. پیش‌فرض روی تنظیمات افزونه تصویر پویا در سطح حساب کاربری است.
  • AssetPerformanceLabel برای کمپین‌های Performance Max حذف شد.
  • عملکرد Campaign.url_expansion_opt_out حذف شده اکنون با تنظیم AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION در AssetAutomationSetting مدیریت می‌شود.
  • بخش‌های جدیدی برای کمپین‌های Performance Max اضافه شد. هر یک از این بخش‌ها فقط برای کمپین‌های Performance Max در دسترس هستند و در صورت انتخاب هر نوع کمپین دیگری، داده‌ای را برنمی‌گردانند.
    • ad_using_product_data : نشان می‌دهد که آیا یک تبلیغ از داده‌های محصول از فید مرکز بازرگانان گوگل استفاده می‌کند یا خیر.
    • ad_using_video : نشان می‌دهد که آیا یک تبلیغ از یک فایل ویدیویی استفاده می‌کند یا خیر.

برنامه‌ریزی

گزارش‌ها

اهداف یکپارچه

  • پشتیبانی از اهداف حفظ مشتری برای بهینه‌سازی جذب مجدد مشتریان فعلی اضافه شد.
    • پیکربندی هدف‌گیری با استفاده از CampaignRetentionGoalSettings.target_option : * TARGET_SPECIFIC : فقط از کاربران موجود در لیست‌های کاربران مرتبط با کمپین استفاده می‌کند. (در حال حاضر فقط به لیست مجاز است).
      • TARGET_ALL (پیش‌فرض): همه کاربران را برای تعامل مجدد هدف قرار می‌دهد.

ویدئو

نسخه ۲۱.۱ (۲۰۲۶-۰۲-۲۵)

ویژگی جدید زیر در نسخه ۲۱.۱ اضافه شده است.

مدیریت حساب

  • فیلد contains_eu_political_advertising به منبع Customer اضافه شد. این فیلد وضعیت اعلان سطح حساب را بازیابی می‌کند که آیا حاوی تبلیغات سیاسی هدفمند علیه اتحادیه اروپا است یا خیر، و یک EuPoliticalAdvertisingStatusEnum را برمی‌گرداند.

کمپین‌ها

  • Campaign.missing_eu_political_advertising_declaration برای پشتیبانی از جستجو و فیلتر کردن کمپین‌هایی که فاقد اعلامیه در مورد محتوای تبلیغات سیاسی هدفمند علیه اتحادیه اروپا هستند، اضافه شد.

نسخه ۲۱ (۲۰۲۵-۰۸-۰۶)

برای راهنمایی به بخش ارتقا به آخرین نسخه مراجعه کنید.

کمپین‌های جستجو با هوش مصنوعی مکس

  • اکنون می‌توانید از فیلد ai_max_setting.enable_ai_max در Campaign برای فعال کردن کمپین‌های AI Max برای جستجو استفاده کنید. کمپین‌های AI Max برای جستجو، دسترسی یک کمپین جستجو را از طریق تطبیق عبارت جستجو گسترش می‌دهند و امکان کنترل اینکه آیا کنترل‌های هدف‌گذاری و خلاقیت هنگام تنظیم، اعمال می‌شوند یا خیر را فراهم می‌کنند. اتوماسیون دارایی متنی و کنترل‌های فهرست برند که در درخواست‌های نسخه قبلی تنظیم شده بودند، همچنان رعایت می‌شوند تا زمانی که کمپین‌های AI Max برای جستجو به صراحت فعال و غیرفعال شوند. Campaign.ai_max_setting.bundling_required می‌تواند برای تعیین اینکه آیا کمپین‌های AI Max برای جستجو باید برای رعایت یا تغییر اتوماسیون دارایی متنی و کنترل‌های فهرست برند فعال باشند، استفاده شود. AdGroup.ai_max_ad_group_setting.disable_search_term_matching می‌تواند برای غیرفعال کردن تطبیق عبارت جستجو زمانی که یک کمپین والد، کمپین‌های AI Max برای جستجو را فعال کرده است، استفاده شود. به پست وبلاگ ما مراجعه کنید: باز کردن عملکرد سطح بعدی با کمپین‌های AI Max برای جستجو .

  • CampaignError.AI_MAX_MUST_BE_ENABLED اضافه شد، که برای کمپین‌های جستجو زمانی نمایش داده می‌شود که شما بدون فعال کردن AI Max برای کمپین‌های جستجو، گزینه FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION را انتخاب می‌کنید.

  • پشتیبانی از اعمال کنترل‌های هدف‌گیری در سطح گروه‌های تبلیغاتی در کمپین‌های AI Max for Search اضافه شد. اکنون می‌توانید معیارهای زیر را به گروه‌های تبلیغاتی اضافه کنید:

    • فهرست‌های برند
    • مکان‌ها
    • صفحات وب (قوانین URL)

  • نمای ai_max_search_term_ad_combination_view برای گزارش عملکرد ترکیبی از عبارات جستجو، عناوین و صفحات فرود اضافه شد. این نما نشان می‌دهد که کدام عبارات جستجو باعث ایجاد تبلیغات شما شده‌اند و عملکرد آن ترکیبات خاص چگونه بوده است. نسخه آینده شامل یک نمای اضافی خواهد بود که شامل داده‌های Performance Max نیز می‌شود. اگر می‌خواهید از انتقال پیاده‌سازی خود برای دریافت داده‌های Performance Max جلوگیری کنید، منتظر آن نسخه باشید.

  • مقدار AI_MAX به عنوان یک مقدار جدید برای بخش search_term_match_type اضافه شد.

دارایی‌ها

کمپین‌ها

  • یک مقدار شمارشی جدید MISSING_LOCATION_TARGETING به CampaignPrimaryStatusReason اضافه شد. این دلیل وضعیت جدید فقط برای کمپین‌های دارای محدودیت مکانی که هدف‌گیری مکانی را مشخص نمی‌کنند، بازگردانده می‌شود. برای کمپین‌های دارای محدودیت مکانی، هرگونه تلاش برای اضافه کردن هدف‌گیری مکانی خارج از محدوده مجاز منجر به خطای معیار LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN خواهد شد.

  • پشتیبانی از شرکای ادغام شخص ثالث در سطوح VideoCustomer.third_party_integration_partners و Campaign.third_party_integration_partners اضافه شد. به مقاله مرکز راهنما با عنوان «ردیابی تبدیل‌های برنامه با تجزیه و تحلیل برنامه شخص ثالث» مراجعه کنید.

  • اکنون می‌توانید فیلد advertising_partner_ids را برای یک Campaign موجود تنظیم کنید. پیش از این، این فیلد فقط می‌توانست برای یک کمپین جدید در حین ایجاد آن تنظیم شود. این فیلد پس از تنظیم همچنان تغییرناپذیر است.

  • با استفاده از یک لیست مشترک از نوع NEGATIVE_PLACEMENTS که در سطح حساب مدیر تعریف شده است، تبلیغ‌کنندگان اکنون می‌توانند از معیارهای CustomerNegativeCriterion برای حذف لیستی از جایگاه‌ها در حساب‌های مشتری تبلیغ‌کننده استفاده کنند.

  • DESCRIPTION_PREFIX به Enum ServedAssetFieldType اضافه شد. این مشکل را اصلاح می‌کند که در آن served_asset_field_type در ad_group_ad_asset_combination_view برای دارایی‌هایی که به عنوان پیشوند توضیحات استفاده می‌شدند، UNKNOWN بود.

  • پشتیبانی از فیلد target_roas_tolerance_percent_millis در استراتژی‌های پیشنهاد قیمت MaximizeConversionValue و TargetRoas اضافه شد. TargetRoas.target_roas_tolerance_percent_millis فقط برای استراتژی‌های نمونه کارها در دسترس است که فقط برای کمپین‌های جستجو در دسترس است.

  • کد خطای ProductGroup تغییر کرد. برای درخواست‌هایی که INVALID_LISTING_GROUP_HIERARCHY LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION می‌شود.

  • یک منبع جدید LocationInterestView اضافه شد که عملکرد معیارهای علاقه به مکان گروه‌های تبلیغاتی را خلاصه می‌کند.

تبدیل‌ها

  • ENGAGED_VIEW به عنوان یک مقدار جدید برای بخش conversion_attribution_event_type اضافه شد.

  • مشتریان دیگر به حالت debug_enabled در ConversionUploadService دسترسی نخواهند داشت. این فیلد، اگر روی TRUE تنظیم شده باشد، قبلاً برای تشخیص خطای CLICK_NOT_FOUND از SUCCESS برای تبدیل‌های بهبود یافته برای واردات سرنخ‌ها استفاده می‌شد.

تقاضای ژنرال

  • کد خطای CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM اضافه شد. در آینده، این خطا هنگام تلاش برای تنظیم مبلغ بودجه بسیار کم برای یک کمپین Demand Gen بازگردانده خواهد شد. جزئیات مربوط به حداقل بودجه مورد نیاز را می‌توانید در فیلد جزئیات خطای جدید budgetDailyMinimumErrorDetails بیابید.

تغییرات تبلیغات سیاسی اتحادیه اروپا

این تغییرات در تبلیغات سیاسی اتحادیه اروپا در نسخه‌های v19.2 و v20.1 نیز اعمال شده است.

  • Campaign.contains_eu_political_advertising اضافه شد. این فیلد نشان می‌دهد که آیا کمپین شما حاوی محتوای تبلیغات سیاسی است که اتحادیه اروپا را هدف قرار داده است یا خیر. اگر این فیلد روی CONTAINS_EU_POLITICAL_ADVERTISING تنظیم شود، کمپین از ۲۲ سپتامبر ۲۰۲۵ دیگر در اتحادیه اروپا ارائه نخواهد شد. اگر این فیلد تنظیم نشود، فراخوانی‌های API برای ایجاد یک کمپین جدید با خطای FieldError.REQUIRED با شکست مواجه می‌شوند.

    برای هر کمپین موجود، قبل از تلاش برای تغییر هدف‌گذاری مجاورت، موقعیت مکانی یا گروه مکانی، چه در سطح کمپین یا گروه تبلیغاتی، باید فیلد contains_eu_political_advertising را تنظیم کنید. فراخوانی‌های API برای ایجاد یا به‌روزرسانی این معیارهای کمپین یا گروه تبلیغاتی برای کمپین‌های موجود، در صورت عدم تکمیل خوداظهاری توسط کمپین، با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION مواجه خواهند شد.

    برای نسخه‌های v19.x و 20.x، الزام تنظیم این فیلد هنوز اعمال نشده است، اما در آینده اعمال خواهد شد. این تغییر از قبل اعلام خواهد شد.

  • اگر کمپین‌های آزمایشی به طور خودکار اعلام نکرده باشند که آیا حاوی تبلیغات سیاسی هستند که اتحادیه اروپا را هدف قرار می‌دهد یا خیر، ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION در بخش آزمایش‌ها و تجربیات نمایش داده می‌شود.

حداکثر عملکرد

  • برای کمپین‌های جدید PMax، مقدار پیش‌فرض Campaign.brand_guidelines_enabled اکنون true است.

  • گزارش campaign_search_term_view اضافه شد. این نما، معیارهای عبارات جستجو را در سطح کمپین جمع‌آوری می‌کند. این نما همچنین پشتیبانی از کمپین Performance Max را برای عبارات جستجو معرفی می‌کند.

  • PERFORMANCE_MAX به عنوان یک مقدار جدید برای بخش search_term_match_type اضافه شد.

برنامه‌ریزی

  • یک متد جدید ReachPlanService.ListPlannableUserInterests اضافه شده است که به تبلیغ‌کنندگان اجازه می‌دهد علایق کاربران (علاقه‌ها و درون‌بازارها) را که توسط ReachPlanService.GenerateReachForecast پشتیبانی می‌شوند، کشف کنند. این متد از جستجوی انواع خاص علایق کاربر و جستجوی نام‌ها و مسیرها پشتیبانی می‌کند.

  • AdditionalApplicationInfo به ReachPlanService.ListPlannableUserLists به عنوان یک فیلد ورودی اختیاری اضافه شد.

  • پشتیبانی از AudienceInsightsService.ListAudienceInsightsAttributes برای دریافت فهرست‌های کاربری ۱P موجود برای شناسه مشتری که درخواست را انجام می‌دهد، اضافه شد.

  • پشتیبانی از فهرست‌های کاربری تک‌بعدی (1P) به AudienceInsightsService.GenerateAudienceCompositionInsights اضافه شد تا بینش‌هایی برای مخاطبانی که یک فهرست کاربری را هدف قرار می‌دهند، دریافت شود. هر درخواستی که یک فهرست کاربری را هدف قرار دهد، فقط فهرست مخاطبان را برمی‌گرداند و فقط برای AudienceInsightsDimension زیر در دسترس است: AGE_RANGE ، GENDER ، AFFINITY_USER_INTEREST ، IN_MARKET_USER_INTEREST .

  • نوع ورودی مخاطب برای AudienceInsightsService.GenerateTargetingSuggestionMetrics به InsightsAudience به‌روزرسانی شد. ورودی جدید مخاطب امکان ترکیب AND-of-OR از علایق کاربر را فراهم می‌کند و از معیارهای دسترسی بالقوه برای تعاریف سفارشی‌تر مخاطب پشتیبانی می‌کند.

  • سهم مخاطبان به TrendInsightMetrics اضافه شد تا سهم مخاطبان را برای یک روند به دست آورد.

  • دسته‌های مرتبط جدیدی به KnowledgeGraphAttributeMetadata اضافه شد تا کاربران بتوانند ویژگی‌های نمودار دانش را بر اساس دسته فیلتر کنند.

گزارش‌ها

  • اکنون معیارهای جدید متنوعی برای AssetGroupAsset ، ChannelAggregateAssetView و CampaignAggregateAssetView در دسترس هستند. علاوه بر این، برای ChannelAggregateAssetView و CampaignAggregateAssetView ، impressions ) که قبلاً برای کمپین‌های Performance Max صفر بود، اکنون مقدار واقعی خود را گزارش خواهد کرد.

  • منبع AssetSet را با استفاده از ChangeStatus قابل انتخاب کردیم تا کاربران بتوانند در یک پرس‌وجو اطلاعات بیشتری در مورد منبعی از نوع AssetSet یا CampaignAssetSet کسب کنند.

  • منبع CampaignAssetSet با استفاده از ChangeStatus قابل انتخاب شد تا کاربران بتوانند در یک پرس‌وجو اطلاعات بیشتری در مورد منبع نوع AssetSet یا CampaignAssetSet کسب کنند.

  • بخش جدید search_term_targeting_status اضافه شد که می‌توان آن را در نمای عبارت جستجوی کمپین انتخاب کرد.

  • یک final_url_expansion_asset_view جدید اضافه شد.

  • پشتیبانی از معیارهای value_adjustment و all_value_adjustment در گزارش AssetGroup اضافه شد.

  • AssetGroupAsset بر اساس ad_network_type قابل تقسیم‌بندی شد.

  • یک بخش جدید landing_page_source اضافه شده است که می‌تواند با منبع landing_page_view مورد استفاده قرار گیرد.

  • بخش جدیدی search_term_match_source اضافه شده است که می‌توان آن را در نمای عبارت جستجو و عبارت جستجوی کمپین انتخاب کرد.

  • یک بخش جدید match_type اضافه شد که می‌توان آن را از نمای کلمه کلیدی انتخاب کرد.

  • پشتیبانی از معیارها برای خوشه‌های منحصر به فرد با هدف پرس و جو با موارد زیر اضافه شد:

  • یک نوع کلیک جدید VEHICLE_ASSETS در بخش‌بندی click_view اضافه شد تا کلیک‌های مربوط به قالب‌های تبلیغاتی خاص دارایی‌های خودرو را ردیابی و گزارش کند.

ویدئو

نسخه ۲۰.۲ (۲۰۲۶-۰۲-۲۵)

ویژگی جدید زیر در نسخه ۲۰.۲ اضافه شده است.

مدیریت حساب

  • Added the contains_eu_political_advertising field to the Customer resource. This field retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatusEnum .

کمپین‌ها

  • Added Campaign.missing_eu_political_advertising_declaration to support querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v20.1 (2025-08-06)

These EU political advertising changes have also been made in the v19.2 and v21 releases.

EU political advertising changes

  • Added Campaign.contains_eu_political_advertising . This field indicates whether your campaign contains political advertising content targeted towards the European Union. If this field is set to CONTAINS_EU_POLITICAL_ADVERTISING , the campaign will no longer serve in the EU starting September 22, 2025.

    For any existing campaigns, you should set the contains_eu_political_advertising field before attempting to change proximity, location, or location group targeting either at the campaign or ad group levels. The API calls to create or update these campaign or ad group criteria for existing campaigns will fail with a CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION error if the campaign hasn't completed the self-declaration.

    For versions v19.x and 20.x, the requirement to set this field is not yet enforced, but will be in the future. This change will be announced in advance.

  • Trials and Experiments will throw an ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION if the experiment's campaigns haven't self-declared whether they contain political advertising that targets the European Union.

v20 (2025-06-04)

The following new features and updates were added in v20.

See Upgrade to the latest version for guidance.

دارایی‌ها

Added several new metrics and segment columns for the asset_group report.

Metrics columns

Segment columns

کمپین‌ها

تبدیل‌ها

  • You can now update the google_ads_conversion_customer field on an existing customer to opt in to cross-account conversion tracking, or to change its existing conversion tracking parent to a different manager account.

  • Added the ClickConversion.user_ip_address field. Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Please add logic to conditionally exclude sharing IP addresses from users from these regions. Make sure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the About offline conversion imports page for more details.

تقاضای ژنرال

توصیه‌ها

  • Added support for ShoppingSetting during campaign construction when using GenerateRecommendationsRequest .
    • Added the merchant_center_account_id field to GenerateRecommendationsRequest to indicate when recommendations should be generated for retail, rather than the standard Performance Max campaigns.

برنامه‌ریزی

ویدیوها

  • Added AdFormatType.PAUSE ads served on organic YouTube videos on TV screens, which is included in reporting. These ads are displayed directly next to the static video frame on the pause screen. This does not include Demand Gen video ads displayed on the ad panel below or on top of a paused organic video, which are reported under AdFormatType.INFEED .

Archived release notes

See Sunsetted versions for archived release notes.