گزارش تغییر

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

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

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

  • بدنه درخواست پُرسمان، شناسه جلسه اختیاری برای ادامه دادن مکالمه قبلی، و پارامتر اختیاری returnPropertyQuota را می‌پذیرد.
  • درصورت درخواست، پاسخ داده‌های پاسخ گپ ساختاریافته را در ResponseBlock اشیا، شناسه جلسه، و جزئیات سهمیه کد دارایی بااستفاده از PropertyChatQuota برمی‌گرداند.
  • گستره https://www.googleapis.com/auth/analytics.chatbot.read OAuth دسترسی خواندن به روش 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 می‌شود. نمونه‌هایی از خطاهایی که تحت این سهمیه قرار می‌گیرند: استفاده از ترکیب‌های ابعاد و سنجه‌های ناسازگار، همه خطاهای اصالت‌سنجی.

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

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

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

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

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

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

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

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

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

بااستفاده از وظایف گزارش، می‌توانید درخواست ناهم‌زمان طولانی‌مدتی را برای ایجاد گزارش سفارشی از داده‌های رویداد 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 ورودی‌ای با نام منسوخ‌شده میانای برنامه‌سازی کاربردی تبدیل دارد.

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

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

ابعاد مخاطب:

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

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

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

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

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

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

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

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

  • manualCreativeFormat قالب خلاقانه دستی

  • manualMarketingTactic آرایش بازاریابی دستی

  • manualMedium دفترچه راهنمای متوسط

  • ‫manualSource منبع دستی

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

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

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

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

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

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

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

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

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

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

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

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

  • sessionManualCreativeFormat قالب خلاقانه دستی جلسه

  • sessionManualMarketingTactic آرایش بازاریابی دستی جلسه

  • sessionManualMedium Session manual medium

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

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

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

ابعاد یکپارچه‌سازی Campaign Manager 360 (CM360):

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

  • نام حساب cm360AccountName CM360

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

  • cm360AdvertiserName نام تبلیغ‌کننده CM360

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

  • نام پویش cm360CampaignName CM360

  • قالب عنصر خلاقانه cm360CreativeFormat CM360

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

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

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

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

  • ‫cm360CreativeVersion نسخه عنصر خلاق CM360

  • ‫cm360Medium CM360 medium

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

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

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

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

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

  • نام سایت cm360SiteName CM360

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

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

  • قالب عنصر خلاقانه CM360 جلسه sessionCm360CreativeFormat

  • sessionCm360CreativeId شناسه عنصر خلاق CM360 جلسه

  • sessionCm360CreativeName نام عنصر خلاقانه CM360 جلسه

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

  • sessionCm360CreativeTypeId شناسه نوع عنصر خلاقانه CM360 جلسه

  • sessionCm360CreativeVersion نسخه عنصر خلاقانه CM360 جلسه

  • ‫sessionCm360Medium میانای CM360 جلسه

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

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

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

  • sessionCm360RenderingId شناسه ارائه جلسه CM360

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

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

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

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

ابعاد یکپارچه‌سازی Google Display & Video 360 (DV360):

  • ‫dv360AdvertiserId شناسه تبلیغ‌کننده DV360

  • dv360AdvertiserName نام تبلیغ‌کننده DV360

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

  • نام پویش dv360CampaignName در DV360

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

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

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

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

  • نام صرافی dv360ExchangeName DV360

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

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

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

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

  • ‫dv360Medium میانه‌ DV360

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

  • نام شریک DV360 dv360PartnerName

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

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

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

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

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

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

  • شناسه عنصر خلاقانه DV360 جلسه sessionDv360CreativeId

  • نام عنصر خلاقانه DV360 جلسه sessionDv360CreativeName

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

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

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

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

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

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

  • ‫sessionDv360Medium جلسه میانای DV360

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

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

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

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

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

  • ‫sa360CampaignName پویش SA360

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

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

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

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

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

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

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

  • ‫sa360Medium SA360 متوسط

  • پُرسمان sa360Query SA360

  • ‫sa360Source منبع SA360

  • ‫sa360SourceMedium منبع / میانای SA360

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

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

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

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

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

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

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

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

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

‫۲۰۲۴-۰۱-۳۰ پشتیبانی از اعلان‌های وب‌قلاب برای «فهرست‌های مخاطبان»، «فهرست‌های مخاطبان تکرارشونده» در 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 گنجانده شوند:

نام میانای برنامه‌سازی کاربردی عمومی شرح
customItem:parameter_name «ابعاد سفارشی» سطح مورد برای parameter_name

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

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

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

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

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

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

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

روش‌های properties.recurringAudienceLists.create، properties.recurringAudienceLists.create، properties.recurringAudienceLists.list به «نسخه آلفای Data API v1» اضافه شد.

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

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

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

قوانین ترتیب پیش‌فرض 2023-09-12 «فهرست مخاطبان»

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فهرست‌های مخاطبان 2023-07-10

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

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

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

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

تغییرات سهمیه 2023-05-11 در تعداد نشان‌ها.

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

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

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

دارایی‌های استاندارد

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

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

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

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

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

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

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

  • ‫isoYearIsoWeek هفته استاندارد بین‌المللی سازمان استانداردسازی بین‌المللی. مقادیر ترکیبی 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 کلیک‌بهای آگهی. «کلیک‌بهای آگهی» عبارت است از هزینه آگهی تقسیم بر کلیک‌های آگهی و اغلب به‌صورت «کلیک‌بها» خلاصه می‌شود.
  • 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 سهمیه‌ها از «میانای برنامه‌سازی کاربردی داده» برداشته می‌شود.

  • سهمیه 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»، «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 از API اضافه شد، که گزارش قیف سفارشی‌شده‌ای از داده‌های رویداد Google Analytics شما برمی‌گرداند.

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

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

عبارت و محتوای دستی

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

  • firstUserManualTerm اولین اصطلاح دفترچه راهنمای کاربر. اصطلاحی که کاربر را برای اولین‌بار جذب کرده است. با پارامتر utm_term تکمیل شده است.

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

  • ‫manualTerm دوره دستی. اصطلاح نسبت‌داده‌شده به رویداد تبدیل. با پارامتر utm_term تکمیل شده است.

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

  • sessionManualTerm اصطلاح دستی جلسه. عبارتی که منجر به جلسه شده است. با پارامتر 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 مسیر صفحه (وب) یا کلاس صفحه‌نمایش (برنامه) که رویداد در آن ثبت شده است.

تغییرات طرح‌واره میانای برنامه‌سازی کاربردی 2021-09-07.

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

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

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

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

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

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

روش 2021-09-07 checkCompatibility به «میانای برنامه‌سازی کاربردی» اضافه شد.

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

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

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

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

ابعاد جدید گروه‌بندی کانال به طرح گزارش «میانای برنامه‌سازی کاربردی داده» اضافه شد:

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

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

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

  • ابعاد minutesAgo به طرحواره هم‌زمان «میانای برنامه‌سازی کاربردی داده» اضافه شد و می‌تواند در پُرسمان‌های روش runRealtimeReport استفاده شود. این بُعد شامل تعداد دقایقی است که رویدادی جمع‌آوری شده است. ‫۰۰ دقیقه فعلی و ۰۱ دقیقه قبلی را نشان می‌دهد.

  • ‫googleAdsCreativeId بُعد به طرح‌واره «میانای برنامه‌سازی کاربردی داده» اضافه شد. این بُعد حاوی شناسه عنصر خلاقانه Google Ads نسبت‌داده‌شده به رویداد تبدیل است.

  • ‫sessionGoogleAdsCreativeId بُعد به طرح‌واره «میانای برنامه‌سازی کاربردی داده» اضافه شد. این بُعد حاوی شناسه طرح‌آگهی 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 تعداد نشان‌های سهمیه کسرشده برای هر پُرسمان را کاهش داد. محدودیت‌های سهمیه برای توکن‌های سهمیه دارایی در ساعت و در روز تغییر نکرده است.

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

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

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

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

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

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

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

روش 2020-10-08 getMetadata به API اضافه شد.

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

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

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