تغییرات

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

2024-10-20 نوع فیلتر ابعاد EmptyFilter اضافه شد

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

2024-10-15 ویژگی سطح نمونه برداری به روش reportTasks اضافه شد

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

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

18/09/2024 ویژگی Snapshot سهمیه املاک اضافه شد

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

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

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

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

2024-05-14 ویژگی مقایسه اضافه شد

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

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

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

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

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

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

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

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

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

2024-05-06 ابعاد جدید برای رویدادهای کلیدی

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

درخواست های گزارش خود را که از بعد 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 تبدیل منسوخ شده است.

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

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

ابعاد مخاطب:

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

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

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

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

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

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

  • manualCampaignId شناسه کمپین دستی

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

  • manualCreativeFormat فرمت خلاقانه دستی

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

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

  • manualSource منبع کتابچه راهنمای کاربر

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

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

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

  • firstUserManualCampaignName اولین دفترچه راهنمای کاربر نام کمپین

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

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

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

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

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

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

  • ID کمپین دستی sessionManualCampaignId

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

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

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

  • sessionManualMedium رسانه کتابچه راهنمای جلسه

  • منبع کتابچه راهنمای جلسه 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 متوسط

  • 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 نوع خلاق

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

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

  • firstUserCm360Medium کاربر اول CM360 متوسط

  • firstUserCm360PlacementCostStructure کاربر اول ساختار هزینه قرار دادن CM360

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

  • firstUserCm360PlacementName نام مکان کاربر اول CM360

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

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

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

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

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

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

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

  • sessionCm360AdvertiserId Session CM360 Advertiser ID

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

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

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

  • sessionCm360CreativeFormat فرمت خلاق جلسه CM360

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

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

  • sessionCm360CreativeType Session CM360 نوع خلاق

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

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

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

  • sessionCm360PlacementCostStructure ساختار هزینه قرار دادن جلسه CM360

  • sessionCm360PlacementId Session CM360 placement ID

  • sessionCm360PlacementName نام محل جلسه CM360

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

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

  • sessionCm360SiteName نام سایت Session 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

  • dv360PartnerName نام شریک DV360

  • منبع dv360Source DV360

  • dv360SourceMedium منبع DV360 / متوسط

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

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

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

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

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

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

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

  • ID تبادل firstUserDv360ExchangeId اولین کاربر DV360

  • firstUserDv360ExchangeName نام تبادل کاربر اول DV360

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

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

  • ID مورد خط firstUserDv360LineItemId کاربر اول DV360

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

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

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

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

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

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

  • شناسه آگهی دهنده sessionDv360AdvertiserId Session DV360

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

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

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

  • sessionDv360CreativeFormat فرمت خلاق جلسه DV360

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

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

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

  • sessionDv360ExchangeName نام تبادل Session DV360

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

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

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

  • sessionDv360LineItemName نام مورد خط جلسه DV360

  • sessionDv360Medium Session DV360 media

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

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

  • sessionDv360Source منبع جلسه DV360

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

ابعاد یکپارچه سازی Google Search Ads 360 (SA360):

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

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

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

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

  • firstUserSa360CreativeFormat کاربر اول SA360 قالب خلاق

  • ID حساب موتور firstUserSa360EngineAccountId کاربر اول SA360

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

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

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

  • ID حساب مدیر 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 Session SA360

  • شناسه کمپین sessionSa360CampaignId Session SA360

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

  • sessionSa360ManagerAccountName نام حساب مدیر Session SA360

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

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

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

2024-02-28 Audience Exports شناسه کاربری مشخص شده در برچسب گذاری را برمی گرداند.

Audience Exports اکنون شناسه کاربری مشخص شده در برچسب‌گذاری را برمی‌گرداند حتی اگر داده‌های ارائه‌شده توسط کاربر برای دارایی شما روشن باشد. اگر جمع‌آوری داده‌های ارائه‌شده توسط کاربر روشن باشد، داده‌های ارائه‌شده توسط کاربر به همراه User-ID می‌توانند برای بهبود اندازه‌گیری به Google Analytics در برچسب‌گذاری ارسال شوند. برای کسب اطلاعات بیشتر، به جمع آوری داده های ارائه شده توسط کاربر مراجعه کنید.

30/01/2024 اعلان‌های Webhook از فهرست‌های مخاطب، فهرست‌های مخاطب تکراری در Data API v1 alpha پشتیبانی می‌کند.

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

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

18/01/2024 سازگاری بهبود یافته برای ابعادی که شامل رشته پرس و جو یا جزء دقیقه است.

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

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

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

2023-12-13 پارامترهای محدوده مورد سفارشی

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

نام API عمومی توضیحات
customItem:parameter_name ابعاد سفارشی با محدوده مورد برای parameter_name

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

05/12/2023 فهرست‌های مخاطب در نسخه بتای Data API v1 به عنوان صادرات مخاطب در دسترس هستند

ویژگی Audience Lists به Audience Exports تغییر نام داده و به Data API v1 beta اضافه شده است.

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

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

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

28/11/2023 قابلیت صادرات تکرارشونده فهرست مخاطبان به Data API v1 alpha اضافه شد

properties.recurringAudienceLists.create Data API v1 alpha properties.recurringAudienceLists.create properties.recurringAudienceLists.list .

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

08-11-2023 افزوده شد صادرات فهرست مخاطبان به عملکرد برگه‌ها به Data API v1 alpha

متد properties.audienceLists.exportSheet را به Data API v1 alpha اضافه کرد که به شما امکان می‌دهد فهرست مخاطبان را به Google Sheets صادر کنید.

2023-10-13 پشتیبانی اضافه شده برای مخاطبین با مدت زمان عضویت 1 روز

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

12/09/2023 قوانین سفارش پیش‌فرض AudienceList

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

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

شناسه دستگاه isAdsPersonalizationAllowed
ABC درست است
DAC نادرست
ABC نادرست
AAA درست است

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

شناسه دستگاه isAdsPersonalizationAllowed
AAA درست است
ABC نادرست
ABC درست است
DAC نادرست

15/08/2023 بعد isLimitedAdTracking به طرح صادرات فهرست مخاطب اضافه شد

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

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

15/08/2023 currencyCode اضافه شد کد، اندازه‌گیری itemDiscountAmount

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

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

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

2023-08-10 بعد isAdsPersonalizationAllowed به طرح صادرات فهرست مخاطب اضافه شد

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

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

2023-07-10 لیست مخاطبان

پشتیبانی از Audience Lists به Data API v1 alpha اضافه شده است. فهرست مخاطبان شامل یک عکس فوری از کاربران مخاطب در زمان ایجاد فهرست مخاطبان است.

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

2023-05-19 گروه های کانال سفارشی

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

2023-05-11 تغییرات سهمیه توکن ها.

سیستم سهمیه بندی Data API به روز شده است تا هزینه های دقیق تری را ارائه دهد.

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

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

ویژگی های استاندارد

نام سهمیه حد قدیمی محدودیت جدید
توکن های اصلی در هر ملک در روز 25000 200000
توکن های اصلی در هر ملک در ساعت 5000 40000
توکن های اصلی در هر پروژه در هر ملک در ساعت 1750 14000
توکن های بیدرنگ در هر ملک در روز 25000 200000
توکن های بیدرنگ در هر ملک در ساعت 5000 40000
توکن های بیدرنگ در هر پروژه در هر ملک در ساعت 1750 14000
قیف توکن در هر ملک در روز 25000 200000
قیف توکن در هر ملک در ساعت 5000 40000
توکن های قیف در هر پروژه در هر ملک در ساعت 1750 14000

ویژگی های Analytics 360

نام سهمیه حد قدیمی محدودیت جدید
توکن های اصلی در هر ملک در روز 250000 2,000,000
توکن های اصلی در هر ملک در ساعت 50000 400000
توکن های اصلی در هر پروژه در هر ملک در ساعت 17500 140000
توکن های بیدرنگ در هر ملک در روز 250000 2,000,000
توکن های بیدرنگ در هر ملک در ساعت 50000 400000
توکن های بیدرنگ در هر پروژه در هر ملک در ساعت 17500 140000
قیف توکن در هر ملک در روز 250000 2,000,000
قیف توکن در هر ملک در ساعت 50000 400000
توکن های قیف در هر پروژه در هر ملک در ساعت 17500 140000

02/03/2023 ابعاد تاریخ اضافه شد.

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

  • isoWeek هفته ISO سال. شماره هفته 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 هفته ISO سال ISO. مقادیر ترکیبی isoWeek و isoYear . مقادیر مثال شامل 201652 و 201701 است.

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

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

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

  • itemListPosition موقعیت فهرست آیتم ها. موقعیت یک آیتم (به عنوان مثال، محصولی که می فروشید) در یک لیست. این بعد در برچسب گذاری با پارامتر "شاخص" در آرایه آیتم ها پر می شود.

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

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

21/02/2023 بعد «صفحه مقصد + رشته جستجو» اضافه شد.

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

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

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

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

  • scrolledUsers کاربران اسکرول شده. تعداد کاربران منحصر به فردی که حداقل 90٪ صفحه را به پایین اسکرول کرده اند.

2023-01-23 ابعاد «قاره»، «شناسه قاره» اضافه شد.

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

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

23/01/2023 بعد «شناسه فیلتر داده‌های آزمایشی» اضافه شد.

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

2022-10-18 معیارهای تبلیغات اضافه شد.

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

2022-10-17 معیارهای محدوده مورد اضافه شد.

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

2022-09-13 اطلاعیه تغییرات سازگاری طرحواره.

در 1 دسامبر 2022 ، تغییرات شکسته زیر رخ خواهد داد:

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

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

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

برای کسب اطلاعات بیشتر، توضیح مفصل تغییرات سازگاری را ببینید.

2022-09-01 تغییرات سهمیه.

  • سهمیه‌های 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 مصرف می کند.

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

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

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

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

  • فرمت خلاق sessionSa360CreativeFormat Session SA360. نوع خلاقیت در Search Ads 360 که منجر به این جلسه شد. به عنوان مثال، "تبلیغ جستجوی پاسخگو" یا "تبلیغ متنی گسترده".

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

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

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

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

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

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

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

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

11-07-2022 معیارهای نرخ تبدیل اضافه شد.

نرخ تبدیل

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

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

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

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

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

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

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

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

2022-02-16 ابعاد جدید اضافه شد.

اصطلاح و محتوا

  • 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. درصد چرخشی کاربران فعال 30 روزه که کاربران فعال 1 روزه نیز هستند.

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

  • wauPerMau WAU / MAU. درصد چرخشی کاربران فعال 30 روزه که کاربران فعال 7 روزه نیز هستند.

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

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

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

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

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

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

07-09-2021 ابعاد جدید تاریخ/زمان اضافه شد.

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

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

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

07/09/2021 ابعاد جدیدی با پارامترهای رویداد اضافه شد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • percentScrolled درصد پایین صفحه ای که کاربر پیمایش کرده است (به عنوان مثال ، 90 ").

  • searchTerm اصطلاح جستجو شده توسط کاربر.

  • videoProvider منبع ویدیو (به عنوان مثال ، "YouTube").

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

  • URL ویدیو را videoUrl .

  • اگر محتوای قابل مشاهده باشد ، "واقعی" باز می visible .

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

2021-09-07 Schema API تغییر می کند.

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

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

اعلام تغییرات آینده:

  • firstUserTrafficOrigin منشأ ترافیکی که ابتدا کاربر را به دست آورد. لطفاً به این زمینه "کتابچه راهنمای" برای ترافیک که از UTMS استفاده می کند ، وابسته نباشید. این قسمت از بازگشت "کتابچه راهنمای کاربر" به بازگشت "(تنظیم نشده) برای یک ویژگی آینده به روز می شود.

  • sessionTrafficOrigin منشأ ترافیک کمپین جلسه. لطفاً به این زمینه "کتابچه راهنمای" برای ترافیک که از UTMS استفاده می کند ، وابسته نباشید. این قسمت از بازگشت "کتابچه راهنمای کاربر" به بازگشت "(تنظیم نشده) برای یک ویژگی آینده به روز می شود.

  • trafficOrigin منشأ ترافیک کمپین رویداد تبدیل. لطفاً به این زمینه "کتابچه راهنمای" برای ترافیک که از UTMS استفاده می کند ، وابسته نباشید. این قسمت از بازگشت "کتابچه راهنمای کاربر" به بازگشت "(تنظیم نشده) برای یک ویژگی آینده به روز می شود.

2021-09-07 روش checkCompatibility به API اضافه شد.

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

2021-07-21 تغییرات گزارش زمان واقعی.

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

ابعاد گروه بندی کانال جدید 2021-07-21 .

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

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

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

2021-06-10 API Schema تغییر می کند.

  • minutesAgo DIMENSION به DATA API REALTIME اضافه شده و می تواند در نمایش داده شد به روش runRealtimeReport استفاده شود. این بعد شامل تعداد دقایقی پیش است که یک رویداد جمع آوری شده است. 00 دقیقه فعلی است و 01 به معنی دقیقه قبلی است.

  • ابعاد googleAdsCreativeId به طرح API داده اضافه شده است. این بعد شامل شناسه Google Ads Creative که به رویداد تبدیل نسبت داده شده است.

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

  • ابعاد firstUserCreativeId به firstUserGoogleAdsCreativeId در طرح API داده تغییر نام داد. این بعد شامل شناسه Creative Google Ads Creative است که ابتدا کاربر را به دست آورد.

2021-04-09 Data Analytics Data API V1 Beta منتشر شده است.

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

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

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

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

تغییرات صفحه بندی 2021-02-19 .

  • اندازه پاسخ گزارش پیش فرض از 10 به 10،000 ردیف داده های رویداد افزایش یافته است.

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

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

2021-02-08 ابعاد و معیارهای جدید تجارت الکترونیکی.

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

ابعاد: 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

2021-02-08 ابعاد جدید کمپین اضافه کرد.

ابعاد جدید مبارزات انتخاباتی به برنامه API اضافه شده است: campaignId ، campaignName ، googleAdsAccountName ، googleAdsAdGroupId ، googleAdsAdGroupName ، googleAdsAdNetworkType ، source ، trafficOrigin

2021-02-08 dayOfWeek ، ابعاد week تغییر می کند.

  • مقدار بعد dayOfWeek اکنون به جای 1 با 0 شروع می شود.

  • ارزش بعد week اکنون با 01 شروع می شود و یک شماره دو رقمی را از 01 به 53 برمی گرداند. هر هفته یکشنبه آغاز می شود. اول ژانویه همیشه در هفته 01 است.

2021-01-28 انواع تجمع اضافه شده برای معیارهای سفارشی.

هر متریک سفارشی که یک ملک ثبت نام می کند ، سه نوع متریک API ایجاد می کند: یک مبلغ ، متوسط ​​و تعداد.

2021-01-28 ابعاد تاریخ/زمان جدید اضافه شده است.

ابعاد جدید زیر به طرح API اضافه شده است: hour ، nthHour ، nthYear ، dateHour .

2021-01-28 API داده ها نشانه های سهمیه ای را برای هر پرس و جو کاهش می دهد.

API داده ها نشانه های سهمیه ای را که در هر پرس و جو شارژ می شوند ، کاهش می دهد. محدودیت سهمیه برای نشانه های سهمیه املاک در ساعت و در روز تغییر نمی کرد.

2020-11-09 روش getUniversalMetadata حذف شده است.

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

2020-11-02 یک روش گزارش واقعی را اضافه کرد.

برای ایجاد یک گزارش RealTime برای مثال و RunRealTimeReport برای مستندات مرجع REST مراجعه کنید.

2020-10-19 آثار باستانی کتابخانه مشتری به روز شده است.

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

2020-10-13 برنامه + ویژگی های وب به Google Analytics 4 (GA4) تغییر نام داده اند.

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

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

ابعاد و معیارهای سفارشی 2020-10-08 در گزارش ها موجود است.

برای مستندات در مورد ابعاد و معیارهای سفارشی ، مستندات Schema API را مشاهده کنید. این بروزرسانی شامل ابعاد و معیارهای سفارشی با رویداد و همچنین ابعاد سفارشی با کاربر است.

،

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

2024-10-20 نوع فیلتر ابعاد EmptyFilter اضافه کرد

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

2024-10-15 ویژگی سطح نمونه گیری اضافه شده به روش reportTasks

با استفاده از زمینه Sampleinglevel Properties.RunreportTask می توانید سطح نمونه گیری گزارش را کنترل کنید.

این ویژگی به Google Analytics 360 امکان دسترسی به محدودیت های نمونه برداری بالاتر از 1 میلیارد رویداد را می دهد. همچنین ، محدودیت های نمونه برداری را می توان برای نتایج غیرمجاز شمارش فراوان UNSAMPLED برد.

2024-09-18 ویژگی عکس فوری سهمیه املاک اضافه شده است

با استفاده از روش Properties.getPropertyquotassnapshot ، می توانید یک عکس فوری از کلیه سهمیه های املاک که توسط دسته سهمیه برای یک خاصیت خاص سازماندهی شده است ، دریافت کنید.

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

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

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

2024-05-14 ویژگی مقایسه اضافه شده

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

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

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

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

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

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

2024-05-08 کارهای گزارش اضافه شده ، یک ویژگی گزارش ناهمزمان ، به API V1alpha داده.

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

گزارش زیر روشهای دستکاری کار به داده های API V1alpha اضافه شده است:

2024-05-06 ابعاد جدید برای رویدادهای کلیدی

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

درخواست های گزارش خود را که از ابعاد 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 ابعاد خاص ادغام اضافه شده به طرح API داده.

ابعاد مخاطب:

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

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

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

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

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

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

  • manualCampaignId Manual Campaign

  • manualCampaignName نام کمپین

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

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

  • دستی manualMedium

  • منبع دستی manualSource

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

  • manualSourcePlatform بستر منبع دستی

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

  • firstUserManualCampaignName نام اولین کارزار کاربر کاربر

  • firstUserManualCreativeFormat First First Format Creative Manual Creative

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

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

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

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

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

  • شناسه کمپین جلسه راهنمای جلسه sessionManualCampaignId

  • sessionManualCampaignName نام کمپین کتابچه راهنمای جلسه

  • sessionManualCreativeFormat Session Manual Formate Creative

  • sessionManualMarketingTactic MANUAL MANUALETINGTACTICTACT

  • sessionManualMedium Manual Medium

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

  • sessionManualSourceMedium Session Manual Source / Medium

  • sessionManualSourcePlatform Session Manual Source Platform

مدیر کمپین 360 (CM360) ابعاد ادغام:

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

  • نام حساب cm360AccountName CM360

  • cm360AdvertiserId CM360 Advertiser ID

  • نام تبلیغات cm360AdvertiserName CM360

  • شناسه کمپین cm360CampaignId CM360

  • نام کمپین cm360CampaignName CM360

  • cm360CreativeFormat CM360 قالب خلاق

  • cm360CreativeId CM360 شناسه خلاق

  • نام خلاق cm360CreativeName CM360

  • cm360CreativeType CM360 نوع خلاق

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

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

  • cm360Medium cm360 متوسط

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

  • شناسه قرارگیری cm360PlacementId CM360

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

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

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

  • نام سایت cm360SiteName cm360

  • منبع cm360Source CM360

  • cm360SourceMedium CM360 منبع / متوسط

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

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

  • firstUserCm360AdvertiserId اولین کاربر CM360 Advertiser ID

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

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

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

  • firstUserCm360CreativeFormat اولین کاربر CM360 Format Creative

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

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

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

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

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

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

  • firstUserCm360PlacementCostStructure اولین کاربر CM360 ساختار هزینه قرار دادن ساختار

  • firstUserCm360PlacementId -plactionId اولین کاربر CM360 شناسه قرار دادن

  • firstUserCm360PlacementName نام کاربر CM360 نام قرار دادن نام

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

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

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

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

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

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

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

  • sessionCm360AdvertiserId Session CM360 Advertiser ID

  • sessionCm360AdvertiserName SESSION CM360 نام تبلیغات

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

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

  • sessionCm360CreativeFormat Session CM360 قالب خلاق

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

  • sessionCm360CreativeName Session CM360 نام خلاق

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

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

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

  • sessionCm360Medium Session CM360 متوسط

  • جلسه sessionCm360PlacementCostStructure CM360 ساختار هزینه قرار دادن

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

  • sessionCm360PlacementName SESSION CM360 نام قرارگیری

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

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

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

  • sessionCm360Source Session CM360 منبع

  • sessionCm360SourceMedium جلسه CM360 منبع / متوسط

Display & Video 360 (DV360) ابعاد ادغام:

  • dv360AdvertiserId DV360 ADMADISIER ID

  • نام تبلیغات 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

  • نام شریک dv360PartnerName DV360

  • منبع dv360Source DV360

  • dv360SourceMedium DV360 منبع / متوسط

  • firstUserDv360AdvertiserId اولین کاربر DV360 Advertiser ID

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

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

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

  • firstUserDv360CreativeFormat اولین کاربر DV360 Format Creative

  • firstUserDv360CreativeId اولین کاربر DV360 شناسه خلاق

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

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

  • firstUserDv360ExchangeName اولین کاربر DV360 نام تبادل

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

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

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

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

  • firstUserDv360Medium اولین کاربر DV360 متوسط

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

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

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

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

  • sessionDv360AdvertiserId Session DV360 Advertiser ID

  • sessionDv360AdvertiserName SESSION DV360 نام تبلیغات

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

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

  • sessionDv360CreativeFormat Session DV360 قالب خلاق

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

  • sessionDv360CreativeName Session DV360 نام خلاق

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

  • sessionDv360ExchangeName Session DV360 نام تبادل

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

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

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

  • sessionDv360LineItemName Session DV360 نام خط نام

  • sessionDv360Medium Session DV360 متوسط

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

  • sessionDv360PartnerName Session DV360 نام شریک زندگی

  • sessionDv360Source Session DV360 منبع

  • sessionDv360SourceMedium Session DV360 منبع / متوسط

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

  • firstUserSa360AdGroupId اولین کاربر SA360 AD GROUP ID

  • 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 SA360 FirstERSASA360SOURCE

  • 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 SESSION SA360 AD GROUP ID

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

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

  • sessionSa360ManagerAccountName Session SA360 نام حساب مدیر

  • sessionSa360SourceMedium Session SA360 منبع / متوسط

2024-03-06 مخاطبان کاربر غیرفعال پشتیبانی در صادرات مخاطبان.

ویژگی صادرات مخاطب بهتر از صادر کردن مخاطبان کاربر غیرفعال پشتیبانی می کند. کاربران بدون یک رویداد واجد شرایط ، این مخاطبان را وارد می کنند. به عنوان مثال ، کاربر می تواند با مراجعه به وب سایت شما به مدت هفت روز به مخاطب وارد مخاطب شود. نمونه هایی از مخاطبان کاربر غیرفعال شامل "خریداران 7 روزه غیرفعال" ، "کاربران 7 روزه غیرفعال" و "کاربران 7 روزه بدون نام" است. برای کسب اطلاعات بیشتر در مورد مخاطبان پیشنهادی ، به مخاطبان پیشنهادی مراجعه کنید.

2024-02-28 صادرات مخاطبان شناسه کاربر مشخص شده در برچسب زدن را برمی گردانند.

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

اعلان های وب سایت 2024-01-30 پشتیبانی از لیست مخاطبان ، لیست مخاطبان را در API V1 ALPHA DATA تکرار می کند.

AudienceList.webhookNotification and RecurringAudienceList.webhookNotification می تواند هنگام ایجاد لیست مخاطبان (با استفاده از Properties.AudiEncelists.Create ) یا لیست مخاطبان تکرار شده (با استفاده از Properties.RecurringAudiEncelists.Create ) مشخص شود.

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

2024-01-18 سازگاری بهبود یافته برای ابعادی که شامل رشته پرس و جو یا مؤلفه دقیقه است.

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

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

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

2023-12-13 پارامترهای سفارشی مورد

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

نام API عمومی توضیحات
CustomItem: parameter_name ابعاد سفارشی موردی برای پارامتر_NAME

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

2023-12-05 لیست مخاطبان در داده های API V1 Beta به عنوان صادرات مخاطبان در دسترس هستند

ویژگی لیست مخاطبان به صادرات مخاطبان تغییر نام داده و به Data API V1 BETA اضافه شده است.

روشهای زیر را به API V1 BETA اضافه کرد:

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

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

2023-11-28 لیست مخاطبان مکرر عملکرد صادرات به داده API V1 Alpha اضافه شده است

properties.recurringAudienceLists.create ، properties.recurringAudienceLists.create ، properties.recurringAudienceLists.list روش های API V1 Alpha.

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

2023-11-08 لیست مخاطبان اضافه شده صادرات به ورق ها به داده های API V1 Alpha

روش properties.audienceLists.exportSheet را به داده API V1 Alpha اضافه کرد که به شما امکان می دهد لیست مخاطبان را به برگه های Google صادر کنید.

2023-10-13 پشتیبانی از مخاطبان با مدت عضویت 1 روز اضافه شد

مخاطبان با مدت عضویت 1 روز اکنون توسط لیست مخاطبان عملکرد صادرات پشتیبانی می شوند.

2023-09-12 AudiEncelist قوانین پیش فرض سفارش

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

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

شناسه دستگاه isadspersonalization
ABC درست است
DAC نادرست
ABC نادرست
AAA درست است

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

شناسه دستگاه isadspersonalization
AAA درست است
ABC نادرست
ABC درست است
DAC نادرست

2023-08-15 اضافه شده ابعاد isLimitedAdTracking به شمای صادرات لیست مخاطبان

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

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

2023-08-15 ابعاد اضافه شده currencyCode ، Metric itemDiscountAmount

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

  • itemDiscountAmount ارزش پولی تخفیف های مورد در رویدادهای تجارت الکترونیک. این متریک در برچسب زدن توسط پارامتر مورد "تخفیف" جمع شده است.

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

2023-08-10 اضافه شده isAdsPersonalizationAllowed SOLUENT SCHEMA EXPORT

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

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

لیست مخاطبان 2023-07-10

لیست مخاطبان پشتیبانی اضافه شده به API V1 Alpha داده شده است. لیست مخاطبان شامل عکس فوری از کاربران در مخاطب در زمان ایجاد لیست مخاطبان است.

روشهای زیر به API V1 ALPHA اضافه شده است:

گروه های کانال سفارشی 2023-05-19

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

2023-05-11 سهمیه توکن تغییر می کند.

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

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

پس از این تغییر ، در حالی که هزینه برخی از درخواست ها یکسان خواهد بود ، افزایش قابل توجه در هزینه ها برای سؤالات پیچیده تر وجود خواهد داشت. به عنوان مثال ، درخواست های بیش از 6 ماه داده می تواند 1000 یا بیشتر نشانه سهمیه را شارژ کند.

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

نام سهمیه حد قدیمی حد جدید
نشانه های اصلی در هر ملک در روز 25000 200000
نشانه های اصلی در هر ساعت در ساعت 5000 40000
نشانه های اصلی در هر پروژه در هر ساعت 1750 14000
در هر روز توکن در زمان واقعی 25000 200000
نشانه های زمان واقعی در هر ملک در هر ساعت 5000 40000
نشانه های زمان واقعی در هر پروژه در هر ساعت 1750 14000
نشانه های قیف در هر ملک در روز 25000 200000
نشانه های قیف در هر ملک در ساعت 5000 40000
نشانه های قیف در هر پروژه در هر ساعت 1750 14000

Analytics 360 ویژگی

نام سهمیه حد قدیمی حد جدید
نشانه های اصلی در هر ملک در روز 250000 2,000,000
نشانه های اصلی در هر ساعت در ساعت 50000 400000
نشانه های اصلی در هر پروژه در هر ساعت 17500 140000
در هر روز توکن در زمان واقعی 250000 2,000,000
نشانه های زمان واقعی در هر ملک در هر ساعت 50000 400000
نشانه های زمان واقعی در هر پروژه در هر ساعت 17500 140000
نشانه های قیف در هر ملک در روز 250000 2,000,000
نشانه های قیف در هر ملک در ساعت 50000 400000
نشانه های قیف در هر پروژه در هر ساعت 17500 140000

2023-03-02 ابعاد تاریخ اضافه شده.

  • dayOfWeekName Day of Week. روز هفته به زبان انگلیسی. این بعد دارای ارزش های Sunday ، Monday و غیره است.

  • isoWeek ISO هفته سال. شماره هفته 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 ISO سال ISO. مقادیر ترکیبی isoWeek و isoYear . مقادیر مثال شامل 201652 و 201701 است.

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

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

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

  • موقعیت لیست موارد itemListPosition . موقعیت یک مورد (به عنوان مثال ، محصولی که می فروشید) در یک لیست. این بعد در برچسب زدن توسط پارامتر "فهرست" در آرایه موارد جمع شده است.

  • شناسه مکان مورد itemLocationID . موقعیت فیزیکی مرتبط با مورد (به عنوان مثال محل فروشگاه فیزیکی). توصیه می شود از شناسه Google Place که مطابق با مورد مرتبط است استفاده کنید. همچنین می توان از شناسه موقعیت مکانی سفارشی استفاده کرد. این قسمت در برچسب زدن توسط پارامتر "socation_id" در آرایه موارد جمع شده است.

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

2023-02-21 اضافه شده "صفحه فرود + رشته query string".

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

این زمینه جایگزین ابعاد landingPage است که مستهلک می شود و به روز می شود تا یک رشته پرس و جو را در 14 مه 2023 برنگردد.

2023-01-28 اضافه شده "نمای در هر کاربر" ، "معیارهای کاربران پیمایش شده".

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

  • scrolledUsers کاربران را پیمایش کرد. تعداد کاربران منحصر به فرد که حداقل 90 ٪ از صفحه را پایین آورده اند.

ابعاد 2023-01-23 اضافه شده "قاره" ، "شناسه قاره".

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

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

2023-01-23 ابعاد "آزمون فیلتر داده" اضافه شده است.

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

2022-10-18 معیارهای تبلیغاتی اضافه شده است.

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

2022-10-17 معیارهای مورد نظر اضافه شده است.

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

2022-09-13 اعلامیه سازگاری شمای.

در اول دسامبر سال 2022 ، تغییرات شکستن زیر رخ خواهد داد:

  1. ابعاد نمره ای از موارد مانند itemName با معیارهای نمادین رویداد مانند eventCount ناسازگار می شوند. ابعاد با نمودار مورد هنوز با معیارهای مورد نظر مانند مورد مانند itemRevenue ، معیارهای مبتنی بر کاربر مانند activeUsers و معیارهای مبتنی بر جلسه مانند sessions سازگار خواهد بود.

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

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

To learn more, see the detailed explanation of compatibility changes .

2022-09-01 Quota changes.

  • Requests per day , Requests Per Minute , Requests Per Minute Per User quotas are removed from the Data API.

  • Tokens Per Project Per Property Per Hour quota has been added to the API.

  • Each request consumes quota for both Tokens Per Property Per Hour and Tokens Per Project Per Property Per Hour .

    See the Quotas documentation for the detailed information on new quotas.

2022-08-03 Added session scoped SA360 dimensions.

  • sessionSa360AdGroupName Session SA360 ad group name. The Ad Group name from Search Ads 360 that led to this session.

  • sessionSa360CampaignName Session SA360 campaign. The Campaign name from Search Ads 360 that led to this session.

  • sessionSa360CreativeFormat Session SA360 creative format. The type of creative in Search Ads 360 that led to this session. For example, 'Responsive search ad' or 'Expanded text ad'.

  • sessionSa360EngineAccountId Session SA360 engine account ID. The ID of the engine account in SA360 that led to this session.

  • sessionSa360EngineAccountName Session SA360 engine account name. The name of the engine account in SA360 that led to this session.

  • sessionSa360EngineAccountType Session SA360 engine account type. The type of the engine account in Search Ads 360 that led to this session. For example, 'google ads', 'bing', or 'baidu'.

  • sessionSa360Keyword Session SA360 keyword text. The search engine keyword from Search Ads 360 that led to this session.

  • sessionSa360Medium Session SA360 medium. The search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'.

  • sessionSa360Query Session SA360 query. The search query from Search Ads 360 that led to this session.

  • sessionSa360Source Session SA360 source. The source of the traffic from Search Ads 360 that led to this session. For example, 'example.com' or 'google'.

  • sessionCampaignId , sessionCampaignName dimensions now support Search Ads 360 campaigns.

2022-07-11 Added conversion rate metrics.

نرخ تبدیل

  • sessionConversionRate The percentage of sessions in which any conversion event was triggered.

  • userConversionRate The percentage of users who triggered any conversion event.

Conversion Rate Metrics For One Conversion

  • sessionConversionRate:event_name The percentage of sessions in which a specific conversion event was triggered.

  • userConversionRate:event_name The percentage of users who triggered a specific conversion event.

2022-05-05 Added Funnel reporting functionality to the Alpha channel.

  • runFunnelReport method added to the v1alpha version of the API, which returns a customized funnel report of your Google Analytics event data.

  • This method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. Please complete the Google Analytics Data API Funnel Reporting Feedback to give your feedback on this API.

2022-02-16 Added new dimensions.

Manual term & content

  • firstUserManualAdContent First user manual ad content. The ad content that first acquired the user. Populated by the utm_content parameter.

  • firstUserManualTerm First user manual term. The term that first acquired the user. Populated by the utm_term parameter.

  • manualAdContent Manual ad content. The ad content attributed to the conversion event. Populated by the utm_content parameter.

  • manualTerm Manual term. The term attributed to the conversion event. Populated by the utm_term parameter.

  • sessionManualAdContent Session manual ad content. The ad content that led to a session. Populated by the utm_content parameter.

  • sessionManualTerm Session manual term. The term that led to a session. Populated by the utm_term parameter.

تجزیه و تحلیل تصادف

  • crashAffectedUsers Crash-affected users. The number of users that logged a crash in this row of the report.

  • crashFreeUsersRate Crash-free users rate.

App/Web

  • averageSessionDuration The average duration (in seconds) of users' sessions.

  • newVsReturning New / returning users.

  • screenPageViewsPerSession Views per session.

  • landingPage Landing page. The page path + query string associated with the first pageview in a session.

  • platformDeviceCategory The platform and type of device on which your website or mobile app ran.

اپلیکیشن موبایل

  • averagePurchaseRevenuePerUser Average purchase revenue per user.

  • firstTimePurchaserConversionRate The percentage of active users who made their first purchase.

  • firstTimePurchasersPerNewUser The average number of first time purchasers per new user.

  • dauPerMau DAU / MAU. The rolling percent of 30-day active users who are also 1-day active users.

  • dauPerWau DAU / WAU. The rolling percent of 7-day active users who are also 1-day active users.

  • wauPerMau WAU / MAU. The rolling percent of 30-day active users who are also 7-day active users.

  • purchaserConversionRate The percentage of active users who made 1 or more purchase transactions.

  • transactionsPerPurchaser Transactions per purchaser.

Google Ads campaign

  • firstUserGoogleAdsCampaignType The campaign type of the Google Ads campaign that first acquired the user.

  • googleAdsCampaignType The campaign type for the Google Ads campaign attributed to the conversion event.

  • sessionGoogleAdsCampaignType The campaign type for the Google Ads campaign that led to this session.

2021-09-07 Added new Date/time dimensions.

  • dateHourMinute The combined values of date, hour, and minute formatted as YYYYMMDDHHMM.

  • minute The two-digit minute of the hour that the event was logged.

  • nthMinute The number of minutes since the start of the date range.

2021-09-07 Added new dimensions populated by event parameters.

  • achievementId The achievement ID in a game for an event.

  • character The player character in a game for an event.

  • fileExtension The extension of the downloaded file.

  • fileName The page path of the downloaded file.

  • groupId The player group ID in a game for an event.

  • linkClasses The HTML class attribute for an outbound link.

  • linkDomain The destination domain of the outbound link.

  • linkId The HTML id attribute for an outbound link or file download.

  • linkText The link text of the file download.

  • linkUrl The full url for an outbound link or file download.

  • method The method by which an event was triggered.

  • outbound Returns 'true' if the link leads to a site is not a part of the property's domain.

  • pageLocation The protocol, hostname, page path, and query string for web pages visited.

  • pageReferrer The full referring URL including the hostname and path.

  • percentScrolled The percentage down the page that the user has scrolled (for example, '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.