اعلام نسخه ۲۴ Google Ads API

چهارشنبه، ۲۲ آوریل ۲۰۲۶

امروز، انتشار نسخه ۲۴ Google Ads API را اعلام می‌کنیم. برای استفاده از ویژگی‌های جدید نسخه ۲۴، باید کتابخانه‌های مشتری و کد مشتری را ارتقا دهید. همه کتابخانه‌های کارخواه و نمونه کدهای به‌روزشده منتشر شده‌اند.

فردا (۲۳ آوریل ساعت ۱۰ صبح به‌وقت منطقه زمانی شرقی) در رویداد «نکات برجسته نسخه Google Ads API» در Discord، پخش زنده YouTube برای توسعه‌دهندگان Ads، یا رویداد زنده LinkedIn به ما بپیوندید تا این نسخه را به‌صورت زنده بررسی کنیم. این رویدادها همچنین ضبط و در YouTube پست می‌شوند تا کسانی که نمی‌توانند در رویدادهای زنده شرکت کنند، بتوانند آن‌ها را تماشا کنند. اگر سؤالی دارید یا می‌خواهید درباره این پست بحث کنید، در کانال ads-api# در Discord با ما تماس بگیرید.

ویژگی‌های جدید

پشتیبانی از تبدیل‌ها با داده‌های سبد خرید: تبدیل‌ها با داده‌های سبد خرید افزونه‌ای برای ردگیری تبدیل در وب‌سایت یا برنامه شما است. بااستفاده از تبدیل‌ها با داده‌های سبد خرید، می‌توانید جزئیات محصولات فروخته‌شده را برای هر تراکنش ارائه دهید، که به شما کمک می‌کند تا گزارش‌دهی پیشرفته فروش، سود، و اطلاعات آماری را برای حساب و پویش‌های Google Ads خود باز کنید، مانند تعداد سفارش‌ها، میانگین اندازه سبد خرید، درآمد، و سود ناخالص.

Google Ads API v24 پشتیبانی از این ویژگی را به‌صورت زیر اضافه می‌کند:

  • منبع جدید CartDataSalesView اضافه شد که امکان بخش‌بندی سنجه‌های تبدیل را نه‌تنها براساس محصول کلیک‌شده، بلکه براساس محصول فروخته‌شده، با بخش‌هایی مانند product_sold_brand فراهم می‌کند. این ویژگی‌ها به آگهی‌دهندگان امکان می‌دهد آمار محصولاتی را که مشتریان پس‌از کلیک کردن روی آگهی‌ها واقعاً خریده‌اند مشاهده کنند، حتی اگر آگهی برای محصول دیگری بوده باشد.
  • چند سنجه غیرقابل پیشنهاد قیمت دادنی «همه» اضافه شد که سنجه‌هایی هستند که تبدیل‌هایی را نیز دربرمی‌گیرند که پویش‌هایتان به‌طور فعال برای آن‌ها بهینه‌سازی نمی‌شوند، برای مثال all_cost_of_goods_sold_micros. سنجه‌های جدید به همه منابعی که از سنجه‌های قابل‌مناقصه مربوطه پشتیبانی می‌کنند اضافه می‌شوند.
  • بخش conversion_attribution_event_type به منبع ShoppingPerformanceView اضافه شد و با داده‌های سبد خرید و دیگر سنجه‌های تبدیل قابل‌انتخاب شد. این بخش نشان می‌دهد که آیا تبدیل به کلیک یا بازدید نسبت داده شده است یا نه و برای تشخیص آمار داده‌های سبد خرید تولیدشده توسط تبدیل‌های بازدیدِ گذری ضروری است.

ویژگی‌های به‌روزشده

نسخه v24 به‌روزرسانی‌هایی را برای ویژگی‌های موجود معرفی می‌کند که هنگام ارتقا نیاز به تغییر کد دارند. مهم‌ترین آن‌ها را در اینجا پوشش می‌دهیم؛ برای دیدن فهرست کامل تغییرات، یادداشت‌های انتشار را بررسی کنید.

تنظیمات مستثنا کردن محتوای ویدیویی در پویش‌ها: توانایی تنظیم تنظیمات مستثنا کردن محتوای ویدیویی در پویش‌های تکی را ساده‌تر کردیم. این تنظیم در سطح مشتری دردسترس است و درعوض برای همه پویش‌ها اعمال می‌شود. این تنظیمات مستثنا کردن محتوا برای این است که کنترل بیشتری به شما بدهد و به شما کمک کند انواع محتوایی را که با خط‌مشی‌های ما مطابقت دارند اما ممکن است برای نمانام یا کسب‌وکار شما مناسب نباشند مستثنا کنید. برای کسب اطلاعات بیشتر درباره تنظیمات مستثنی کردن محتوای ویدیویی، به https://support.google.com/google-ads/answer/7515513 مراجعه کنید.

تغییرات در AudienceInsightsService: به‌عنوان بخشی از بازسازی کد، فیلد درخواست InsightsAudience.topic_audience_combinations را به فضای نام common منتقل کردیم. ممکن است لازم باشد دستورالعمل‌های وارد کردن را در برخی‌از زبان‌های برنامه‌نویسی به‌روز کنید.

تغییرات ReachPlanService: به‌عنوان بخشی از بازسازی کد، فیلد youtube_select_lineups را از سرویس ReachPlanService.ListPlannableProducts منتقل کردیم. فهرست بازیکنان اکنون در فیلد youtube_select_lineup_targeting دردسترس است. «مجموعه‌های YouTube Select» محصولات رزروی هستند که مشتریان واجدشرایط می‌توانند ازطریق آن‌ها ۱٪ برتر کانال‌های پرطرفدار YouTube را که پرشورترین مخاطبان را در بازار مشخصی دارند هدف‌یابی کنند. بیشتر بدانید.

تغییرات در ContentCreatorInsightsService: به‌عنوان بخشی از بازسازی کد، فیلد is_brand_connect_creator را از سرویس‌های ContentCreatorInsightsService.GenerateCreatorInsights و ContentCreatorInsightsService.GenerateTrendingInsights برداشتیم.
کاربران باید به‌جای آن به‌دنبال محتواسازی باشند که گزینه CREATOR_PARTNERSHIPS را در partnership_opportunities داشته باشد. «شراکت‌های محتواسازان YouTube» در Google Ads فضایی است که در آن می‌توانید محتواسازان YouTube را برای شراکت در محتوای حمایت‌شده پیدا کنید و به شما کمک می‌کند شراکت‌های محتواساز خود را به‌طور مؤثر مدیریت کنید. بیشتر بدانید.

تغییرات KeywordPlanIdeaService: برای ارائه تجربه‌ای ساده‌تر و قابل‌اعتمادتر، زیرساخت پیش‌بینی خود را یکپارچه کرده‌ایم. ‫Google Ads API نسخه ۲۴ روش GenerateKeywordForecastMetrics به‌روزشده‌ای را معرفی می‌کند که با تمرکز بر سنجه‌هایی که مستقیماً بر عملکرد شما تأثیر می‌گذارند، فرایند برنامه‌ریزی را ساده می‌کند. در روزهای آینده، پست وبلاگی با جزئیات بیشتر درباره این تغییر منتشر خواهیم کرد.

تغییرات در منبع campaign_budget: بخش ad_sub_network_type را برای منبع campaign_budget برداشتیم چون با این نما ناسازگار است.

تغییرات در نماهای دارایی: بخش click_type را از نماهای ad_group_asset، campaign_asset، و customer_asset برداشتیم. این تغییر با تغییر اخیر محصول مطابقت دارد که این بخش را از Google Ads حذف کرد تا از ارائه اطلاعات نادرست داده‌ها جلوگیری شود. می‌توانید از بخش‌بندی click_type از منبع ad_group_ad استفاده کنید تا جزئیات عملکرد آگهی و دارایی‌ای را که با آن ارائه شده است دریافت کنید.

تغییرات در آگهی واکنش‌گرای ویدیویی: VideoResponsiveAdInfo اکنون بی‌صدا می‌شود. به‌عنوان بخشی از این تغییر، videos، business_name، و logo_images را به‌عنوان فیلدهای الزامی در هر دو شیء DemandGenVideoResponsiveAdInfo و VideoResponsiveAdInfo علامت‌گذاری کرده‌ایم.

تغییرات در ShareablePreviewService: ShareablePreviewService.GenerateShareablePreviews به‌روز شد تا دیگر از شکست جزئی استفاده نکند. اگر درخواست‌ها برای هر شناسه‌ای ناموفق باشد، خطا ایجاد می‌شود. بیشتر بدانید.

منابع زیر می‌تواند به شما کمک کند تا شروع کنید:

برای مشکلات پشتیبانی فنی، به https://support.google.com/google-ads/contact/google_ads_api مراجعه کنید

پرتره نویسنده - ، تیم Google Ads API

برچسب‌ها: google-ads-api، release