تغییرات

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

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 اضافه شده است:

• properties.reportTasks.create
• properties.reportTasks.get
• properties.reportTasks.list
• properties.reportTasks.query

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

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

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

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

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

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

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

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

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

ابعاد مخاطب:

• audienceId 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 مراجعه کنید.

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

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

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

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

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 پیروی می‌کنند: ترتیب با ستون اول نزولی، سپس با ستون دوم نزولی و غیره خواهد بود.

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

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

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 اضافه شده است:

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

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

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

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

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

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

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

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

ویژگی های Analytics 360

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 مبدأ ترافیکی که برای اولین بار کاربر را به دست آورد. لطفاً به این زمینه "کتابچه راهنمای" برای ترافیک که از 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 ، itemPromotionCreativeName ، itemName ، itemPromotionId ، orderCoupon ، transactionId ، OrderCoupton ، itemPromotionName

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

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