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

نسخه 22 (15-10-2025)

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

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

دارایی ها

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

کمپین ها

تقاضای ژنرال

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

ژنرال

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

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

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

برنامه ریزی

گزارش ها

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

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

ویدئو

v21 (06-08-2025)

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

AI Max برای کمپین های جستجو

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

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

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

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

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

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

دارایی ها

  • فیلدهای terms_and_conditions_text ، terms_and_conditions_uri ، promotion_barcode_info ، و promotion_qr_code_info را در PromotionAsset اضافه کرد. فیلدهای بارکد و کد QR در یکی از promotion_trigger قرار دارند. به مقاله مرکز راهنمایی درباره دارایی های تبلیغاتی مراجعه کنید.

  • FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION به AssetAutomationTypeEnum اضافه شد. با این تنظیم، می توانید تولید خودکار دارایی های متنی و صفحات مقصد را از URL نهایی در کمپین های جستجو کنترل کنید.

  • یک سرویس جدید AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset اضافه کرد تا دارایی های ایجاد شده به طور خودکار از Campaign حذف شود. این سرویس فقط از حذف دارایی بسط URL نهایی پشتیبانی می کند.

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

کمپین ها

  • یک مقدار enum جدید 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 موجود تنظیم کنید. پیش از این، این فیلد فقط برای یک کمپین جدید در طول ایجاد آن تنظیم می شد. فیلد پس از تنظیم هنوز تغییرناپذیر است.

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

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

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

تبدیل ها

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

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

تقاضای ژنرال

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

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

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

  • Campaign.contains_eu_political_advertising اضافه شد. این فیلد نشان می‌دهد که آیا کمپین شما حاوی محتوای تبلیغاتی سیاسی با هدف اتحادیه اروپا است یا خیر. اگر این فیلد روی CONTAINS_EU_POLITICAL_ADVERTISING تنظیم شود، از 22 سپتامبر 2025، کمپین دیگر در اتحادیه اروپا اجرا نمی‌شود. اگر این فیلد تنظیم نشود، فراخوان‌های 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 ایجاد می‌کنند. 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 اضافه شد تا لیست‌های کاربر 1P موجود برای شناسه مشتری که درخواست را ارائه می‌کند.

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

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

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

ویدئو

نسخه 20.1 (06-08-2025)

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

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

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

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

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

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

نسخه 20 (04-06-2025)

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

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

دارایی ها

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

ستون های متریک

ستون ها را قطعه بندی کنید

کمپین ها

تبدیل ها

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

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

تقاضای ژنرال

توصیه ها

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

برنامه ریزی

  • AudienceInsightsDimension.YOUTUBE_LINEUP برای جایگزینی AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP در AudienceInsightsService و ContentCreatorInsightsService اضافه شد. این بعد جدید به شما امکان می‌دهد اطلاعات آماری و فراداده‌های مجموعه‌های YouTube Select (YTS) را بازیابی کنید. اشیاء مرتبط با YOUTUBE_DYNAMIC_LINEUP مانند DynamicLineupAttributeMetadata و AudienceInsightsDynamicLineup جایگزین شدند تا با حذف گسترده تر Dynamic Lineups در سراسر Google Ads هماهنگ شوند. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • AdditionalApplicationInfo و ApplicationInstance در AudienceInsightsService ، ContentCreatorInsightsService و ReachPlanService اضافه شد. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • AudienceInsightsService و ContentCreatorInsightsService برای ارائه اطلاعات دقیق تر به روز کرد. اکنون می‌توانید با استفاده از AudienceInsightsDimension.DEVICE و AudienceInsightsAttribute.device جدید در هر دو سرویس، داده‌های سازنده محتوا را بر اساس دستگاه تقسیم‌بندی کنید. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • برای تجزیه و تحلیل جامع‌تر سازنده محتوا، معیارهای ویدیوی انباشته اضافی به GenerateCreatorInsightsResponse اضافه شد: engagement_rate ، average_views_per_video ، average_likes_per_video ، average_shares_per_video ، average_comments_per_video ، تعداد shorts_views_count ، shorts_video_count is_brand_connect_creator . این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • sub_country_locations به GenerateCreatorInsightsRequest برای ContentCreatorInsightsService اضافه شد. این اجازه می دهد تا مکان های جغرافیایی زیرکشور را مشخص کنید تا جستجوها برای اطلاعات بینش سازندگان را اصلاح کنید. فیلد sub_country_locations تنها زمانی پشتیبانی می‌شود که از یک search_attributes در فیلد criteria استفاده کنید. اگر sub_country_locations با انواع معیارهای دیگر ارائه شود، درخواست نامعتبر خواهد بود. این امکان هدف گذاری و تجزیه و تحلیل جغرافیایی دقیق تری را برای بینش سازنده محتوا فراهم می کند. این ویژگی فقط برای حساب‌های موجود در فهرست مجاز در دسترس است.
  • ReachPlanService.ListPlannableUserLists اضافه شد که لیست های کاربران شخص اول متعلق به یک مشتری را برمی گرداند و UserListInfo به گزینه های هدف گیری مخاطب در GenerateReachForecastRequest اضافه کرد. این به شما امکان می‌دهد لیست‌های کاربری قابل برنامه‌ریزی را برای یک مشتری خاص بازیابی کنید و سپس برای کمپین‌هایی که آن مخاطبان خاص را هدف قرار می‌دهند، پیش‌بینی‌های دسترسی ایجاد کنید. این پیشرفت‌ها با ترکیب داده‌های مخاطبان شخص اول شما مستقیماً در پیش‌بینی، برنامه‌ریزی دسترسی متناسب را بهبود می‌بخشند. پیش‌بینی دسترسی فقط برای حساب‌های مجاز در دسترس است.

ویدیوها

  • آگهی‌های AdFormatType.PAUSE اضافه شد که روی ویدیوهای YouTube ارگانیک روی صفحه‌های تلویزیون ارائه می‌شوند، که در گزارش گنجانده شده است. این تبلیغات مستقیماً در کنار قاب ویدیوی ثابت در صفحه مکث نمایش داده می شوند. این شامل آگهی‌های ویدیویی «Demand Gen» نمی‌شود که در پانل آگهی زیر یا بالای یک ویدیوی ارگانیک موقتاً متوقف شده نمایش داده می‌شوند و تحت AdFormatType.INFEED گزارش می‌شوند.

v19.2 (06-08-2025)

این تغییرات تبلیغات سیاسی اتحادیه اروپا نیز در نسخه های v20.1 و v21 انجام شده است.

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

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

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

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

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

نسخه 19.1 (16-04-2025)

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

دارایی ها

کمپین ها

تقاضای ژنرال

تاریخچه را تغییر دهید

  • پشتیبانی از سه نوع منبع دیگر به ChangeStatusResourceType اضافه شده است:
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • می توانید این سه نوع با دانه بندی ریز را از گزارش change_status بازیابی کنید.

تبدیل ها

  • اکنون می‌توانید فیلد google_ads_conversion_customer را هنگام ایجاد یک مشتری جدید با استفاده از Google Ads API تنظیم کنید. این قبلاً یک فیلد فقط خواندنی بود.

    توجه: این ویژگی پشت یک لیست مجاز بسته است. برای استفاده از آن، با مدیر حساب خود تماس بگیرید.

  • اکنون می‌توانید هنگام آپلود تبدیل‌های آفلاین ، نوع مشتری مرتبط با تبدیل را مشخص کنید.

  • یک فیلد session_attributes جدید برای ClickConversion معرفی شد.

تبلیغات خدمات محلی

  • برای ارائه بازخورد در مورد کیفیت LocalServicesLead ، یک RPC ProvideLeadFeedback جدید به LocalServicesLeadService اضافه کرد.
  • یک فیلد جدید lead_feedback_submitted به منبع LocalServicesLead اضافه شد که تأیید می کند آیا بازخورد برای یک منبع خاص ارائه شده است.

خدمات برنامه ریزی

  • پشتیبانی از پیش‌بینی‌های ماهانه فرکانس هدف در ReachPlanService.GenerateReachForecast اضافه شد.
    • هنگام استفاده از کد محصول قابل برنامه ریزی TARGET_FREQUENCY برای ایجاد پیش بینی دسترسی ماهانه فرکانس هدف، برنامه نویسان می توانند TargetFrequencyTimeUnit.MONTHLY در TargetFrequencySettings تنظیم کنند.
  • روش جدیدی اضافه شد ReachPlanService.GenerateConversionRates ، که به تبلیغ‌کنندگان اجازه می‌دهد نرخ‌های تبدیل پیشنهادی را برای محصولات قابل برنامه‌ریزی پشتیبانی شده درخواست کنند.
  • پیش‌بینی نسل تقاضا در ReachPlanService.GenerateReachForecast :
    • توسعه‌دهندگان اکنون می‌توانند پیش‌بینی رسیدن به کمپین‌های تقاضای نسل را درخواست کنند. توسعه دهندگان می توانند از کد محصول قابل برنامه ریزی DEMAND_GEN_MAX_CONVERSIONS جدید برای ایجاد پیش بینی های دسترسی نسل تقاضا استفاده کنند.
    • یک فیلد conversion_rate جدید اضافه شد که به توسعه دهندگانی که درخواست پیش‌بینی‌های رسیدن به تقاضای نسل تقاضا می‌کنند اجازه می‌دهد نرخ تبدیل را ارائه دهند. نرخ تبدیل پیشنهادی را می توان با استفاده از روش جدید ReachPlanService.GenerateConversionRates بازیابی کرد. این فیلد برای درخواست‌های پیش‌بینی تقاضای نسل لازم است. برای سایر محصولات قابل برنامه ریزی پشتیبانی نمی شود.
    • یک قسمت conversions جدید به پیش بینی های برگشتی اضافه شد. این فیلد شامل تعداد تبدیل ها در یک نقطه معین از منحنی دسترسی است. تبدیل فقط برای محصول قابل برنامه ریزی DEMAND_GEN_MAX_CONVERSIONS پشتیبانی می شود.

توصیه ها

ویدیوها

  • پشتیبانی فقط خواندنی برای تبلیغات صوتی اضافه شد. برای آشنایی با این ویژگی به مرکز راهنمای Google Ads مراجعه کنید. این تغییر نشان می دهد:
  • سنجه‌ها و بخش‌های جدیدی به معیارهای دستیابی به پرس و جو با تنظیم نمایشی اضافه شد. به عنوان بخشی از این تغییرات،
    • دو ستون معیار جدید به نام‌های coviewed_impressions و primary_impressions معرفی شدند.
    • دو بخش جدید به نام های adjusted_age_range و adjusted_gender معرفی شدند.
    • اگر هر یک از دو بخش جدید در کنار یک فیلد متریک دسترسی انتخاب شوند ( coviewed_impressions ، primary_impressions ، unique_users ، یا average_impression_frequency_per_user )، بخش دیگر نیز باید برای بازیابی آمار معتبر برای این ستون‌ها انتخاب شود.
    • این ویژگی در حال حاضر فقط برای مشتریان لیست مجاز در دسترس است.

v19 (26-02-2025)

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

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

مدیریت حساب

  • مقادیر زیر را به CustomerError اضافه کرد تا تغییرات آتی را در نظر بگیرد:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

تبلیغات

دارایی ها

تبدیل ها

تغذیه می کند

  • Removed all feed-related entities, such as Feed , FeedMapping , FeedService , AdGroupFeed , feed_placeholder_view , etc. Users should now use assets to achieve the same purpose.

هتل و سفر

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

برنامه ریزی

ویدیوها

Archived release notes

See Sunsetted versions for archived release notes.

،

v22 (2025-10-15)

The following new features and updates were added in v22.

See Upgrade to the latest version for guidance.

دارایی ها

  • Added LANDING_PAGE_PREVIEW as a new image asset field type.
  • Introduced the AssetGenerationService (Beta):
    • This service allows generating text and image assets using generative AI. This service is initially available only to a limited set of closed beta participants.
    • GenerateText : Generates text based on inputs like final URL, freeform prompts, keywords, and existing campaign context.
    • GenerateImages : Generates images based on inputs like final URL, freeform prompts, existing campaign context, or by recontextualizing existing product images.
    • Errors during asset generation are returned with codes from AssetGenerationErrorEnum .

کمپین ها

تقاضای ژنرال

ژنرال

  • Added a limit of 10,000 operations per AddBatchJobOperations request.
  • Updated handling for the page_size field in ListBatchJobResultsRequest :
    • If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE ).
    • If page_size exceeds 1,000, the API now returns an INVALID_PAGE_SIZE error (previously silently capped at 1,000).
  • Added a new error code: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when the payment profile activation rates limit has been exceeded.

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

برنامه ریزی

گزارش ها

Unified Goals

ویدئو

v21 (2025-08-06)

See Upgrade to the latest version for guidance.

AI Max برای کمپین های جستجو

  • You can now use the ai_max_setting.enable_ai_max field of the Campaign to enable AI Max for Search campaigns. AI Max for Search campaigns expands a Search campaign's reach through search term matching and allows controlling whether targeting and creative controls serve when set. Text asset automation and brand list controls that were set in previous version requests will still be respected until AI Max for Search campaigns is explicitly toggled and turned off. Campaign.ai_max_setting.bundling_required can be used to determine if AI Max for Search campaigns must be enabled to respect or modify text asset automation and brand list controls. AdGroup.ai_max_ad_group_setting.disable_search_term_matching can be used to disable search term matching when a parent campaign has enabled AI Max for Search campaigns. See our blog post Unlock next-level performance with AI Max for Search campaigns .

  • Added CampaignError.AI_MAX_MUST_BE_ENABLED , which is thrown for Search campaigns when you opt in to FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION without enabling AI Max for Search campaigns on the campaign.

  • Added support for applying targeting controls at the ad group level in AI Max for Search campaigns. You can now add the following criteria to ad groups:

    • Brand lists
    • مکان ها
    • Webpages (URL rules)

  • Added the ai_max_search_term_ad_combination_view to report on performance for combinations of search terms, headlines, and landing pages. This view shows which search queries triggered your ads and how those specific combinations performed. A future release will include an additional view that also includes Performance Max data. If you want to avoid migrating your implementation to get Performance Max data, consider waiting for that release.

  • Added AI_MAX as a new value for the search_term_match_type segment.

دارایی ها

کمپین ها

تبدیل ها

تقاضای ژنرال

EU political advertising changes

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

  • 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. API calls to create a new campaign will fail with a FieldError.REQUIRED error if this field is not set.

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

v19.2 (2025-08-06)

These EU political advertising changes have also been made in the v20.1 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. Wait for the announcement of this change.

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

v19.1 (2025-04-16)

The following features and changes were added in v19.1.

دارایی ها

کمپین ها

تقاضای ژنرال

تاریخچه را تغییر دهید

  • Added support for three more resource types into ChangeStatusResourceType :
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • You can retrieve these three finer-grained types from the change_status report.

تبدیل ها

تبلیغات خدمات محلی

خدمات برنامه ریزی

  • Added support for Target frequency monthly forecasts in ReachPlanService.GenerateReachForecast .
  • Added a new method ReachPlanService.GenerateConversionRates , which allows advertisers to request suggested conversion rates for supported plannable products.
  • Demand Gen forecasting in ReachPlanService.GenerateReachForecast :
    • Developers can now request reach forecasts for Demand Gen campaigns. Developers can use the new DEMAND_GEN_MAX_CONVERSIONS plannable product code to generate Demand Gen reach forecasts.
    • Added a new conversion_rate field that allows developers requesting Demand Gen reach forecasts to provide a conversion rate. Suggested conversion rates can be retrieved using the new ReachPlanService.GenerateConversionRates method. This field is required for Demand Gen forecasting requests. It is not supported for other plannable products.
    • Added a new conversions field to returned forecasts. This field contains the number of conversions at a given point on the reach curve. Conversions are only supported for the DEMAND_GEN_MAX_CONVERSIONS plannable product.

توصیه ها

ویدیوها

  • Added read-only support for Audio Ads. See Google Ads Help Center to learn about this feature. This change exposes:
  • Added new metrics and segments to query reach metrics with demo adjustment. As part of these changes,
    • Two new metrics columns named coviewed_impressions and primary_impressions were introduced.
    • Two new segments named adjusted_age_range and adjusted_gender were introduced.
    • If either of the two new segments are selected alongside a reach metric field ( coviewed_impressions , primary_impressions , unique_users , or average_impression_frequency_per_user ), the other segment must be selected as well to retrieve valid stats for these columns.
    • This feature is currently available only for allowlisted customers.

v19 (2025-02-26)

The following features and changes were added in v19.

See Upgrade to the latest version for guidance.

مدیریت حساب

  • Added the following values to CustomerError to account for upcoming changes:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

تبلیغات

دارایی ها

تبدیل ها

تغذیه می کند

  • Removed all feed-related entities, such as Feed , FeedMapping , FeedService , AdGroupFeed , feed_placeholder_view , etc. Users should now use assets to achieve the same purpose.

هتل و سفر

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

برنامه ریزی

ویدیوها

Archived release notes

See Sunsetted versions for archived release notes.