تغییرات

برای اطلاع از اطلاعیه‌های رسمی API گوگل آنالیتیکس، لطفاً در گروه اطلاع‌رسانی API گوگل آنالیتیکس عضو شوید.

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

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

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

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

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

۲۰۲۴-۰۹-۱۸ ویژگی Snapshot سهمیه املاک اضافه شد

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

2024-06-28 سهمیه «خطاهای مشتری به ازای هر پروژه به ازای هر ملک» اضافه شد

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

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

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

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

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

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

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

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

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

2024-05-08 وظایف گزارش، یک ویژگی گزارش‌دهی ناهمزمان، به Data API نسخه ۱alpha اضافه شد.

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

روش‌های دستکاری وظایف گزارش زیر به Data API نسخه ۱alpha اضافه شده‌اند:

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

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

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

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

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

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

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

  • apiName ، uiName و description شامل نام API رویداد کلیدی، نام UI و توضیحات آن هستند.
  • فیلد تکراری deprecatedApiNames دارای ورودی با نام API تبدیل منسوخ شده است.

2024-03-25 گروه کانال اصلی، منبع ترافیک دستی و ابعاد خاص ادغام اضافه شد.

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

ابعاد مخاطب:

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

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

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

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

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

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

  • manualCampaignId کمپین دستی

  • manualCampaignName نام کمپین دستی

  • قالب خلاقانه manualCreativeFormat

  • تاکتیک manualMarketingTactic تاکتیک بازاریابی دستی

  • manualMedium ​​​​دستی متوسط

  • منبع دستی منبع manualSource

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

  • پلتفرم منبع manualSourcePlatform

  • firstUserManualCampaignId کمپین راهنمای کاربر اول

  • firstUserManualCampaignName نام کمپین راهنمای کاربر اول نام کمپین

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

  • تاکتیک بازاریابی firstUserManualMarketingTactic اولین تاکتیک بازاریابی مبتنی بر کتابچه راهنمای کاربر

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

  • firstUserManualSource اولین منبع راهنمای کاربر

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

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

  • sessionManualCampaignId کمپین دستی جلسه

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

  • قالب خلاقانه‌ی کتابچه‌ی sessionManualCreativeFormat خلاقانه‌ی کتابچه‌ی راهنمای جلسه

  • sessionManualMarketingTactic تاکتیک بازاریابی دستی

  • sessionManualMedium رسانه دستی جلسه

  • منبع راهنمای sessionManualSource

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

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

ابعاد یکپارچه‌سازی مدیر کمپین ۳۶۰ (CM360):

  • cm360AccountId حساب cm360

  • نام cm360AccountName نام حساب CM360

  • cm360AdvertiserId تبلیغ کننده cm360

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

  • cm360CampaignId کمپین cm360

  • نام کمپین cm360CampaignName نام کمپین CM360

  • قالب خلاقانه cm360CreativeFormat

  • شناسه خلاق cm360CreativeId

  • cm360CreativeName نام خلاقانه CM360

  • نوع خلاق cm360CreativeType

  • cm360CreativeTypeId نوع خلاق cm360

  • نسخه خلاقانه cm360CreativeVersion

  • cm360Medium CM360 متوسط

  • ساختار هزینه استقرار cm360PlacementCostStructure ساختار هزینه استقرار CM360

  • cm360PlacementId قرارگیری cm360

  • نام محل قرارگیری cm360PlacementName نام محل قرارگیری CM360

  • شناسه رندر cm360RenderingId

  • شناسه سایت cm360SiteId

  • نام cm360SiteName نام سایت CM360

  • منبع cm360Source منبع CM360

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

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

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

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

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

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

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

  • قالب خلاقانه کاربر firstUserCm360CreativeFormat Cm360

  • firstUserCm360CreativeId اولین کاربر CM360 creative ID

  • firstUserCm360CreativeName خلاقاولین کاربر CM360 نام خلاق

  • کاربر firstUserCm360CreativeType کاربر CM360 نوع خلاق

  • شناسه نوع خلاق کاربر firstUserCm360CreativeTypeId CM360

  • کاربر firstUserCm360CreativeVersion خلاقاولین کاربر نسخه خلاق CM360

  • firstUserCm360Medium اولین کاربر CM360 medium

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

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

  • firstUserCm360PlacementName نام کاربری اول CM360 برای قرار دادن

  • شناسه رندر کاربر firstUserCm360RenderingId CM360

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

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

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

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

  • sessionCm360AccountId شناسه حساب session CM360

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

  • شناسه تبلیغ کننده sessionCm360AdvertiserId

  • sessionCm360AdvertiserName نام تبلیغ‌کنندهجلسه CM360

  • sessionCm360CampaignId کمپین session CM360

  • نام کمپین sessionCm360CampaignName نام کمپین Session CM360

  • قالب sessionCm360CreativeFormat قالب خلاقانه session CM360

  • sessionCm360CreativeId شناسه خلاق session CM360

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

  • sessionCm360CreativeType جلسه CM360 نوع خلاقانه

  • شناسه نوع sessionCm360CreativeTypeId شناسه نوع خلاق session CM360

  • sessionCm360CreativeVersion نسخه خلاقجلسه CM360 نسخه خلاق

  • sessionCm360Medium جلسه CM360 متوسط

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

  • sessionCm360PlacementId شناسه جایگذاری session CM360

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

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

  • شناسه sessionCm360SiteId شناسه سایت session CM360

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

  • sessionCm360Source منبع جلسه CM360

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

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

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

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

  • dv360CampaignId کمپین dv360

  • نام کمپین dv360CampaignName نام کمپین DV360

  • فرمت dv360CreativeFormat فرمت خلاقانه DV360

  • شناسه خلاق dv360CreativeId

  • dv360CreativeName نام خلاقانه DV360

  • شناسه صرافی dv360ExchangeId

  • نام صرافی dv360ExchangeName نام صرافی DV360

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

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

  • شناسه آیتم خطی dv360LineItemId

  • نام آیتم خطی dv360LineItemName

  • dv360Medium ۳۶۰ متوسط

  • dv360PartnerId شریک dv360

  • نام شریک dv360PartnerName نام شریک DV360

  • منبع dv360Source منبع DV360

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

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

  • firstUserDv360AdvertiserName نام اولین کاربر DV360 نام تبلیغ کننده

  • ID کمپین firstUserDv360CampaignId اولین کاربر DV360

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

  • firstUserDv360CreativeFormat اولین کاربر با فرمت خلاقانه DV360

  • firstUserDv360CreativeId اولین کاربر DV360 creative ID

  • firstUserDv360CreativeName خلاقاولین نام خلاق کاربر DV360

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

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

  • شناسه ترتیب درج کاربر firstUserDv360InsertionOrderId DV360

  • firstUserDv360InsertionOrderName نام اولین کاربر DV360 نام دستور درج

  • شناسه آیتم خط کاربر firstUserDv360LineItemId DV360

  • firstUserDv360LinteItemName نام آیتم خط DV360 کاربر اول

  • firstUserDv360Medium اولین کاربر DV360 medium

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

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

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

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

  • شناسه تبلیغ‌کننده sessionDv360AdvertiserId

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

  • شناسه کمپین sessionDv360CampaignId کمپین Session DV360

  • نام کمپین sessionDv360CampaignName نام کمپین Session DV360

  • sessionDv360CreativeFormat فرمت خلاقانه Session DV360

  • sessionDv360CreativeId شناسه خلاق Session DV360

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

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

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

  • شناسه ترتیب درج sessionDv360InsertionOrderId

  • sessionDv360InsertionOrderName نام ترتیب درج در جلسه DV360

  • شناسه خط آیتم sessionDv360LineItemId شناسه آیتم خط Session DV360

  • sessionDv360LineItemName نام آیتم خط جلسه DV360

  • sessionDv360Medium جلسه DV360 متوسط

  • sessionDv360PartnerId شناسه شریک Session DV360

  • sessionDv360PartnerName نام شریکنام شریک SessionDV360

  • منبع sessionDv360Source منبع session DV360

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

ابعاد ادغام تبلیغات جستجوی گوگل ۳۶۰ (SA360):

  • ID گروه آگهی firstUserSa360AdGroupId کاربر اول SA360

  • نام گروه تبلیغاتی کاربر firstUserSa360AdGroupName Sa360

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

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

  • firstUserSa360CreativeFormat اولین کاربر فرمت خلاقانه SA360

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

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

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

  • firstUserSa360KeywordText Sa360 متن کلمه کلیدی کاربر اول SA360

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

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

  • firstUserSa360Medium اولین کاربر SA360 medium

  • firstUserSa360Query کاربر SA360

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

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

  • شناسه گروه تبلیغاتی sa360AdGroupId شناسه گروه تبلیغاتی SA360

  • sa360CampaignId کمپین sa360

  • نام گروه تبلیغاتی sa360AdGroupName نام گروه تبلیغاتی SA360

  • sa360CampaignName کمپین SA360

  • قالب خلاقانه sa360CreativeFormat فرمت خلاقانه SA360

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

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

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

  • sa360KeywordText متن کلمه کلیدی SA360

  • sa360ManagerAccountId حساب مدیر SA360

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

  • sa360Medium SA360 متوسط

  • پرس و جو sa360Query پرس و جو SA360

  • منبع sa360Source منبع SA360

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

  • شناسه گروه تبلیغاتی sessionSa360AdGroupId شناسه گروه تبلیغاتی session SA360

  • sessionSa360CampaignId کمپین Session SA360

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

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

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

2024-03-06 پشتیبانی از مخاطبان غیرفعال کاربر در خروجی‌های مخاطبان.

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

2024-02-28 خروجی‌های مخاطب، شناسه کاربری مشخص شده در تگ‌گذاری را برمی‌گرداند.

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

2024-01-30 پشتیبانی از اعلان‌های وب‌هوک برای فهرست مخاطبان، فهرست مخاطبان دوره‌ای در رابط برنامه‌نویسی داده نسخه ۱ آلفا.

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

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

۲۰۲۴-۰۱-۱۸ سازگاری بهبود یافته برای ابعادی که شامل رشته پرس‌وجو یا جزء دقیقه هستند.

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

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

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

۲۰۲۳-۱۲-۱۳ پارامترهای سفارشی در محدوده آیتم

ابعاد سفارشیِ مبتنی بر آیتم، اکنون می‌توانند با استفاده از سینتکس زیر در کوئری‌های API داده‌های تحلیلی گنجانده شوند:

نام عمومی API توضیحات
مورد دلخواه: نام پارامتر ابعاد سفارشی با دامنه آیتم برای parameter_name

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

2023-12-05 فهرست مخاطبان در نسخه بتای Data API نسخه ۱ به عنوان Audience Exports در دسترس است.

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

متدهای زیر به Data API نسخه ۱ بتا اضافه شد:

2023-11-28 samplingMetadatas برای گزارش پاسخ اضافه شد

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

2023-11-28 قابلیت استخراج فهرست مخاطبان دوره‌ای به رابط برنامه‌نویسی داده نسخه ۱ آلفا اضافه شد

متدهای properties.recurringAudienceLists.create ، properties.recurringAudienceLists.create ، properties.recurringAudienceLists.list به رابط برنامه‌نویسی داده نسخه ۱ آلفا اضافه شد.

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

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

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

قوانین پیش‌فرض مرتب‌سازی AudienceList در تاریخ 2023-09-12

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

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

شناسه دستگاه isAdsPersonalizationAllowed
ای‌بی‌سی درست
مبدل دیجیتال به آنالوگ نادرست
ای‌بی‌سی نادرست
آآ درست

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

شناسه دستگاه isAdsPersonalizationAllowed
آآ درست
ای‌بی‌سی نادرست
ای‌بی‌سی درست
مبدل دیجیتال به آنالوگ نادرست

2023-08-15 بُعد isLimitedAdTracking به طرحواره خروجی فهرست مخاطبان اضافه شد.

  • isLimitedAdTracking تنظیمات محدودیت ردیابی تبلیغات دستگاه. مقادیر ممکن عبارتند از: true ، false و (not set) .

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

2023-08-15 ‎ بُعد currencyCode و معیار itemDiscountAmount اضافه شد.

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

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

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

۲۰۲۳-۰۸-۱۰ بُعد isAdsPersonalizationAllowed به طرحواره خروجی فهرست مخاطبان اضافه شد.

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

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

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

پشتیبانی از فهرست مخاطبان به نسخه آلفای رابط برنامه‌نویسی کاربردی داده (Data API) نسخه ۱ اضافه شد. فهرست مخاطبان شامل تصویری از کاربران حاضر در فهرست مخاطبان در زمان ایجاد فهرست مخاطبان است.

متدهای زیر به Data API نسخه ۱ آلفا اضافه شده‌اند:

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

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

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

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

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

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

خواص استاندارد

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

املاک آنالیتیکس ۳۶۰

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

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

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

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

  • سال ایزو isoYear سال ایزو. سال ایزوی رویداد. برای جزئیات، به 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 است.

2023-02-27 ابعاد تجارت الکترونیک اضافه شد.

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

  • itemLocationID شناسه مکان کالا. مکان فیزیکی مرتبط با کالا (مثلاً مکان فروشگاه فیزیکی). توصیه می‌شود از شناسه مکان گوگل (Google Place ID) که با کالای مرتبط مطابقت دارد استفاده شود. همچنین می‌توان از شناسه مکان سفارشی استفاده کرد. این فیلد در تگ‌گذاری توسط پارامتر 'location_id' در آرایه آیتم‌ها پر می‌شود.

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

۲۱-۰۲-۲۰۲۳ بُعد «صفحه فرود + رشته پرس‌وجو» اضافه شد.

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

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

2023-01-28 معیارهای «تعداد بازدیدها به ازای هر کاربر»، «تعداد کاربران اسکرول شده» اضافه شد.

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

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

۲۳-۰۱-۲۰۲۳ ابعاد «قاره» و «شناسه قاره» اضافه شد.

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

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

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

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

۲۰۲۲-۱۰-۱۸ معیارهای تبلیغات اضافه شد.

  • کلیک‌های advertiserAdClicks adclicks. تعداد کل دفعاتی که کاربران روی یک تبلیغ کلیک کرده‌اند تا به آن ملک برسند.
  • هزینه تبلیغات 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 از API داده حذف می‌شوند.

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

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

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

2022-08-03 ابعاد SA360 با محدوده جلسه اضافه شد.

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

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

  • sessionSa360CreativeFormat قالب خلاقانه جلسه SA360. نوع خلاقیت در تبلیغات جستجو ۳۶۰ که منجر به این جلسه شده است. به عنوان مثال، «تبلیغات جستجوی واکنش‌گرا» یا «تبلیغات متنی گسترش‌یافته».

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

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

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

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

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

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

  • منبع sessionSa360Source منبع جلسه SA360. منبع ترافیک از تبلیغات جستجو ۳۶۰ که به این جلسه منجر شده است. به عنوان مثال، 'example.com' یا 'google'.

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

۲۰۲۲-۰۷-۱۱ معیارهای نرخ تبدیل اضافه شد.

نرخ تبدیل

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

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

معیارهای نرخ تبدیل برای یک تبدیل

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

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

2022-05-05 قابلیت گزارش‌دهی Funnel به کانال آلفا اضافه شد.

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

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

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

اصطلاح و محتوای دفترچه راهنما

  • 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 DAU / MAU. درصد کاربران فعال ۳۰ روزه که کاربران فعال ۱ روزه نیز هستند.

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

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

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

  • transactionsPerPurchaser به ازای هر خریدار.

کمپین تبلیغات گوگل

  • firstUserGoogleAdsCampaignType نوع کمپین کمپین گوگل ادز که برای اولین بار کاربر را جذب کرده است.

  • نوع کمپین گوگل ادز googleAdsCampaignType نوع کمپین برای کمپین گوگل ادز که به رویداد تبدیل نسبت داده می‌شود.

  • sessionGoogleAdsCampaignType نوع کمپین برای کمپین تبلیغات گوگل که منجر به این جلسه شده است.

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

  • dateHourMinute مقادیر ترکیبی تاریخ، ساعت و دقیقه که به صورت YYYYMMDDHHMM فرمت‌بندی شده‌اند.

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

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

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

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

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

  • fileExtension فایل دانلود شده.

  • fileName مسیر صفحه فایل دانلود شده.

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

  • linkClasses ویژگی کلاس HTML برای یک لینک خروجی.

  • linkDomain دامنه‌ی مقصد لینک خروجی.

  • linkId ویژگی شناسه HTML برای یک لینک خروجی یا دانلود فایل.

  • linkText متن لینک دانلود فایل.

  • linkUrl آدرس کامل یک لینک خروجی یا دانلود فایل.

  • method ) روشی که یک رویداد توسط آن فعال شده است.

  • outbound اگر لینک به سایتی منتهی شود که جزئی از دامنه‌ی آن ملک نباشد، مقدار «true» را برمی‌گرداند.

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

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

  • percentScrolled درصد پیمایش کاربر به پایین صفحه (برای مثال، '90').

  • searchTerm The term searched by the user.

  • videoProvider The source of the video (for example, 'youtube').

  • videoTitle The title of the video.

  • videoUrl The url of the video.

  • visible Returns 'true' if the content is visible.

  • unifiedPagePathScreen The page path (web) or screen class (app) on which the event was logged.

2021-09-07 API schema changes.

Changes in existing dimensions:

  • unifiedPageScreen For web generated events, this dimension now returns the page path and query string on which the event was logged.

Upcoming changes announcement:

  • firstUserTrafficOrigin The traffic origin that first acquired the user. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • sessionTrafficOrigin The traffic origin of the session's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

  • trafficOrigin The traffic origin of the conversion event's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch.

2021-09-07 checkCompatibility method added to the API.

checkCompatibility method lists dimensions and metrics that can be added to a report request and maintain compatibility.

2021-07-21 Realtime reporting changes.

It is now possible to specify the minute ranges of event data to read using the minuteRanges parameter of the runRealtimeReport method.

2021-07-21 New channel grouping dimensions.

New channel grouping dimensions added to the Data API reporting schema :

  • firstUserDefaultChannelGrouping First user default channel grouping.

  • defaultChannelGrouping Default channel grouping.

2021-06-10 API schema changes.

  • minutesAgo dimension added to the Data API realtime schema and can be used in queries to the runRealtimeReport method. This dimension contains the number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.

  • googleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative attributed to the conversion event.

  • sessionGoogleAdsCreativeId dimension added to the Data API schema. This dimension contains the ID of the Google Ads creative that lead to a session on your website or app.

  • firstUserCreativeId dimension renamed to firstUserGoogleAdsCreativeId in the Data API schema. This dimension contains the ID of the Google Ads creative that first acquired the user.

2021-04-09 The Google Analytics Data API v1 beta has been released.

  • The API endpoint updated to https://analyticsdata.googleapis.com/v1beta .

  • runReport , runPivotReport , batchRunReports , batchRunPivotReports methods now accept the id of a Google Analytics 4 property in the property parameter of the URL path instead of the entity field of a request body:

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

  • API client libraries have been updated to use the new API endpoint.

2021-02-19 Pagination changes.

  • The default report response size increased from 10 to 10,000 rows of event data.

  • "limit" : -1 value that was used to indicate an attempt to retrieve all rows is no longer supported in RunReportRequest .

  • The maximum value of the limit field is set to 100000 . Use pagination to retrieve reports containing more than 100,000 rows.

2021-02-08 New e-commerce dimensions and metrics.

New e-commerce dimensions and metrics have been added to the API schema :

Dimensions: adFormat , adSourceName , adUnitName , itemBrand , itemCategory , itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 itemId , itemListId , itemListName , itemName , itemPromotionCreativeName , itemPromotionId , itemPromotionName , orderCoupon , transactionId .

Metrics: adUnitExposure , addToCarts , cartToViewRate , checkouts , ecommercePurchases , firstTimePurchasers , itemListClickThroughRate , itemListClicks , itemListViews , itemPromotionClickThroughRate , itemPromotionClicks , itemPromotionViews , itemPurchaseQuantity , itemRevenue , itemViews , publisherAdClicks , publisherAdImpressions , totalPurchasers .

2021-02-08 Added new campaign dimensions.

New campaign dimensions have been added to the API schema : campaignId , campaignName , googleAdsAccountName , googleAdsAdGroupId , googleAdsAdGroupName , googleAdsAdNetworkType , source , trafficOrigin

2021-02-08 dayOfWeek , week dimension changes.

  • The value of dayOfWeek dimension now starts with 0 instead of 1.

  • The value of week dimension now starts with 01 and returns a two-digit number from 01 to 53. Each week starts on Sunday. January 1st is always in week 01.

2021-01-28 Added aggregation variants for custom metrics.

Each custom metric that a property registers creates three API metric variants : a sum, an average, and a count.

2021-01-28 Added new Date/time dimensions.

The following new dimensions have been added to the API schema : hour , nthHour , nthYear , dateHour .

2021-01-28 The Data API reduced the quota tokens charged per query.

The Data API reduced the quota tokens charged per query. The quota limits for property quota tokens per hour and per day were not changed.

2020-11-09 The method getUniversalMetadata has been deleted.

The method getUniversalMetadata has been deleted. Please use getMetadata . The one year maximum date range per API request has been removed.

2020-11-02 Added a Realtime Reporting Method.

See the Creating a Realtime Report for examples and runRealtimeReport for the REST reference documentation.

2020-10-19 Client library artifacts updated.

Client library artifacts updated along with usage instructions and code samples.

2020-10-13 App + Web properties have been renamed to Google Analytics 4 (GA4).

2020-10-08 getMetadata method added to the API.

getMetadata method returns Custom dimensions and metrics available for the specified GA4 property ID, as well as Universal metadata.

2020-10-08 Custom dimensions and metrics are available in reports.

See the API schema documentation for documentation on custom dimensions and metrics. This update includes Event-scoped Custom Dimensions and metrics as well as User-scoped Custom Dimensions.