تغییرات

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

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 عنوان ویدیو.

  • videoUrl آدرس ویدیو.

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

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

تغییرات طرحواره API 2021-09-07 .

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

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

اطلاعیه تغییرات آتی:

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

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

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

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

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

2021-07-21 تغییرات گزارش بیدرنگ.

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

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

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

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

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

تغییرات طرحواره API 2021-06-10 .

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

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

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

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

09-04-2021 Google 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 به 10000 ردیف داده رویداد افزایش یافته است.

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

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

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

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

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

معیارها: adUnitExposure ، addToCarts ، cartToViewRate ، checkouts ، ecommercePurchases ، firstTimePurchasers publisherAdClicks itemListClickThroughRate ، itemListClicks ، itemListViews ، itemPromotionClickThroughRate ، itemPromotionClicks ، itemPromotionViews ، itemPurchaseQuantity ، itemRevenue itemViews ، totalPurchasers publisherAdImpressions

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