گزارش تغییر

برای دریافت اعلامیه‌های رسمی Google Analytics API، در Google Analytics API Notify Group مشترک شوید.

۲۰۲۶-۰۹-۱۴ پشتیبانی از پُرسمان مکالمه‌ای در نسخه ۱ آلفا اضافه شد

روش properties.chat برای تعامل با داده‌های Google Analytics بااستفاده از پُرسمان‌های زبان طبیعی اضافه شد.

  • بدنه درخواست یک پُرسمان، یک شناسه جلسه اختیاری برای ادامه مکالمه قبلی، و یک پارامتر returnPropertyQuota اختیاری را می‌پذیرد.
  • پاسخ داده‌های پاسخ گپ ساختاریافته را در ResponseBlock شیء، شناسه جلسه، و جزئیات سهمیه ژتون دارایی بااستفاده از PropertyChatQuota درصورت درخواست برمی‌گرداند.
  • گستره OAuth https://www.googleapis.com/auth/analytics.chatbot.read دسترسی خواندن به روش properties.chat را فراهم می‌کند.

‫۲۰۲۶/۰۹/۱۴ دلایل کوتاه کردن داده‌ها به پاسخ‌های گزارش اضافه شد

فیلد dataTruncationReasons به ResponseMetaData در نسخه ۱ بتا و نسخه ۱ آلفا اضافه شد. وقتی داده‌های گزارش کوتاه شده باشد، این فیلد شامل فهرستی از اشیاء DataTruncationReason خواهد بود که شامل نوع کوتاه شدن، پیام توصیفی، و تاریخ‌های تحت‌تأثیر قرارگرفته است.

‫۲۰۲۶-۰۴-۲۳ پشتیبانی از گزارش‌دهی تبدیل در نسخه ۱ آلفا اضافه شد

پشتیبانی از بازیابی داده‌ها از گزارش عملکرد تبدیل بااستفاده از روش runReport در Data API v1 alpha اضافه شد. این کار به شما امکان می‌دهد به همان داده‌های تبدیل که در واسط کاربری Google Analytics در بخش تبلیغات > عملکرد تبدیل دردسترس است دسترسی پیدا کنید.

  • فیلد ConversionSpec به RunReportRequest اضافه شد که امکان فیلتر کردن تبدیل‌ها بااستفاده از conversionActions (شناسه‌های کنش تبدیل) و انتخاب AttributionModel (DATA_DRIVEN یا LAST_CLICK) را فراهم می‌کند.
  • فیلد Section به ResponseMetaData اضافه شد تا مشخص شود آیا داده‌های گزارش از گزارش‌دهی استاندارد (SECTION_REPORT) یا گزارش‌دهی تبدیل (SECTION_ADVERTISING) است.

روش getMetadata در Data API v1 alpha به‌روزرسانی شد تا اطلاعاتی برای گزارش‌دهی تبدیل ارائه شود:

  • فیلد conversions به پاسخ اضافه شد، که فهرستی از ConversionMetadata شیء را برمی‌گرداند که شناسه‌های کنش تبدیل را به نام‌های نمایشی نگاشت می‌کند.
  • فیلد sections به DimensionMetadata و MetricMetadata اضافه شد تا مشخص شود که آیا فیلد خاصی با گزارش‌دهی استاندارد، گزارش‌دهی تبدیل، یا هر دو سازگار است یا نه.

‫۲۰۲۴/۱۰/۲۰ نوع فیلتر بُعد EmptyFilter اضافه شد

بااستفاده از فیلتر بُعد EmptyFilter می‌توانید شرایط فیلتر کردن را برای مقایسه با مقدار خالی ایجاد کنید.

‫۲۰۲۴/۱۰/۱۵ ویژگی «سطح نمونه‌گیری» به روش reportTasks اضافه شد

بااستفاده از فیلد samplingLevel در روش properties.runReportTask می‌توانید سطح نمونه‌گیری گزارش را کنترل کنید.

این ویژگی به دارایی‌های Google Analytics 360 امکان می‌دهد به حد نمونه‌گیری بالاتر ۱ میلیارد رویداد دسترسی داشته باشند. همچنین، برای نتایج نمونه‌برداری‌نشده با تعداد رویداد زیاد، می‌توان حدود نمونه‌برداری را روی UNSAMPLED تنظیم کرد.

‫۲۰۲۴/۰۹/۱۸ ویژگی «عکس آنی سهمیه‌های دارایی» اضافه شد

بااستفاده از روش properties.getPropertyQuotasSnapshot، می‌توانید عکس آنی فعلی از همه سهمیه‌های دارایی را که براساس دسته سهمیه برای دارایی مشخصی سازمان‌دهی شده است دریافت کنید.

‫۲۰۲۴/۰۶/۲۸ سهمیه «خطاهای کارخواه به‌ازای هر پروژه به‌ازای هر دارایی» اضافه شد

اکنون برای هر پروژه و هر دارایی، در بازه زمانی ۱۵ دقیقه‌ای، حداکثر ۱۰٬۰۰۰ خطای سرور API مجاز است. این شامل همه درخواست‌هایی می‌شود که منجر به پاسخی با هر کدی غیراز 500 یا 200 می‌شود. نمونه‌هایی از خطاهایی که تحت این سهمیه قرار می‌گیرند: استفاده از ترکیب‌های ابعاد و سنجه‌های ناسازگار، همه خطاهای اصالت‌سنجی.

اگر از این حد فراتر بروید، فراخوانی‌های بیشتر میانای برنامه‌سازی کاربردی به آن دارایی به‌طور موقت برای پروژه Google Cloud مرتبط مسدود خواهد شد تا زمانی که پنجره ۱۵ دقیقه‌ای به‌پایان برسد.

‫۲۰۲۴/۰۵/۱۴ ویژگی «مقایسه‌ها» اضافه شد

بااستفاده از مقایسه‌ها، می‌توانید زیرمجموعه‌های داده‌هایتان را کنار هم ارزیابی کنید.

روش‌های گزارش‌دهی اصلی Data API v1beta برای پشتیبانی از فیلد comparisons به‌روزرسانی شده‌اند که درصورت گنجانده شدن، پیکربندی مقایسه‌های درخواست‌شده را مشخص می‌کند.

در درخواست، می‌توانید با ارائه عبارت dimensionFilter با درخواست، مقایسه پایه را مشخص کنید یا با ارائه نام منبع مقایسه در فیلد comparison، از مقایسه ذخیره‌شده استفاده کنید.

روش getMetadata به‌روزرسانی شده است تا همه مقایسه‌های ذخیره‌شده دردسترس برای دارایی را تحت فیلد پاسخ comparisons فهرست کند.

وقتی حداقل یک مقایسه در درخواست مشخص شده باشد، پاسخ حاوی ستون comparison خواهد بود که هر مقایسه را شناسایی می‌کند.

درحال‌حاضر، مقایسه‌های ذخیره‌شده را فقط می‌توان بااستفاده از میانای کاربری Google Analytics ایجاد کرد.

‫۲۰۲۴/۰۵/۰۸ تکالیف گزارش، ویژگی گزارش‌دهی ناهمگام، به Data API v1alpha اضافه شد.

بااستفاده از تکالیف گزارش، می‌توانید درخواست ناهمگام طولانی‌مدتی را برای تشکیل گزارش سفارشی‌شده از داده‌های رویداد Google Analytics خود آغاز کنید.

روش‌های دستکاری تکلیف گزارش زیر به Data API v1alpha اضافه شده است:

‫۲۰۲۴/۰۵/۰۶ ابعاد جدید برای رویدادهای کلیدی

اکنون ابعاد و سنجه‌های رویدادهای کلیدی دردسترس است.

درخواست‌های گزارش خود را که از بُعد isConversionEvent استفاده می‌کنند تغییر دهید تا به‌جای آن از بُعد isKeyEvent استفاده کنند.

هر درخواست گزارشی را که از سنجه منسوخ‌شده در جدول زیر استفاده می‌کند اصلاح کنید تا به‌جای آن از سنجه رویداد کلیدی استفاده کند.

سنجه منسوخ‌شده سنجه رویداد کلیدی
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

تغییرات مشابهی را در هرگونه استفاده از سنجه‌های رویداد کلیدی برای یک رویداد کلیدی در درخواست‌های گزارش خود اعمال کنید.

پاسخ روش properties/getMetadata نشان‌دهنده معرفی بُعدها و سنجه‌های رویداد کلیدی در اشیاء DimensionMetadata و MetricMetadata به‌صورت زیر است:

  • ‫apiName، uiName، و description حاوی نام میانای برنامه‌سازی کاربردی رویداد کلیدی، نام واسط کاربر، و شرح هستند.
  • فیلد تکراری deprecatedApiNames ورودی‌ای با نام API تبدیل منسوخ‌شده دارد.

‫۲۰۲۴/۰۳/۲۵ گروه کانال اصلی، منبع ترافیک دستی، و ابعاد خاص ادغام اضافه شد.

گروه کانال اصلی، منبع ترافیک دستی، و ادغام CM360،‏ DV360،‏ SA360 ابعاد خاصی به طرح‌واره Data API اضافه شد.

ابعاد مخاطب:

  • ‫audienceId شناسه مخاطب. شناسه عددی «مخاطب».

بُعدهای «گروه کانال اصلی»:

  • firstUserPrimaryChannelGroup گروه کانال اصلی کاربر اول

  • primaryChannelGroup گروه کانال اصلی

  • گروه کانال اصلی جلسه sessionPrimaryChannelGroup

بعدهای «منبع ترافیک دستی»:

  • manualCampaignId شناسه پویش دستی

  • manualCampaignName نام پویش دستی

  • manualCreativeFormat قالب طرح آگهی دستی

  • manualMarketingTactic آرایش بازاریابی غیرخودکار

  • manualMedium دستی متوسط

  • ‫manualSource منبع دستی

  • منبع / رسانه دستی manualSourceMedium

  • manualSourcePlatform پلاتفرم منبع دستی

  • firstUserManualCampaignId شناسه پویش دستی کاربر اول

  • firstUserManualCampaignName نام پویش دستی کاربر اول

  • firstUserManualCreativeFormat اولین قالب خلاقانه راهنمای کاربر

  • firstUserManualMarketingTactic آرایش بازاریابی دستی کاربر اول

  • firstUserManualMedium رسانه دستی کاربر اول

  • firstUserManualSource منبع دستی کاربر اول

  • firstUserManualSourceMedium منبع / رسانه دستی کاربر اول

  • firstUserManualSourcePlatform پلاتفرم منبع دستی کاربر اول

  • sessionManualCampaignId شناسه پویش دستی جلسه

  • sessionManualCampaignName نام پویش دستی جلسه

  • sessionManualCreativeFormat قالب طرح‌آگهی دستی جلسه

  • sessionManualMarketingTactic Session manual marketing tactic

  • sessionManualMedium Session manual medium

  • منبع دستی جلسه sessionManualSource

  • sessionManualSourceMedium منبع / رسانه دستی جلسه

  • sessionManualSourcePlatform پلاتفرم منبع دستی جلسه

ابعاد ادغام Campaign Manager 360 (CM360):

  • شناسه حساب CM360 cm360AccountId

  • cm360AccountName نام حساب CM360

  • cm360AdvertiserId شناسه آگهی‌دهنده CM360

  • cm360AdvertiserName نام آگهی‌دهنده CM360

  • شناسه پویش CM360 cm360CampaignId

  • cm360CampaignName نام پویش CM360

  • قالب طرح آگهی CM360 cm360CreativeFormat

  • ‫cm360CreativeId شناسه طرح‌آگهی CM360

  • cm360CreativeName نام طرح‌آگهی CM360

  • نوع طرح‌آگهی CM360‏ cm360CreativeType

  • cm360CreativeTypeId شناسه نوع طرح‌آگهی CM360

  • ‫cm360CreativeVersion نسخه طرح آگهی CM360

  • cm360Medium رسانه CM360

  • cm360PlacementCostStructure ساختار هزینه جای‌گذاری CM360

  • ‫cm360PlacementId شناسه جای آگهی CM360

  • cm360PlacementName نام جای آگهی CM360

  • شناسه پرداز CM360 cm360RenderingId

  • cm360SiteId شناسه سایت CM360

  • نام سایت CM360 cm360SiteName

  • ‫cm360Source منبع CM360

  • ‫cm360SourceMedium منبع / رسانه CM360

  • firstUserCm360AccountId شناسه حساب CM360 کاربر اول

  • firstUserCm360AccountName نام حساب CM360 کاربر اول

  • firstUserCm360AdvertiserId شناسه آگهی‌دهنده CM360 کاربر اول

  • firstUserCm360AdvertiserName نام تبلیغ‌کننده CM360 کاربر اول

  • firstUserCm360CampaignId شناسه پویش CM360 کاربر اول

  • firstUserCm360CampaignName نام کمپین CM360 کاربر اول

  • firstUserCm360CreativeFormat قالب طرح‌آگهی CM360 کاربر اول

  • firstUserCm360CreativeId شناسه طرح‌آگهی CM360 کاربر اول

  • firstUserCm360CreativeName نام طرح آگهی CM360 کاربر اول

  • firstUserCm360CreativeType نوع طرح‌آگهی CM360 کاربر اول

  • firstUserCm360CreativeTypeId شناسه نوع طرح‌آگهی CM360 کاربر اول

  • firstUserCm360CreativeVersion نسخه طرح آگهی CM360 کاربر اول

  • firstUserCm360Medium رسانه CM360 کاربر اول

  • firstUserCm360PlacementCostStructure ساختار هزینه جای آگهی CM360 کاربر اول

  • firstUserCm360PlacementId شناسه جای آگهی CM360 کاربر اول

  • firstUserCm360PlacementName نام جای آگهی CM360 کاربر اول

  • firstUserCm360RenderingId شناسه پرداز CM360 کاربر اول

  • firstUserCm360SiteId شناسه سایت CM360 کاربر اول

  • firstUserCm360SiteName نام سایت CM360 کاربر اول

  • ‫firstUserCm360Source منبع CM360 کاربر اول

  • ‫firstUserCm360SourceMedium منبع / رسانه CM360 کاربر اول

  • شناسه حساب CM360 جلسه sessionCm360AccountId

  • sessionCm360AccountName نام حساب CM360 جلسه

  • sessionCm360AdvertiserId شناسه آگهی‌دهنده CM360 جلسه

  • sessionCm360AdvertiserName نام آگهی‌دهنده CM360 جلسه

  • sessionCm360CampaignId شناسه پویش CM360 جلسه

  • sessionCm360CampaignName نام پویش CM360 جلسه

  • sessionCm360CreativeFormat قالب طرح‌آگهی CM360 جلسه

  • شناسه طرح‌آگهی CM360 جلسه sessionCm360CreativeId

  • sessionCm360CreativeName نام طرح آگهی CM360 جلسه

  • نوع طرح‌آگهی CM360 جلسه sessionCm360CreativeType

  • sessionCm360CreativeTypeId شناسه نوع طرح آگهی CM360 جلسه

  • sessionCm360CreativeVersion نسخه طرح آگهی CM360 جلسه

  • sessionCm360Medium رسانه CM360 جلسه

  • ساختار هزینه جای آگهی CM360 جلسه sessionCm360PlacementCostStructure

  • sessionCm360PlacementId شناسه جای آگهی CM360 جلسه

  • sessionCm360PlacementName نام جایگاه CM360 جلسه

  • sessionCm360RenderingId شناسه پرداز CM360 جلسه

  • sessionCm360SiteId شناسه سایت CM360 جلسه

  • نام سایت CM360 جلسه sessionCm360SiteName

  • ‫sessionCm360Source منبع CM360 جلسه

  • sessionCm360SourceMedium منبع / رسانه CM360 جلسه

بُعدهای ادغام Google Display & Video 360 (DV360):

  • dv360AdvertiserId شناسه آگهی‌دهنده DV360

  • dv360AdvertiserName نام آگهی‌دهنده DV360

  • شناسه پویش DV360 dv360CampaignId

  • dv360CampaignName نام پویش DV360

  • dv360CreativeFormat قالب طرح‌آگهی DV360

  • ‫dv360CreativeId شناسه طرح‌آگهی DV360

  • dv360CreativeName نام طرح‌آگهی DV360

  • ‫dv360ExchangeId شناسه تبادل DV360

  • dv360ExchangeName نام صرافی DV360

  • dv360InsertionOrderId شناسه سفارش درج DV360

  • dv360InsertionOrderName نام سفارش درج DV360

  • ‫dv360LineItemId شناسه مورد سطری DV360

  • dv360LineItemName نام مورد خطی DV360

  • dv360Medium DV360 medium

  • شناسه شریک DV360 dv360PartnerId

  • dv360PartnerName نام شریک DV360

  • ‫dv360Source منبع DV360

  • dv360SourceMedium منبع / رسانه DV360

  • firstUserDv360AdvertiserId شناسه آگهی‌دهنده DV360 کاربر اول

  • firstUserDv360AdvertiserName نام آگهی‌دهنده DV360 کاربر اول

  • firstUserDv360CampaignId شناسه پویش DV360 کاربر اول

  • firstUserDv360CampaignName نام پویش DV360 کاربر اول

  • firstUserDv360CreativeFormat قالب طرح‌آگهی DV360 کاربر اول

  • firstUserDv360CreativeId شناسه طرح‌آگهی DV360 کاربر اول

  • firstUserDv360CreativeName نام طرح‌آگهی DV360 کاربر اول

  • firstUserDv360ExchangeId شناسه مبادله DV360 کاربر اول

  • firstUserDv360ExchangeName نام صرافی DV360 کاربر اول

  • firstUserDv360InsertionOrderId شناسه سفارش درج DV360 کاربر اول

  • firstUserDv360InsertionOrderName نام سفارش درج DV360 کاربر اول

  • firstUserDv360LineItemId شناسه مورد خطی DV360 کاربر اول

  • firstUserDv360LinteItemName نام خط سفارش DV360 کاربر اول

  • firstUserDv360Medium رسانه DV360 کاربر اول

  • firstUserDv360PartnerId شناسه شریک DV360 کاربر اول

  • firstUserDv360PartnerName نام شریک DV360 کاربر اول

  • firstUserDv360Source منبع DV360 کاربر اول

  • firstUserDv360SourceMedium منبع / رسانه DV360 کاربر اول

  • sessionDv360AdvertiserId شناسه آگهی‌دهنده DV360 جلسه

  • sessionDv360AdvertiserName نام آگهی‌دهنده DV360 جلسه

  • sessionDv360CampaignId شناسه پویش DV360 جلسه

  • نام پویش DV360 جلسه sessionDv360CampaignName

  • sessionDv360CreativeFormat قالب طرح‌آگهی DV360 جلسه

  • sessionDv360CreativeId شناسه طرح‌آگهی DV360 جلسه

  • sessionDv360CreativeName نام طرح‌آگهی DV360 جلسه

  • sessionDv360ExchangeId شناسه تبادل DV360 جلسه

  • sessionDv360ExchangeName نام مبادله DV360 جلسه

  • sessionDv360InsertionOrderId شناسه سفارش درج DV360 جلسه

  • sessionDv360InsertionOrderName نام سفارش درج DV360 جلسه

  • ‫sessionDv360LineItemId شناسه مورد سطری DV360 جلسه

  • sessionDv360LineItemName نام ردیف هدف DV360 جلسه

  • sessionDv360Medium رسانه DV360 جلسه

  • sessionDv360PartnerId شناسه شریک DV360 جلسه

  • sessionDv360PartnerName نام شریک DV360 جلسه

  • ‫sessionDv360Source منبع DV360 جلسه

  • sessionDv360SourceMedium منبع / رسانه DV360 جلسه

ابعاد ادغام Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId شناسه گروه آگهی SA360 کاربر اول

  • firstUserSa360AdGroupName نام گروه آگهی SA360 کاربر اول

  • firstUserSa360CampaignId شناسه پویش SA360 کاربر اول

  • firstUserSa360CampaignName کمپین SA360 کاربر اول

  • firstUserSa360CreativeFormat قالب طرح آگهی SA360 کاربر اول

  • firstUserSa360EngineAccountId شناسه حساب موتور SA360 کاربر اول

  • firstUserSa360EngineAccountName نام حساب موتور SA360 کاربر اول

  • firstUserSa360EngineAccountType نوع حساب موتور SA360 کاربر اول

  • firstUserSa360KeywordText نوشتار کلیدواژه SA360 کاربر اول

  • firstUserSa360ManagerAccountId شناسه حساب مدیر SA360 کاربر اول

  • firstUserSa360ManagerAccountName نام حساب مدیر SA360 کاربر اول

  • firstUserSa360Medium رسانه SA360 کاربر اول

  • firstUserSa360Query پرسمان SA360 کاربر اول

  • ‫firstUserSa360Source منبع SA360 کاربر اول

  • firstUserSa360SourceMedium منبع / رسانه SA360 کاربر اول

  • ‫sa360AdGroupId شناسه گروه آگهی SA360

  • شناسه پویش SA360 sa360CampaignId

  • ‫sa360AdGroupName نام گروه آگهی SA360

  • ‫sa360CampaignName پویش SA360

  • قالب خلاقانه SA360 sa360CreativeFormat

  • sa360EngineAccountId شناسه حساب موتور SA360

  • sa360EngineAccountName نام حساب موتور جستجوی SA360

  • sa360EngineAccountType نوع حساب موتور SA360

  • ‫sa360KeywordText متن کلیدواژه SA360

  • شناسه حساب مدیر SA360 sa360ManagerAccountId

  • نام حساب مدیر SA360 sa360ManagerAccountName

  • sa360Medium SA360 medium

  • sa360Query پُرسمان SA360

  • ‫sa360Source منبع SA360

  • sa360SourceMedium منبع / رسانه SA360

  • ‫sessionSa360AdGroupId شناسه گروه آگهی SA360 جلسه

  • sessionSa360CampaignId شناسه پویش SA360 جلسه

  • sessionSa360ManagerAccountId شناسه حساب مدیر SA360 جلسه

  • sessionSa360ManagerAccountName نام حساب مدیر SA360 جلسه

  • sessionSa360SourceMedium منبع / رسانه SA360 جلسه

‫۲۰۲۴/۰۳/۰۶ پشتیبانی از مخاطبان کاربر غیرفعال در «صادر کردن مخاطبان».

ویژگی «صادر کردن مخاطب» از صادر کردن مخاطبان کاربر غیرفعال بهتر پشتیبانی می‌کند. کاربران بدون رویداد واجدشرایط وارد این مخاطبان می‌شوند؛ برای مثال، کاربر می‌تواند با بازدید نکردن از وب‌سایت شما به‌مدت هفت روز وارد مخاطبان شود. نمونه‌هایی از مخاطبان کاربر غیرفعال عبارتند از «خریداران غیرفعال ۷ روزه»، «کاربران غیرفعال ۷ روزه»، و «کاربران مطلع‌نشده ۷ روزه». برای کسب اطلاعات بیشتر درباره آن مخاطبان پیشنهادی، مخاطبان پیشنهادی را ببینید.

‫۲۰۲۴-۰۲-۲۸ «برون‌برهای مخاطب» شناسه کاربر مشخص‌شده در برچسب‌گذاری را برمی‌گرداند.

اکنون «صادر کردن مخاطب» شناسه کاربر مشخص‌شده در برچسب‌گذاری را برمی‌گرداند، حتی اگر داده‌های ارائه‌شده توسط کاربر برای دارایی شما روشن باشد. اگر جمع‌آوری داده‌های ارائه‌شده توسط کاربر روشن باشد، داده‌های ارائه‌شده توسط کاربر به‌همراه شناسه کاربر می‌تواند در برچسب‌گذاری به Google Analytics ارسال شود تا سنجش بهبود یابد. برای کسب اطلاعات بیشتر، جمع‌آوری داده‌های ارائه‌شده توسط کاربر را ببینید.

‫۲۰۲۴/۰۱/۳۰ پشتیبانی از اعلان‌های Webhook برای «فهرست‌های مخاطب»، «فهرست‌های مخاطب تکرارشونده» در Data API v1 alpha.

فیلدهای AudienceList.webhookNotification و RecurringAudienceList.webhookNotification را می‌توان هنگام ایجاد «فهرست مخاطبان» (بااستفاده از properties.audienceLists.create) یا «فهرست مخاطبان تکرارشونده» (بااستفاده از properties.recurringAudienceLists.create) مشخص کرد.

این قابلیت به شما امکان می‌دهد وقتی فهرست مخاطبان دردسترس قرار می‌گیرد، اعلان‌های Webhook را به‌صورت ناهمگام دریافت کنید.

‫۲۰۲۴/۰۱/۱۸ سازگاری بهبودیافته برای ابعادی که شامل رشته پُرسمان یا مؤلفه دقیقه هستند.

ابعادی که شامل رشته پُرسمان هستند اکنون با اکثر فیلدها سازگارند. ابعادی مانند pagePathPlusQueryString، unifiedPageScreen، pageLocation و fullPageUrl اکنون با بسیاری از فیلدهای دیگر ازجمله sessionSource، browser، city و landingPage سازگار هستند.

بُعدهایی که شامل مؤلفه دقیقه هستند اکنون با اکثر فیلدها سازگارند. بُعدهایی مثل minute، nthMinute، و dateHourMinute اکنون با مجموعه مشابهی از فیلدهای اضافی سازگار هستند.

برای اطلاعات جامع درباره سازگاری، به کاوشگر سنجه‌ها و ابعاد GA4 مراجعه کنید.

‫۲۰۲۳-۱۲-۱۳ پارامترهای سفارشی کالامحور

اکنون می‌توان ابعاد سفارشی کالامحور را بااستفاده از نحو زیر در پُرسمان‌های Analytics Data API گنجاند:

Generic API Name شرح
customItem:parameter_name بُعد سفارشی کالامحور برای parameter_name

برای اطلاعات بیشتر، به ابعاد و سنجه‌های API مراجعه کنید.

‫۲۰۲۳/۱۲/۰۵ «فهرست‌های مخاطبان» در Data API v1 beta به‌عنوان «برون‌بردهای مخاطب» دردسترس است

نام ویژگی «فهرست‌های مخاطبان» به برون‌بردهای مخاطبان تغییر کرده و به Data API v1 بتا اضافه شده است.

روش‌های زیر به Data API v1 beta اضافه شده است:

‫۲۰۲۳/۱۱/۲۸ samplingMetadatas به پاسخ گزارش اضافه شد

samplingMetadatas به ResponseMetaData اضافه شد. این مجموعه برای هر محدوده تاریخ در درخواست که نتایج آن نمونه‌گیری شده است، حاوی SampleMetadata خواهد بود. ‫Google Analytics فقط زمانی نمونه‌گیری را اعمال می‌کند که پیش‌بینی کند محدودیت‌های کاردینالیته کیفیت داده‌ها را کاهش خواهد داد.

‫۲۰۲۳/۱۱/۲۸ قابلیت صادر کردن تکرارشونده «فهرست مخاطبان» به Data API v1 alpha اضافه شد

روش‌های properties.recurringAudienceLists.create، properties.recurringAudienceLists.create، properties.recurringAudienceLists.list به Data API v1 alpha اضافه شد.

این قابلیت به شما امکان می‌دهد تا با تغییر عضویت‌های «مخاطب»، فهرست‌های مخاطب را به‌صورت روزانه تولید کنید. فهرست‌های مخاطبان تکرارشونده تضمین می‌کند که با جدیدترین نتایج عضویت «مخاطبان» کار می‌کنید.

‫۲۰۲۳-۱۰-۱۳ پشتیبانی از «مخاطبان» با مدت عضویت ۱ روز اضافه شد

مخاطبان با مدت عضویت ۱ روز اکنون توسط عملکرد صادر کردن «فهرست‌های مخاطبان» پشتیبانی می‌شوند.

‫۲۰۲۳-۰۹-۱۲ قوانین ترتیب پیش‌فرض AudienceList

به‌طور پیش‌فرض، گزارش‌های ایجادشده بااستفاده از عملکرد صادر کردن «فهرست‌های مخاطب» از همان قوانین ترتیب‌بندی سایر روش‌های گزارش‌دهی Data API پیروی می‌کنند: ترتیب‌بندی به‌صورت نزولی براساس ستون اول، سپس نزولی براساس ستون دوم، و غیره خواهد بود.

قبل‌از این تغییر، ممکن است گزارش زیر را دریافت کرده باشید:

deviceId isAdsPersonalizationAllowed
ABC درست
DAC نادرست
ABC نادرست
AAA درست

پس‌از این تغییر، گزارش زیر را دریافت خواهید کرد:

deviceId isAdsPersonalizationAllowed
AAA درست
ABC نادرست
ABC درست
DAC نادرست

‫۲۰۲۳/۰۸/۱۵ بُعد isLimitedAdTracking به طرح صادرات «فهرست مخاطبان» اضافه شد

  • isLimitedAdTracking تنظیمات «محدودیت ردیابی آگهی» دستگاه. مقادیر احتمالی شامل: true، false، و (not set).

    برای کسب اطلاعات بیشتر، ابعاد فهرست مخاطبان را ببینید.

‫۲۰۲۳/۰۸/۱۵ بُعد currencyCode، سنجه itemDiscountAmount اضافه شد

  • currencyCode کد ارز محلی (براساس استاندارد ISO 4217) رویداد تجارت الکترونیک. برای مثال، «USD» یا «GBP».

  • itemDiscountAmount ارزش پولی تخفیف‌های محصول در رویدادهای تجارت الکترونیک. این سنجه در برچسب‌گذاری با پارامتر مورد «discount» (تخفیف) درج می‌شود.

برای کسب اطلاعات بیشتر، طرح گزارش‌دهی Data API را ببینید.

‫۲۰۲۳/۰۸/۱۰ بُعد isAdsPersonalizationAllowed به طرح صادرات «فهرست مخاطبان» اضافه شد

  • isAdsPersonalizationAllowed آیا شخصی‌سازی آگهی مجاز است. اگر کاربر واجدشرایط شخصی‌سازی آگهی باشد، isAdsPersonalizationAllowed مقدار true را برمی‌گرداند. اگر کاربری واجدشرایط شخصی‌سازی آگهی نباشد، isAdsPersonalizationAllowed مقدار false را برمی‌گرداند.

    برای کسب اطلاعات بیشتر، ابعاد فهرست مخاطبان را ببینید.

‫۲۰۲۳-۰۷-۱۰ فهرست‌های مخاطبان

پشتیبانی از فهرست‌های مخاطبان به Data API v1 alpha اضافه شد. «فهرست‌های مخاطبان» شامل عکس آنی از کاربران در مخاطبان در زمان ایجاد «فهرست مخاطبان» است.

روش‌های زیر به Data API v1 alpha اضافه شده است:

‫۲۰۲۳/۰۵/۱۹ گروه‌های کانال سفارشی

پشتیبانی از گروه‌های کانال سفارشی به Data API اضافه شد.

‫۲۰۲۳/۰۵/۱۱ تغییرات سهمیه توکن‌ها.

سیستم سهمیه Data API به‌روز شده است تا امکان محاسبه دقیق‌تر هزینه‌ها فراهم شود.

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

پس‌از این تغییر، اگرچه هزینه برخی درخواست‌ها یکسان باقی خواهد ماند، هزینه پرسمان‌های پیچیده‌تر افزایش قابل‌توجهی خواهد داشت. برای مثال، درخواست برای داده‌های بیشتر از ۶ ماه می‌تواند ۱٬۰۰۰ یا بیشتر ژتون سهمیه مصرف کند.

مشخصه‌های استاندارد

نام سهمیه حد قدیمی محدودیت جدید
کدهای اصلی به‌ازای هر دارایی در روز ‫۲۵٬۰۰۰ ۲۰۰٬۰۰۰
کدهای اصلی به‌ازای هر دارایی در ساعت ‫۵٬۰۰۰ ۴۰٬۰۰۰
کدهای اصلی به‌ازای هر پروژه به‌ازای هر دارایی در ساعت ۱٬۷۵۰ ۱۴٬۰۰۰
کدهای هم‌زمان به‌ازای هر دارایی در روز ‫۲۵٬۰۰۰ ۲۰۰٬۰۰۰
کدهای بی‌درنگ به‌ازای هر دارایی در ساعت ‫۵٬۰۰۰ ۴۰٬۰۰۰
کدهای هم‌زمان به‌ازای هر پروژه به‌ازای هر دارایی به‌ازای هر ساعت ۱٬۷۵۰ ۱۴٬۰۰۰
کدهای قیف به‌ازای هر دارایی در روز ‫۲۵٬۰۰۰ ۲۰۰٬۰۰۰
کدهای قیف به‌ازای هر دارایی در ساعت ‫۵٬۰۰۰ ۴۰٬۰۰۰
کدهای قیف در هر پروژه در هر دارایی در هر ساعت ۱٬۷۵۰ ۱۴٬۰۰۰

دارایی‌های Analytics 360

نام سهمیه حد قدیمی محدودیت جدید
کدهای اصلی به‌ازای هر دارایی در روز ۲۵۰٬۰۰۰ ۲٬۰۰۰٬۰۰۰
کدهای اصلی به‌ازای هر دارایی در ساعت ‫۵۰٬۰۰۰ ۴۰۰٬۰۰۰
کدهای اصلی به‌ازای هر پروژه به‌ازای هر دارایی در ساعت ۱۷٬۵۰۰ ۱۴۰٬۰۰۰
کدهای هم‌زمان به‌ازای هر دارایی در روز ۲۵۰٬۰۰۰ ۲٬۰۰۰٬۰۰۰
کدهای بی‌درنگ به‌ازای هر دارایی در ساعت ‫۵۰٬۰۰۰ ۴۰۰٬۰۰۰
کدهای هم‌زمان به‌ازای هر پروژه به‌ازای هر دارایی به‌ازای هر ساعت ۱۷٬۵۰۰ ۱۴۰٬۰۰۰
کدهای قیف به‌ازای هر دارایی در روز ۲۵۰٬۰۰۰ ۲٬۰۰۰٬۰۰۰
کدهای قیف به‌ازای هر دارایی در ساعت ‫۵۰٬۰۰۰ ۴۰۰٬۰۰۰
کدهای قیف در هر پروژه در هر دارایی در هر ساعت ۱۷٬۵۰۰ ۱۴۰٬۰۰۰

‫۲۰۲۳/۰۳/۰۲ ابعاد تاریخ اضافه شد.

  • dayOfWeekName نام روز هفته. روز هفته به انگلیسی. این بُعد دارای مقادیر Sunday، Monday، و غیره است.

  • isoWeek هفته ISO سال. شماره هفته ISO، که در آن هر هفته از دوشنبه شروع می‌شود. برای جزئیات، https://en.wikipedia.org/wiki/ISO_week_date را ببینید. مقادیر نمونه شامل 01، 02، و 53 است.

  • سال ISO isoYear. سال ISO رویداد. برای جزئیات، https://en.wikipedia.org/wiki/ISO_week_date را ببینید. مقادیر نمونه شامل 2022 و 2023 است.

  • isoYearIsoWeek هفته ISO از سال ISO. مقادیر ترکیبی isoWeek و isoYear. مقادیر نمونه شامل 201652 و 201701 است.

  • yearMonth سال ماه. مقادیر ترکیبی year و month. مقادیر نمونه شامل 202212 یا 202301 است.

  • yearWeek هفته سال. مقادیر ترکیبی year و week. مقادیر نمونه شامل 202253 یا 202301 است.

‫۲۰۲۳/۰۲/۲۷ ابعاد تجارت الکترونیک اضافه شد.

  • itemListPosition موقعیت فهرست مورد. موقعیت یک مورد (مثلاً محصولی که می‌فروشید) در فهرست. این بُعد در برچسب‌گذاری توسط پارامتر «index» در آرایه موارد درج می‌شود.

  • itemLocationID شناسه مکان مورد. مکان فیزیکی مرتبط با مورد (برای نمونه، مکان فروشگاه فیزیکی). توصیه می‌شود از شناسه مکان Google که با مورد مربوطه مطابقت دارد استفاده کنید. همچنین می‌توانید از شناسه مکان سفارشی استفاده کنید. این فیلد در برچسب‌گذاری با پارامتر «location_id» در آرایه موارد درج می‌شود.

  • itemPromotionCreativeSlot جایگاه آگهی تبلیغاتی محصول. نام جای متن آگهی تبلیغاتی مرتبط با مورد. این بُعد را می‌توان در برچسب‌گذاری با پارامتر creative_slot در سطح رویداد یا مورد مشخص کرد. اگر پارامتر هم در سطح رویداد و هم در سطح مورد مشخص شده باشد، از پارامتر سطح مورد استفاده می‌شود.

‫۲۰۲۳-۰۲-۲۱ بُعد «صفحه مقصد + رشته پُرسمان» اضافه شد.

  • landingPagePlusQueryString صفحه مقصد + رشته پُرسمان. مسیر صفحه + رشته پُرسمان مرتبط با اولین بازدید صفحه در جلسه.

این فیلد جایگزین بُعد landingPage می‌شود که منسوخ شده است و در ۱۴ مه ۲۰۲۳ به‌روزرسانی خواهد شد تا رشته پُرسمان را برنگرداند.

‫۲۰۲۳/۰۱/۲۸ سنجه‌های «بازدید به‌ازای هر کاربر» و «کاربرانی که پیمایش کرده‌اند» اضافه شد.

  • screenPageViewsPerUser بازدید به‌ازای هر کاربر. تعداد صفحه‌های برنامه یا صفحه‌های وبی که کاربران شما به‌ازای هر کاربر فعال مشاهده کرده‌اند. بازدیدهای تکراری از یک صفحه یا صفحه نمایش شمارش می‌شوند. (screen_view + page_view events) / active users.

  • scrolledUsers کاربر پیمایش‌کننده. تعداد کاربران متمایزی که حداقل ‎٪۹۰ صفحه را پیمایش کرده‌اند.

‫۲۰۲۳/۰۱/۲۳ ابعاد «قاره»، «شناسه قاره» اضافه شد.

  • continent قاره. قاره‌ای که فعالیت کاربر از آن نشأت گرفته است. برای مثال، Americas یا Asia.

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

‫۲۰۲۳/۰۱/۲۳ بُعد «شناسه فیلتر داده آزمایشی» اضافه شد.

  • testDataFilterId شناسه فیلتر داده‌های آزمایشی. شناسه عددی فیلتر داده در حالت آزمایش. از فیلترهای داده برای گنجاندن یا نگنجاندن داده‌های رویداد در گزارش‌هایتان براساس مقادیر پارامتر رویداد استفاده می‌کنید. برای کسب اطلاعات بیشتر، به https://support.google.com/analytics/answer/10108813 مراجعه کنید.

‫۲۰۲۲/۱۰/۱۸ سنجه‌های Ads اضافه شد.

  • advertiserAdClicks کلیک روی آگهی. تعداد کل دفعاتی که کاربران روی آگهی کلیک کرده‌اند تا به دارایی برسند.
  • advertiserAdCost هزینه آگهی‌ها. مبلغ کل پرداختی شما برای آگهی‌هایتان.
  • advertiserAdCostPerClick کلیک‌بهای آگهی‌ها. کلیک‌بهای آگهی عبارت است از هزینه آگهی تقسیم بر تعداد کلیک‌های آگهی و اغلب به‌صورت CPC مخفف می‌شود.
  • advertiserAdCostPerConversion تبدیل‌بها. هزینه هر تبدیل عبارت است از هزینه آگهی تقسیم بر تعداد تبدیل‌ها.
  • advertiserAdImpressions ظهور آگهی. تعداد کل درج‌ها.
  • returnOnAdSpend بازگشت هزینه‌کرد تبلیغات. «برگشت هزینه‌های تبلیغات» (ROAS) عبارت است از درآمد کل تقسیم بر هزینه آگهی تبلیغ‌کننده.

‫۲۰۲۲-۱۰-۱۷ سنجه‌های کالامحور اضافه شد.

  • itemsAddedToCart مورد به سبد خرید اضافه شد. تعداد واحدهای اضافه‌شده به سبد خرید برای یک محصول.
  • itemsCheckedOut مورد بررسی شد. تعداد واحدهای تسویه‌شده برای یک مورد.
  • itemsClickedInList مورد در فهرست کلیک شد. تعداد واحدهای کلیک‌شده در فهرست برای یک مورد.
  • ‫itemsClickedInPromotion مورد در تبلیغ کلیک شد. تعداد واحدهای کلیک‌شده در تبلیغ برای یک مورد.
  • itemsViewed مورد مشاهده شد. تعداد واحدهای مشاهده‌شده برای یک مورد.
  • itemsViewedInList مورد در فهرست مشاهده شد. تعداد واحدهای مشاهده‌شده در فهرست برای یک مورد.
  • itemsViewedInPromotion مورد در عرضه ترویجی مشاهده شد. تعداد واحدهای مشاهده‌شده در تبلیغ برای یک مورد.

‫۲۰۲۲/۰۹/۱۳ اعلام تغییرات سازگاری طرح‌واره.

در ۱ دسامبر ۲۰۲۲، تغییرات اساسی زیر رخ خواهد داد:

  1. بُعدهای کالامحور مثل itemName با سنجه‌های رویدادمحور مثل eventCount ناسازگار می‌شوند. بُعدهای کالامحور همچنان با سنجه‌های کالامحور مثل itemRevenue، سنجه‌های کاربرمحور مثل activeUsers، و سنجه‌های جلسه‌محور مثل sessions سازگار خواهند بود.

  2. بُعدهای اسنادی مثل source با برخی‌از سنجه‌های رویدادمحور مثل eventCount ناسازگار می‌شوند. ابعاد اسناد همچنان با سنجه‌های قابل‌اسناد مثل conversions، سنجه‌های کاربرمحور مثل activeUsers، و سنجه‌های جلسه‌محور مثل sessions سازگار خواهند بود.

  3. ابعادی که شامل رشته پُرسمان مانند pagePathPlusQueryString هستند فقط با مجموعه محدودی از ابعاد و سنجه‌ها سازگار خواهند بود.

‫۲۰۲۲/۰۹/۰۱ تغییرات سهمیه.

  • سهمیه‌های Requests per day،‏ Requests Per Minute،‏ Requests Per Minute Per User از Data API برداشته شده است.

  • سهمیه Tokens Per Project Per Property Per Hour به API اضافه شده است.

  • هر درخواست سهمیه را هم برای Tokens Per Property Per Hour و هم برای Tokens Per Project Per Property Per Hour مصرف می‌کند.

    برای اطلاعات دقیق درباره سهمیه‌های جدید، اسناد سهمیه‌ها را ببینید.

‫۲۰۲۲-۰۸-۰۳ بُعدهای SA360 جلسه‌محور اضافه شد.

  • sessionSa360AdGroupName نام گروه آگهی SA360 جلسه. نام «گروه آگهی» از Search Ads 360 که به این جلسه منجر شده است.

  • sessionSa360CampaignName پویش SA360 جلسه. نام پویش از Search Ads 360 که به این جلسه منجر شده است.

  • sessionSa360CreativeFormat قالب طرح‌آگهی SA360 جلسه. نوع طرح آگهی در Search Ads 360 که به این جلسه منجر شده است. برای مثال، «آگهی جستجوهای واکنش‌گرا» یا «آگهی نوشتاری گسترش‌یافته».

  • sessionSa360EngineAccountId شناسه حساب موتور SA360 جلسه. شناسه حساب موتور در SA360 که به این جلسه منجر شده است.

  • sessionSa360EngineAccountName نام حساب موتور SA360 جلسه. نام حساب موتور در SA360 که به این جلسه منجر شده است.

  • sessionSa360EngineAccountType نوع حساب موتور SA360 جلسه. نوع حساب موتور در Search Ads 360 که به این جلسه منجر شده است. برای مثال، «google ads»،‏ «bing»، یا «baidu».

  • sessionSa360Keyword نوشتار کلیدواژه SA360 جلسه. کلیدواژه موتور جستجو از Search Ads 360 که به این جلسه منجر شده است.

  • sessionSa360Medium رسانه SA360 جلسه. کلیدواژه موتور جستجو از Search Ads 360 که به این جلسه منجر شده است. برای مثال، «cpc».

  • sessionSa360Query پرسمان SA360 جلسه. پرسمان جستجو از Search Ads 360 که به این جلسه منجر شده است.

  • sessionSa360Source منبع SA360 جلسه. منبع ترافیک از Search Ads 360 که به این جلسه منجر شده است. برای مثال، «example.com» یا «google».

  • اکنون بُعدهای sessionCampaignId، sessionCampaignName از کمپین‌های Search Ads 360 پشتیبانی می‌کنند.

‫۲۰۲۲/۰۷/۱۱ سنجه‌های نرخ تبدیل اضافه شد.

نرخ تبدیل

  • sessionConversionRate درصد جلسه‌هایی که در آن‌ها رویداد تبدیل راه‌اندازی شده است.

  • userConversionRate درصد کاربرانی که هریک از رویدادهای تبدیل را راه‌اندازی کرده‌اند.

سنجه‌های نرخ تبدیل برای یک تبدیل

  • sessionConversionRate:event_name درصد جلسه‌هایی که در آن‌ها رویداد تبدیل خاصی راه‌اندازی شده است.

  • userConversionRate:event_name درصد کاربرانی که رویداد تبدیل خاصی را راه‌اندازی کرده‌اند.

‫۲۰۲۲-۰۵-۰۵ قابلیت گزارش‌دهی «قیف» به کانال «آلفا» اضافه شد.

  • روش runFunnelReport به نسخه v1alpha از میانای برنامه‌سازی کاربردی اضافه شد، که گزارش قیف سفارشی‌شده‌ای از داده‌های رویداد Google Analytics شما برمی‌گرداند.

  • این روش در پایداری آلفا با هدف جمع‌آوری بازخورد درباره نحو و قابلیت‌ها قبل‌از ورود به نسخه بتا معرفی شده است. لطفاً بازخورد گزارش‌دهی قیفی Google Analytics Data API را تکمیل کنید تا بازخوردتان را درباره این API ارائه دهید.

‫۲۰۲۲/۰۲/۱۶ ابعاد جدید اضافه شد.

شرایط و محتوای دستی

  • firstUserManualAdContent First user manual ad content. محتوای آگهی‌ای که نخستین بار کاربر را جذب کرده است. با پارامتر utm_content پر شده است.

  • firstUserManualTerm اولین عبارت راهنمای کاربر. عبارتی که نخستین بار کاربر را جذب کرده است. با پارامتر utm_term پر شده است.

  • manualAdContent محتوای آگهی دستی. محتوای آگهی منسوب به رویداد تبدیل. با پارامتر utm_content پر شده است.

  • manualTerm شرایط دستی. عبارت منسوب به رویداد تبدیل. با پارامتر utm_term پر شده است.

  • sessionManualAdContent محتوای آگهی دستی جلسه. محتوای آگهی که به جلسه منجر شده است. با پارامتر utm_content پر شده است.

  • sessionManualTerm Session manual term. عبارتی که به جلسه منجر شده است. با پارامتر utm_term پر شده است.

تجزیه‌وتحلیل خرابی

  • crashAffectedUsers کاربر تحت‌تأثیر خرابی. تعداد کاربرانی که در این ردیف گزارش، خرابی ثبت کرده‌اند.

  • crashFreeUsersRate نرخ کاربران بدون تجربه خرابی.

برنامه/وب

  • averageSessionDuration میانگین مدت (به ثانیه) جلسه‌های کاربران.

  • newVsReturning کاربر جدید / برگشتی.

  • screenPageViewsPerSession بازدید در هر جلسه.

  • landingPage صفحه مقصد. مسیر صفحه + رشته پُرسمان مرتبط با اولین بازدید صفحه در جلسه.

  • platformDeviceCategory پلاتفرم و نوع دستگاهی که وب‌سایت یا برنامه تلفن همراه شما در آن اجرا شده است.

برنامه تلفن همراه

  • averagePurchaseRevenuePerUser میانگین درآمد خرید به‌ازای هر کاربر.

  • firstTimePurchaserConversionRate درصد کاربران فعالی که اولین خریدشان را انجام داده‌اند.

  • firstTimePurchasersPerNewUser میانگین تعداد خریداران بار اولی به‌ازای هر کاربر جدید.

  • dauPerMau کاربران فعال روزانه / کاربران فعال ماهانه. درصد متغیر کاربران فعال ۳۰ روزه که کاربران فعال ۱ روزه هم هستند.

  • dauPerWau کاربران فعال روزانه / کاربران فعال هفتگی. درصد متغیر کاربران فعال ۷ روزه که کاربران فعال ۱ روزه هم هستند.

  • wauPerMau کاربران فعال هفتگی / کاربران فعال ماهانه. درصد متحرک کاربران فعال ۳۰ روزه که کاربران فعال ۷ روزه هم هستند.

  • purchaserConversionRate درصد کاربران فعالی که ۱ یا چند تراکنش خرید انجام داده‌اند.

  • transactionsPerPurchaser تراکنش به‌ازای هر خریدار.

پویش Google Ads

  • firstUserGoogleAdsCampaignType نوع پویش Google Ads که نخستین بار کاربر را جذب کرده است.

  • googleAdsCampaignType نوع پویش برای پویش Google Ads منسوب به رویداد تبدیل.

  • sessionGoogleAdsCampaignType نوع پویش برای پویش Google Ads که به این جلسه منجر شد.

‫۲۰۲۱-۰۹-۰۷ ابعاد جدید تاریخ/زمان اضافه شد.

  • dateHourMinute مقادیر ترکیبی تاریخ، ساعت، و دقیقه در قالب YYYYMMDDHHMM.

  • minute دقیقه دو رقمی از ساعتی که رویداد ثبت شده است.

  • nthMinute تعداد دقیقه‌های سپری‌شده از شروع محدوده تاریخ.

‫۲۰۲۱/۰۹/۰۷ ابعاد جدیدی که با پارامترهای رویداد پر شده‌اند اضافه شد.

  • achievementId شناسه جایزه در بازی برای رویداد.

  • character شخصیت بازیکن در بازی برای رویداد.

  • fileExtension افزونه فایل بارگیری‌شده.

  • fileName مسیر صفحه فایل بارگیری‌شده.

  • groupId شناسه گروه بازیکن در بازی برای رویداد.

  • linkClasses مشخصه کلاس HTML برای پیوند خروجی.

  • linkDomain دامنه مقصد پیوند خروجی.

  • linkId مشخصه شناسه HTML برای پیوند برون‌مرزی یا بارگیری فایل.

  • linkText نوشتار پیوند بارگیری فایل.

  • linkUrl نشانی وب کامل برای پیوند برون‌سو یا بارگیری فایل.

  • method روشی که رویداد با آن راه‌اندازی شده است.

  • outbound اگر پیوند به سایتی منتهی شود که بخشی از دامنه دارایی نیست، «درست» را برمی‌گرداند.

  • pageLocation پروتکل، نام میزبان، مسیر صفحه، و رشته پُرسمان برای صفحه‌های وب بازدیدشده.

  • pageReferrer نشانی وب ارجاع‌دهنده کامل شامل نام میزبان و مسیر.

  • percentScrolled درصدی از صفحه که کاربر به پایین پیمایش کرده است (برای مثال، «۹۰»).

  • searchTerm عبارتی که کاربر جستجو کرده است.

  • videoProvider منبع ویدیو (برای مثال، «youtube»).

  • videoTitle عنوان ویدیو.

  • videoUrl نشانی وب ویدیو.

  • visible اگر محتوا نمایان باشد، «درست» را برمی‌گرداند.

  • unifiedPagePathScreen مسیر صفحه (وب) یا کلاس صفحه‌نمایش (برنامه) که رویداد در آن ثبت شده است.

‫۲۰۲۱-۰۹-۰۷ تغییرات طرح‌واره میانای برنامه‌سازی کاربردی.

تغییرات در ابعاد موجود:

  • unifiedPageScreen برای رویدادهای تولیدشده در وب، این بُعد اکنون مسیر صفحه و رشته پُرسمان را که رویداد در آن ثبت شده است برمی‌گرداند.

اعلام تغییرات آتی:

  • firstUserTrafficOrigin منبع ترافیکی که نخستین بار کاربر را جذب کرده است. لطفاً برای ترافیکی که از UTM استفاده می‌کند، به این فیلد که «دستی» را برمی‌گرداند وابسته نباشید؛ این فیلد برای راه‌اندازی ویژگی آتی، از برگرداندن «دستی» به برگرداندن «(تنظیم‌نشده)» به‌روز خواهد شد.

  • sessionTrafficOrigin مبدأ ترافیک پویش جلسه. لطفاً برای ترافیکی که از UTM استفاده می‌کند، به این فیلد که «دستی» را برمی‌گرداند وابسته نباشید؛ این فیلد برای راه‌اندازی ویژگی آتی، از برگرداندن «دستی» به برگرداندن «(تنظیم‌نشده)» به‌روز خواهد شد.

  • trafficOrigin مبدأ ترافیک پویش رویداد تبدیل. لطفاً برای ترافیکی که از UTM استفاده می‌کند، به این فیلد که «دستی» را برمی‌گرداند وابسته نباشید؛ این فیلد برای راه‌اندازی ویژگی آتی، از برگرداندن «دستی» به برگرداندن «(تنظیم‌نشده)» به‌روز خواهد شد.

‫۲۰۲۱/۰۹/۰۷ روش checkCompatibility به میانای برنامه‌سازی کاربردی اضافه شد.

checkCompatibility روش، ابعاد و سنجه‌هایی را که می‌توانند به درخواست گزارش اضافه شوند و سازگاری را حفظ کنند فهرست می‌کند.

‫۲۰۲۱/۰۷/۲۱ تغییرات گزارش‌دهی بلادرنگ.

اکنون می‌توان بااستفاده از پارامتر minuteRanges در روش runRealtimeReport، محدوده دقیقه‌ای داده‌های رویداد را برای خواندن مشخص کرد.

‫۲۰۲۱-۰۷-۲۱ ابعاد جدید گروه‌بندی کانال.

ابعاد گروه‌بندی کانال جدید به طرح گزارش‌دهی Data API اضافه شده است:

  • firstUserDefaultChannelGrouping گروه‌بندی کانال پیش‌فرض کاربر اول.

  • defaultChannelGrouping گروه‌بندی کانال پیش‌فرض.

تغییرات ۲۰۲۱-۰۶-۱۰ طرح‌واره ای‌پی‌آی.

  • بُعد minutesAgo به طرح‌واره هم‌زمان Data API اضافه شد و می‌توان از آن در پُرسمان‌های روش runRealtimeReport استفاده کرد. این بُعد حاوی تعداد دقیقه‌هایی است که از جمع‌آوری رویداد گذشته است. ‫00 دقیقه فعلی است و 01 یعنی دقیقه قبلی.

  • بُعد googleAdsCreativeId به طرح‌واره Data API اضافه شد. این بُعد حاوی شناسه طرح‌آگهی Google Ads منسوب به رویداد تبدیل است.

  • بُعد sessionGoogleAdsCreativeId به طرح‌واره Data API اضافه شد. این بُعد حاوی شناسه طرح‌آگهی Google Ads است که به جلسه‌ای در وب‌سایت یا برنامه شما منجر شده است.

  • نام بُعد firstUserCreativeId در طرح‌واره Data API به firstUserGoogleAdsCreativeId تغییر کرد. این بُعد حاوی شناسه طرح‌آگهی Google Ads است که نخستین بار کاربر را جذب کرده است.

‫۲۰۲۱-۰۴-۰۹ نسخه بتای Google Analytics Data API v1 منتشر شده است.

  • نقطه پایانی میانای برنامه‌سازی کاربردی به https://analyticsdata.googleapis.com/v1beta به‌روز شد.

  • روش‌های runReport، runPivotReport، batchRunReports، batchRunPivotReports اکنون شناسه دارایی Google Analytics 4 را در پارامتر property مسیر نشانی وب به‌جای فیلد entity بدنه درخواست می‌پذیرند:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

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

‫۲۰۲۱/۰۲/۱۹ تغییرات صفحه‌بندی.

  • اندازه پاسخ گزارش پیش‌فرض از ۱۰ به ۱۰٬۰۰۰ ردیف داده‌های رویداد افزایش یافت.

  • مقدار "limit" : -1 که برای نشان دادن تلاش برای بازیابی همه ردیف‌ها استفاده می‌شد دیگر در RunReportRequest پشتیبانی نمی‌شود.

  • حداکثر مقدار فیلد limit روی 100000 تنظیم شده است. از صفحه‌بندی برای بازیابی گزارش‌های حاوی بیش‌از ۱۰۰٬۰۰۰ ردیف استفاده کنید.

‫۲۰۲۱/۰۲/۰۸ سنجه‌ها و ابعاد جدید تجارت الکترونیک.

سنجه‌ها و ابعاد جدید تجارت الکترونیک به طرح‌واره ای‌پی‌آی اضافه شده است:

ابعاد: adFormat، adSourceName، adUnitName، itemBrand، itemCategory، itemCategory2، itemCategory3، itemCategory4، itemCategory5 itemId، itemListId، itemListName، itemName، itemPromotionCreativeName، itemPromotionId، itemPromotionName، orderCoupon، transactionId.

سنجه‌ها: adUnitExposure، addToCarts، cartToViewRate، checkouts، ecommercePurchases، firstTimePurchasers، itemListClickThroughRate، itemListClicks، itemListViews، itemPromotionClickThroughRate، itemPromotionClicks، itemPromotionViews، itemPurchaseQuantity، itemRevenue، itemViews، publisherAdClicks، publisherAdImpressions، totalPurchasers.

‫۲۰۲۱/۰۲/۰۸ ابعاد پویش جدید اضافه شد.

ابعاد پویش جدیدی به طرح‌واره ای‌پی‌آی اضافه شده است: campaignId، campaignName، googleAdsAccountName، googleAdsAdGroupId، googleAdsAdGroupName، googleAdsAdNetworkType، source، trafficOrigin

‫۲۰۲۱-۰۲-۰۸ dayOfWeek، week تغییرات ابعاد.

  • مقدار بُعد dayOfWeek اکنون به‌جای ۱ با ۰ شروع می‌شود.

  • مقدار بُعد week اکنون با ۰۱ شروع می‌شود و عدد دورقمی از ۰۱ تا ۵۳ را برمی‌گرداند. هر هفته از یکشنبه شروع می‌شود. ۱ ژانویه همیشه در هفته ۰۱ است.

‫۲۰۲۱-۰۱-۲۸ انواع تجمیع برای سنجه‌های سفارشی اضافه شد.

هر سنجه سفارشی که دارایی ثبت می‌کند سه نوع سنجه API ایجاد می‌کند: مجموع، میانگین، و تعداد.

‫۲۰۲۱-۰۱-۲۸ ابعاد جدید تاریخ/زمان اضافه شد.

ابعاد جدید زیر به طرح‌واره میانای برنامه‌سازی کاربردی اضافه شده است: hour،‏ nthHour،‏ nthYear،‏ dateHour.

‫۲۰۲۱-۰۱-۲۸ Data API ژتون‌های سهمیه کسرشده به‌ازای هر پُرسمان را کاهش داد.

Data API نشان‌های سهمیه کسرشده برای هر پُرسمان را کاهش داد. حدود سهمیه برای ژتون‌های سهمیه دارایی در ساعت و در روز تغییر نکرده است.

‫۲۰۲۰/۱۱/۰۹ روش getUniversalMetadata حذف شده است.

روش getUniversalMetadata حذف شده است. لطفاً از getMetadata استفاده کنید. حداکثر محدوده تاریخ یک‌ساله برای هر درخواست API برداشته شده است.

‫۲۰۲۰-۱۱-۰۲ «روش گزارش‌دهی هم‌زمان» اضافه شد.

برای مشاهده نمونه‌ها، به ایجاد گزارش بلادرنگ و برای اسناد مرجع REST به runRealtimeReport مراجعه کنید.

‫۲۰۲۰-۱۰-۱۹ مصنوعات کتابخانه مشتری به‌روز شد.

ساخته‌های کتابخانه کارخواه به‌همراه دستورالعمل‌های استفاده و نمونه‌های کد به‌روزرسانی شد.

‫۲۰۲۰-۱۰-۱۳ نام دارایی‌های «برنامه + وب» به Google Analytics 4 ‏(GA4) تغییر کرده است.

‫۲۰۲۰-۱۰-۰۸ روش getMetadata به میانای برنامه‌سازی کاربردی اضافه شد.

روش getMetadata سنجه‌ها و ابعاد سفارشی دردسترس برای شناسه دارایی GA4 مشخص‌شده و همچنین فراداده Universal را برمی‌گرداند.

‫۲۰۲۰-۱۰-۰۸ ابعاد و سنجه‌های سفارشی در گزارش‌ها دردسترس است.

برای مستندات مربوط به ابعاد و سنجه‌های سفارشی، به مستندات طرح‌واره میانای برنامه‌سازی کاربردی مراجعه کنید. این به‌روزرسانی شامل «ابعاد سفارشی» و سنجه‌های رویدادمحور و همچنین «ابعاد سفارشی» کاربرمحور است.