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

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

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

دارایی ها

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

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

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

کمپین ها

تبدیل ها

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

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

تقاضای ژنرال

توصیه ها

  • فیلد 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 گزارش می‌شوند.

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

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

دارایی ها

کمپین ها

تقاضای ژنرال

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

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

تبدیل ها

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

  • برای ارائه بازخورد در مورد کیفیت 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

تبلیغات

دارایی ها

تبدیل ها

تغذیه می کند

  • همه موجودیت‌های مرتبط با فید، مانند Feed ، FeedMapping ، FeedService ، AdGroupFeed ، feed_placeholder_view ، و غیره حذف شد. کاربران اکنون باید از assets برای رسیدن به همان هدف استفاده کنند. برای لیست تمام نهادهای حذف شده، از یادداشت های مهاجرت دیدن کنید.

هتل و سفر

  • min_days و max_days از ValueRuleItineraryAdvanceBookingWindow را به یک فیلد optional تبدیل کرد تا امکان تعیین 0 به عنوان مقدار را فراهم کند. این از هدف گیری برای جستجوهای مسافرتی که امروزه انجام می شود پشتیبانی می کند.

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

  • (فقط برای حساب های مجاز) دستورالعمل های برند
    • Campaign.brand_guidelines_enabled را فقط هنگام ایجاد کمپین Performance Max قابل تغییر کرد.
    • این با Performance Max برای اهداف سفر ناسازگار است.
    • برای فعال کردن دستورالعمل‌های برند برای کمپین‌های Performance Max موجود، از CampaignService.EnablePMaxBrandGuidelines جدید اضافه شده استفاده کنید. غیرفعال کردن دستورالعمل‌های برند پشتیبانی نمی‌شود.
    • Campaign.brand_guidelines و BrandGuidelines اضافه شد تا امکان تنظیم رنگ‌ها و خانواده فونت برند را فراهم کند.
    • مقادیر جدید خطا:
    • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
  • AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS برای پشتیبانی از تولید خودکار دارایی‌های ویدیویی پیشرفته برای کمپین‌های Performance Max اضافه شد.

برنامه ریزی

ویدیوها

  • پس از انتشار DataLinkService.CreateDataLink ، روش‌های زیر را اضافه کردیم تا بتوانیم پیوندهای داده‌ای ایجاد شده قبلی را تغییر دهیم:
    • RemoveDataLink برای حذف پیوندهای داده در حساب Google Ads
    • UpdateDataLink برای پذیرش، رد و لغو پیوندهای داده در حساب Google Ads
  • پشتیبانی از VIDEO_OUTSTREAM از فهرست‌های زیر حذف شد:

نسخه 18 (16-10-2024)

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

مدیریت حساب

  • (فقط برای حساب های مجاز) DataLinkService.CreateDataLink اضافه شد، که اجازه می دهد یک حساب Google Ads را به ویدیوهای سازنده میزبانی شده در کانال YouTube سازنده پیوند دهید. پیوند ویدیو به حساب Google Ads امکان می‌دهد تبلیغات مشارکتی را با استفاده از ویدیوهای سازنده اجرا کند.

گروه های تبلیغاتی

تبلیغات

  • AdGroupAd.ad_group_ad_asset_automation_settings اضافه شد، که اجازه می‌دهد تبلیغات را در تولید دارایی خودکار یا خارج از آن انتخاب کنید.
  • مقادیر زیر را به AssetAutomationType اضافه کرد:
    • GENERATE_VERTICAL_YOUTUBE_VIDEOS
    • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • AdNetworkType.GOOGLE_OWNED_CHANNELS اضافه شد، که توسط تبلیغاتی که در کانال‌های متعلق به Google مانند YouTube، Gmail و فید Discover ارائه می‌شوند، استفاده می‌شود.

دارایی ها

کمپین ها

معیار

  • content_criterion_view اضافه شد، که معیارهای عملکرد محتوای هدفمند مانند کلمات کلیدی، مکان‌ها و موضوعات را برای کمپین‌های Display، Demand Gen و ویدیو برمی‌گرداند.

هتل و سفر

خدمات محلی

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

برنامه ریزی

  • (فقط برای حساب‌های مجاز) سرویس جدیدی با روش ContentCreatorInsightsService.GenerateCreatorInsights اضافه کرد که به کاربران امکان می‌دهد اطلاعات آماری درباره سازندگان برتر YouTube را بررسی کنند. این به مشتریان اجازه می‌دهد تا سازندگانی را با توجه به ترکیب هدف‌گیری مخاطب و هدف‌گیری محتوا یا اطلاعات بینش سازنده با فهرستی از شناسه‌های کانال YouTube جستجو کنند.
  • به‌روزرسانی‌های AudienceInsightsService.GenerateSuggestedTargetingInsights :
    • audience ، baseline_audience و data_month به audience_definition منتقل شدند.
    • audience_description برای ایجاد پیشنهادات هدف‌یابی از یک توضیح متنی فرم رایگان با استفاده از هوش مصنوعی مولد اضافه شد.
  • AudienceInsightsService.GenerateTargetingSuggestionMetrics اضافه شد، که معیارهای دسترسی بالقوه را برای ترکیب‌های هدف‌گیری مخاطب خاص برمی‌گرداند.

توصیه ها

گزارش دهی

  • فیلدهای summary_row_setting و return_total_results_count SearchGoogleAdsRequest با قسمت search_settings جایگزین کرد که نوع آن SearchSettings با فیلدهای زیر است:
    • omit_results
    • return_summary_row
    • return_total_results_count
  • معیارهای جدید زیر را درباره کلیک‌های نامعتبر عمومی، مانند کلیک‌هایی که توسط ربات‌ها یا خزنده‌ها ایجاد می‌شوند، که دارای الگوهای نامنظم هستند، اضافه کرد. آنها را می توان با گزارش campaign پرس و جو کرد.
  • مقادیر زیر را به QuotaError اضافه کرد:
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

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

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