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

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

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

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

تبلیغات

  • AD_SHARING_NOT_ALLOWED به AdGroupAdErrorEnum اضافه شد. این خطا هنگام تلاش برای اشتراک‌گذاری یک تبلیغ بین چندین گروه تبلیغاتی نمایش داده می‌شود، که دیگر مجاز نیست.
  • انواع قالب‌های جدید به AdFormatType اضافه شد: TEXT ، VERTICAL_ADS_BOOKING_LINK ، VERTICAL_ADS_PROMOTION .
  • پشتیبانی از CallAd و CallAdInfo در نسخه ۲۳ حذف شد. برای اطلاعات بیشتر به https://support.google.com/google-ads/answer/6341403 مراجعه کنید.

دارایی‌ها

صورتحساب

کمپین‌ها

تبدیل‌ها

  • قابلیت 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 و AdGroupAdAssetCombinationView اکنون از معیارهای نمایش، عملکرد و تبدیل برای 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 اضافه شد.
  • معیارهای سنجش میزان شنیداری بودن تبلیغات صوتی در یوتیوب اضافه شد که گزارش می‌داد آیا یک تبلیغ شنیداری است و میزان شنیداری بودن آن بر اساس تعداد دفعات نمایش قابل اندازه‌گیری است.

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

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

دارایی‌ها

  • 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 (پیش‌فرض): همه کاربران را برای تعامل مجدد هدف قرار می‌دهد.

ویدئو

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

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

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

  • اکنون می‌توانید از فیلد 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 اضافه شد تا کلیک‌های مربوط به قالب‌های تبلیغاتی خاص دارایی‌های خودرو را ردیابی و گزارش کند.

ویدئو

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

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

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

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

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

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

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

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

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

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

دارایی‌ها

چندین معیار جدید و ستون‌های بخش‌بندی برای گزارش asset_group اضافه شد.

ستون‌های معیارها

ستون‌های قطعه‌ای

کمپین‌ها

تبدیل‌ها

  • اکنون می‌توانید فیلد google_ads_conversion_customer را برای یک مشتری موجود به‌روزرسانی کنید تا ردیابی تبدیل بین حساب‌ها را انتخاب کند، یا والد ردیابی تبدیل موجود آن را به یک حساب مدیریتی متفاوت تغییر دهید.

  • فیلد ClickConversion.user_ip_address اضافه شد. گوگل ادز از تطبیق آدرس IP برای کاربران نهایی در منطقه اقتصادی اروپا (EEA)، بریتانیا (UK) یا سوئیس (CH) پشتیبانی نمی‌کند. لطفاً منطقی اضافه کنید تا اشتراک‌گذاری آدرس‌های IP از کاربران این مناطق به صورت مشروط حذف شود. مطمئن شوید که اطلاعات واضح و جامعی در مورد داده‌هایی که در سایت‌ها، برنامه‌ها و سایر دارایی‌های خود جمع‌آوری می‌کنید، در اختیار کاربران قرار می‌دهید و در صورت لزوم طبق قانون یا هرگونه سیاست گوگل، رضایت آنها را دریافت می‌کنید. برای جزئیات بیشتر به صفحه «درباره واردات تبدیل آفلاین» مراجعه کنید.

تقاضای ژنرال

توصیه‌ها

  • پشتیبانی از ShoppingSetting در طول ساخت کمپین هنگام استفاده از GenerateRecommendationsRequest اضافه شد.
    • فیلد merchant_center_account_id به GenerateRecommendationsRequest اضافه شد تا مشخص شود چه زمانی توصیه‌ها باید برای خرده‌فروشی ایجاد شوند، نه کمپین‌های استاندارد Performance Max.

برنامه‌ریزی

  • AudienceInsightsDimension.YOUTUBE_LINEUP برای جایگزینی AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP در AudienceInsightsService و ContentCreatorInsightsService اضافه شد. این بُعد جدید به شما امکان می‌دهد بینش‌ها و فراداده‌های مربوط به YouTube Select (YTS) Lineups را بازیابی کنید. اشیاء مرتبط با YOUTUBE_DYNAMIC_LINEUP مانند DynamicLineupAttributeMetadata و AudienceInsightsDynamicLineup جایگزین شدند تا با حذف گسترده‌تر Dynamic Lineups در سراسر Google Ads همسو شوند. این ویژگی فقط برای حساب‌های موجود در یک لیست مجاز در دسترس است.
  • AdditionalApplicationInfo و ApplicationInstance در AudienceInsightsService ، ContentCreatorInsightsService و ReachPlanService اضافه شد. این ویژگی فقط برای حساب‌های موجود در یک لیست مجاز در دسترس است.
  • به‌روزرسانی AudienceInsightsService و ContentCreatorInsightsService برای ارائه بینش‌های دقیق‌تر. اکنون می‌توانید داده‌های تولیدکننده محتوا را بر اساس دستگاه با استفاده از AudienceInsightsDimension.DEVICE و AudienceInsightsAttribute.device جدید در هر دو سرویس، بخش‌بندی کنید. این ویژگی فقط برای حساب‌های موجود در یک لیست مجاز در دسترس است.
  • Added additional aggregated video metrics to GenerateCreatorInsightsResponse for more comprehensive content creator analysis: engagement_rate , average_views_per_video , average_likes_per_video , average_shares_per_video , average_comments_per_video , shorts_views_count , shorts_video_count , and is_brand_connect_creator . This feature is only available to accounts on an allowlist.
  • Added sub_country_locations to GenerateCreatorInsightsRequest for the ContentCreatorInsightsService . This allows specifying sub-country geographic locations to refine searches for creator insights. The sub_country_locations field is only supported when using the search_attributes oneof in the criteria field. If sub_country_locations are provided with other criteria types, the request will be invalid. This enables more granular geographical targeting and analysis for content creator insights. This feature is only available to accounts on an allowlist.
  • Added ReachPlanService.ListPlannableUserLists , which returns first-party user lists owned by a customer, and added UserListInfo to the audience targeting options in GenerateReachForecastRequest . This lets you retrieve plannable user lists for a given customer and then generate reach forecasts for campaigns targeting those specific audiences. These enhancements improve tailored reach planning by incorporating your first-party audience data directly into forecasting. Reach forecasting is available to allowlisted accounts only.

ویدیوها

  • 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.