ابعاد API & معیارهای

این ابعاد و معیارها در گزارش‌های قیف Analytics Data API پشتیبانی می‌شوند.

ابعاد

ابعاد زیر را می توان در گزارشات قیف برای هر ملکی درخواست کرد. "نام API" را در قسمت name منبع Dimension مشخص کنید.

نام API	نام رابط کاربری	موجود در بخش ها	شرح
شناسه دستاورد	شناسه دستاورد	آره	شناسه دستاورد در یک بازی برای یک رویداد. پر شده توسط پارامتر رویداد achievement_id .
adFormat	قالب آگهی	آره	نحوه ظاهر تبلیغات و محل قرارگیری آنها را شرح می دهد. قالب‌های معمولی عبارتند از Interstitial ، Banner ، Rewarded ، و Native advanced .
adSourceName	منبع آگهی	خیر	شبکه منبعی که تبلیغ را ارائه کرد. منابع معمولی عبارتند از AdMob Network , Liftoff , Facebook Audience Network , and Mediated house ads .
adUnitName	واحد تبلیغات	خیر	نامی که برای توصیف این واحد تبلیغات انتخاب کردید. واحدهای تبلیغاتی محفظه هایی هستند که در برنامه های خود قرار می دهید تا تبلیغات را به کاربران نشان دهید.
نسخه برنامه	نسخه برنامه	آره	نسخه نام برنامه (اندروید) یا نسخه کوتاه باندل (iOS).
شناسه مخاطب	شناسه مخاطب	خیر	شناسه عددی یک مخاطب. کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد.
نام مخاطب	نام مخاطب	خیر	نام داده شده یک مخاطب کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد.
برندینگ علاقه	منافع	خیر	علایق نشان داده شده توسط کاربرانی که در قیف خرید بالاتر هستند. کاربران را می توان در دسته های علاقه مندی متعدد شمارش کرد. به عنوان مثال، Shoppers ، Lifestyles & Hobbies/Pet Lovers ، یا Travel/Travel Buffs/Beachbound Travelers .
مرورگر	مرورگر	آره	مرورگرهایی که برای مشاهده وب سایت شما استفاده می شوند.
شناسه کمپین	شناسه کمپین	خیر	شناسه کمپین بازاریابی. فقط برای رویدادهای تبدیل ارائه می شود.
نام کمپین	پویش	خیر	نام کمپین بازاریابی. فقط برای رویدادهای تبدیل ارائه می شود.
شخصیت	شخصیت	آره	شخصیت بازیکن در یک بازی برای یک رویداد. پر شده توسط character پارامتر رویداد.
شهر	شهر	آره	شهری که فعالیت کاربر از آن سرچشمه گرفته است.
شهر شناسه	شناسه شهر	آره	شناسه جغرافیایی شهری که فعالیت کاربر از آن سرچشمه گرفته است، از آدرس IP آنها مشتق شده است.
گروه	گروه	خیر	نام گروه در درخواست همگروهی مجموعه ای از کاربرانی است که شروع به استفاده از وب سایت یا برنامه شما در هر گروه از روزهای متوالی کرده اند. اگر نام گروهی در درخواست مشخص نشده باشد، گروه‌ها بر اساس شاخص صفر نام‌گذاری می‌شوند، برای مثال: cohort_0، cohort_1.
روز همگروه	گروه روزانه	خیر	جبران روز نسبت به firstSessionDate برای کاربران گروه. به عنوان مثال، اگر گروهی با تاریخ شروع و پایان 01-03-2020 انتخاب شود، برای تاریخ 02-03-2020، cohortNthDay 0001 خواهد بود.
cohortNthMonth	گروه ماهیانه	خیر	جبران ماه نسبت به firstSessionDate برای کاربران گروه. مرزهای ماه با مرزهای ماه تقویم همسو می شوند. به عنوان مثال، اگر گروهی با تاریخ شروع و پایان در مارس 2020 انتخاب شود، برای هر تاریخی در آوریل 2020، cohortNthMonth 0001 خواهد بود.
همگروهی هفتم	گروه هفتگی	خیر	تعدیل هفته نسبت به firstSessionDate برای کاربران گروه. هفته ها از یکشنبه شروع می شود و شنبه پایان می یابد. برای مثال، اگر گروهی با تاریخ شروع و پایان در محدوده 2020-11-08 تا 2020-11-14 انتخاب شود، سپس برای تاریخ های محدوده 2020-11-15 تا 2020-11-21، cohortNthWeek 0001 باشد.
محتوای گروه	گروه محتوا	آره	دسته ای که در مورد موارد محتوای منتشر شده اعمال می شود. پر شده توسط پارامتر رویداد content_group .
شناسه محتوا	شناسه محتوا	آره	شناسه محتوای انتخاب شده پر شده توسط پارامتر رویداد content_id .
نوع محتوا	نوع محتوا	آره	دسته بندی محتوای انتخاب شده پر شده توسط پارامتر رویداد content_type .
کشور	کشور	آره	کشوری که فعالیت کاربر از آن منشا گرفته است.
شناسه کشور	شناسه کشور	آره	شناسه جغرافیایی کشوری که فعالیت کاربر از آن سرچشمه گرفته است، برگرفته از آدرس IP آنها. فرمت شده بر اساس استاندارد ISO 3166-1 alpha-2.
تاریخ	تاریخ	آره	تاریخ رویداد، با قالب YYYYMMDD.
dateHour	تاریخ + ساعت (YYYYMMDDHH)	خیر	مقادیر ترکیبی تاریخ و ساعت به صورت YYYYMMDDHH قالب‌بندی شدند.
dateHourMinute	ساعت و دقیقه تاریخ	خیر	مقادیر ترکیبی تاریخ، ساعت و دقیقه به صورت YYYYMMDDHHMM قالب‌بندی شده‌اند.
روز	روز	آره	روز ماه، یک عدد دو رقمی از 01 تا 31.
روز هفته	روز هفته	آره	روز هفته. مقادیری را در محدوده [0,6] با یکشنبه به عنوان اولین روز هفته برمی گرداند.
defaultChannelGrouping	گروه بندی کانال پیش فرض	خیر	گروه بندی کانال پیش فرض تبدیل اساساً بر اساس منبع و رسانه است. شمارشی که شامل Direct , Organic Search , Paid Social , Organic Social , Email , Affiliates , Referral , Paid Search , Video و Display .
دسته دستگاه	دسته دستگاه	آره	نوع دستگاه: رومیزی، تبلت یا موبایل.
مدل دستگاه	مدل دستگاه	آره	مدل دستگاه تلفن همراه (به عنوان مثال: iPhone 10,6).
نام رخداد	نام رخداد	آره	نام رویداد.
فرمت فایل	فرمت فایل	آره	پسوند فایل دانلود شده (مثلاً pdf یا txt ). اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد file_extension .
نام فایل	نام فایل	آره	مسیر صفحه فایل دانلود شده (به عنوان مثال /menus/dinner-menu.pdf ). اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد file_name .
firstSessionDate	تاریخ جلسه اول	آره	تاریخ برگزاری اولین جلسه کاربر، با قالب YYYYMMDD.
firstUserCampaignId	شناسه کمپین کاربر اول	خیر	شناسه کمپین بازاریابی که برای اولین بار کاربر را جذب کرد. شامل کمپین های تبلیغاتی گوگل است.
firstUserCampaignName	اولین کمپین کاربر	آره	نام کمپین بازاریابی که برای اولین بار کاربر را جذب کرد. شامل تبلیغات گوگل و کمپین های دستی است.
firstUserDefaultChannelGrouping	گروه بندی کانال پیش فرض کاربر اول	آره	گروه بندی کانال پیش فرض که برای اولین بار کاربر را به دست آورد. گروه بندی کانال پیش فرض اساساً بر اساس منبع و رسانه است. شمارشی که شامل Direct , Organic Search , Paid Social , Organic Social , Email , Affiliates , Referral , Paid Search , Video و Display .
firstUserGoogleAdsAccountName	نام حساب کاربری Google Ads اولین کاربر	خیر	نام حساب از Google Ads که برای اولین بار کاربر را به دست آورد.
firstUserGoogleAdsAdGroupId	شناسه گروه تبلیغات Google Ads کاربر اول	خیر	شناسه گروه تبلیغات در Google Ads که برای اولین بار کاربر را جذب کرد.
firstUserGoogleAdsAdGroupName	اولین کاربر نام گروه تبلیغاتی Google Ads	خیر	نام گروه تبلیغاتی در Google Ads که برای اولین بار کاربر را به دست آورد.
firstUserGoogleAdsAdNetworkType	اولین کاربر نوع شبکه تبلیغاتی Google Ads	آره	شبکه تبلیغاتی که برای اولین بار کاربر را به دست آورد. شمارشی که شامل Google search ، Search partners ، Google Display Network ، Youtube Search ، Youtube Videos ، Cross-network ، Social و (universal campaign) .
firstUserGoogleAdsCampaignType	نوع کمپین تبلیغاتی کاربر اول	خیر	نوع کمپین کمپین تبلیغات گوگل که برای اولین بار کاربر را جذب کرد. انواع کمپین تعیین می‌کند که مشتریان کجا تبلیغات شما را ببینند و تنظیمات و گزینه‌های موجود در Google Ads را تعیین می‌کنند. نوع کمپین شمارشی است که شامل موارد زیر است: جستجو، نمایش، خرید، ویدیو، کشف، برنامه، هوشمند، هتل، محلی و حداکثر عملکرد. برای کسب اطلاعات بیشتر، به انتخاب نوع کمپین مناسب مراجعه کنید.
firstUserGoogleAdsCreativeId	شناسه خلاقیت اولین کاربر Google Ads	خیر	شناسه خلاقیت Google Ads که برای اولین بار کاربر را جذب کرد. شناسه‌های خلاقانه تبلیغات فردی را شناسایی می‌کنند.
firstUserGoogleAdsCustomerId	شناسه مشتری Google Ads کاربر اول	خیر	شناسه مشتری از Google Ads که برای اولین بار کاربر را جذب کرد. شناسه‌های مشتری در Google Ads به طور منحصربه‌فردی حساب‌های Google Ads را شناسایی می‌کنند.
firstUserGoogleAdsKeyword	اولین کاربر متن کلمه کلیدی Google Ads	خیر	کلمه کلیدی منطبقی که برای اولین بار کاربر را جذب کرد. کلمات کلیدی کلمات یا عباراتی هستند که محصول یا خدمات شما را توصیف می کنند که شما انتخاب می کنید تا تبلیغ خود را در معرض دید مشتریان مناسب قرار دهید. برای کسب اطلاعات بیشتر در مورد کلمات کلیدی، به کلمات کلیدی: تعریف مراجعه کنید.
firstUserGoogleAdsQuery	اولین پرس و جوی کاربر گوگل ادز	خیر	عبارت جستجویی که برای اولین بار کاربر را جذب کرد.
firstUserManualAdContent	اولین محتوای آگهی راهنمای کاربر	آره	محتوای تبلیغاتی که برای اولین بار کاربر را جذب کرد. با پارامتر utm_content پر شده است.
firstUserManualTerm	اولین اصطلاح راهنمای کاربر	آره	اصطلاحی که برای اولین بار کاربر را به دست آورد. با پارامتر utm_term پر شده است.
firstUserMedium	رسانه کاربر اول	آره	رسانه ای که برای اولین بار کاربر را به وب سایت یا برنامه شما جذب کرد.
firstUserSource	منبع کاربر اول	آره	منبعی که برای اولین بار کاربر را به وب سایت یا برنامه شما جذب کرد.
firstUserSourceMedium	منبع / رسانه کاربر اول	خیر	مقادیر ترکیبی ابعاد firstUserSource و firstUserMedium .
firstUserSourcePlatform	اولین پلتفرم منبع کاربر	خیر	پلتفرم منبعی که برای اولین بار کاربر را به دست آورد. برای ترافیکی که از UTM استفاده می کند، به این فیلد Manual نباشید. این فیلد از بازگشت Manual به بازگشتی (not set) برای راه اندازی ویژگی های آینده به روز می شود.
fullPageUrl	URL صفحه کامل	خیر	نام میزبان، مسیر صفحه، و رشته پرس و جو برای صفحات وب بازدید شده؛ برای مثال، قسمت fullPageUrl https://www.example.com/store/contact-us?query_string=true www.example.com/store/contact-us?query_string=true است.
funnelStepName	گام	خیر	نام توصیفی اختصاص داده شده به مرحله قیف. به عنوان مثال، تعیین name = Purchase در مرحله سوم قیف در درخواست، 3. Purchase برای این بعد funnelStepName در پاسخ گزارش قیف.
funnelStepNewVsادامه دارد	جدید در مقابل ادامه	خیر	اگر کاربر در مرحله قبلی قیف حضور داشته باشد، مراحل قیف را ادامه می دهد. در غیر این صورت، آن کاربر جدید است. این بعد فقط برای قیف‌های باز معنی‌دار است و دو مقدار را برمی‌گرداند: new و continuing .
funnelStepNextAction	قیف اقدام بعدی	خیر	اقدام بعدی مقدار بعد بعدی است که کاربر پس از تکمیل مرحله فعلی و شامل تکمیل مرحله بعدی به دست آورده است. به عنوان مثال اگر بعد اقدام بعدی درخواستی eventName باشد، این بعد پس از رسیدن به مرحله i'th نام رویداد بعدی را برمی گرداند. این اقدام بعدی منحصر به رویدادی است که به مرحله یکم رسیده است و شامل رویدادی است که به مرحله i+1 رسیده است.
googleAdsAccountName	نام حساب Google Ads	خیر	نام حساب از Google Ads برای کمپینی که منجر به رویداد تبدیل شد. مربوط به customer.descriptive_name در Google Ads API است.
googleAdsAdGroupId	شناسه گروه تبلیغات Google Ads	خیر	شناسه گروه آگهی منتسب به رویداد تبدیل.
googleAdsAdGroupName	نام گروه تبلیغاتی Google Ads	خیر	نام گروه آگهی منتسب به رویداد تبدیل.
googleAdsAdNetworkType	نوع شبکه تبلیغاتی Google Ads	خیر	نوع شبکه تبلیغاتی تبدیل. شمارشی که شامل Google search ، Search partners ، Google Display Network ، Youtube Search ، Youtube Videos ، Cross-network ، Social و (universal campaign) .
googleAdsCampaignType	نوع کمپین تبلیغاتی گوگل	خیر	نوع کمپین برای کمپین Google Ads منتسب به رویداد تبدیل. انواع کمپین تعیین می‌کند که مشتریان کجا تبلیغات شما را ببینند و تنظیمات و گزینه‌های موجود در Google Ads را تعیین می‌کنند. نوع کمپین شمارشی است که شامل موارد زیر است: جستجو، نمایش، خرید، ویدیو، کشف، برنامه، هوشمند، هتل، محلی و حداکثر عملکرد. برای کسب اطلاعات بیشتر، به انتخاب نوع کمپین مناسب مراجعه کنید.
googleAdsCreativeId	شناسه خلاقیت Google Ads	خیر	شناسه خلاقیت Google Ads منتسب به رویداد تبدیل. شناسه‌های خلاقانه تبلیغات فردی را شناسایی می‌کنند.
googleAdsCustomerId	شناسه مشتری Google Ads	خیر	شناسه مشتری از Google Ads برای کمپینی که منجر به رویداد تبدیل شد. شناسه‌های مشتری در Google Ads به طور منحصربه‌فردی حساب‌های Google Ads را شناسایی می‌کنند.
googleAdsKeyword	متن کلمه کلیدی گوگل ادز	خیر	کلمه کلیدی منطبق که به رویداد تبدیل منجر شد. کلمات کلیدی کلمات یا عباراتی هستند که محصول یا خدمات شما را توصیف می کنند که شما انتخاب می کنید تا تبلیغ خود را در معرض دید مشتریان مناسب قرار دهید. برای کسب اطلاعات بیشتر در مورد کلمات کلیدی، به کلمات کلیدی: تعریف مراجعه کنید.
googleAdsQuery	جستجوی تبلیغات گوگل	خیر	عبارت جستجویی که منجر به رویداد تبدیل شد.
شناسه گروه	شناسه گروه	آره	شناسه گروه بازیکن در یک بازی برای یک رویداد. با پارامتر رویداد group_id پر شده است.
نام میزبان	نام میزبان	آره	شامل زیر دامنه و نام دامنه یک URL است. برای مثال، نام میزبان www.example.com/contact.html www.example.com است.
ساعت	ساعت	آره	ساعت دو رقمی روز که رویداد ثبت شده است. این بعد از 0 تا 23 متغیر است و در منطقه زمانی ملک شما گزارش می شود.
isConversionEvent	رویداد تبدیل است	آره	اگر رویداد یک تبدیل باشد، رشته true . رویدادها در زمان جمع آوری به عنوان تبدیل علامت گذاری می شوند. تغییرات در علامت تبدیل رویداد در آینده اعمال می شود. می‌توانید هر رویدادی را به‌عنوان تبدیل در Google Analytics علامت‌گذاری کنید، و برخی رویدادها (یعنی first_open، خرید) به‌طور پیش‌فرض به‌عنوان تبدیل علامت‌گذاری می‌شوند. برای اطلاعات بیشتر، درباره تبدیل‌ها را ببینید.
itemAffiliation	وابستگی آیتم	خیر	نام یا کد شرکت وابسته (شریک/فروشنده؛ در صورت وجود) مرتبط با یک مورد جداگانه. پر شده توسط پارامتر آیتم affiliation .
مورد برند	برند کالا	خیر	نام تجاری کالا.
دسته بندی مورد	دسته بندی آیتم	خیر	دسته سلسله مراتبی که آیتم در آن طبقه بندی می شود. به عنوان مثال، در پوشاک / مردانه / تابستانی / پیراهن / تی شرت، پوشاک دسته بندی اقلام است.
آیتم دسته 2	دسته بندی آیتم 2	خیر	دسته سلسله مراتبی که آیتم در آن طبقه بندی می شود. برای مثال، در پوشاک/مردانه/تابستان/پیراهن/تی‌شرت، مردانه کالای دسته ۲ است.
مورد دسته 3	دسته بندی اقلام 3	خیر	دسته سلسله مراتبی که آیتم در آن طبقه بندی می شود. به عنوان مثال، در پوشاک/مردانه/تابستان/پیراهن/تی‌شرت، تابستان اقلام دسته 3 است.
مورد رده 4	دسته بندی اقلام 4	خیر	دسته سلسله مراتبی که آیتم در آن طبقه بندی می شود. به عنوان مثال، در پوشاک / مردانه / تابستانی / پیراهن / تی شرت، پیراهن در دسته 4 مورد است.
مورد رده 5	دسته بندی آیتم 5	خیر	دسته سلسله مراتبی که آیتم در آن طبقه بندی می شود. برای مثال، در پوشاک/مردانه/تابستان/پیراهن/تی‌شرت، تی‌شرت‌ها در رده 5 قرار دارند.
شناسه مورد	شناسه مورد	خیر	شناسه کالا.
itemListId	شناسه لیست آیتم	خیر	شناسه لیست اقلام.
itemListName	نام لیست آیتم	خیر	نام لیست اقلام
نام آیتم	نام آیتم	خیر	نام مورد.
itemPromotionCreativeName	نام خلاق تبلیغ مورد	خیر	نام آیتم-تبلیغ خلاق.
itemPromotionId	شناسه تبلیغ کالا	خیر	شناسه تبلیغ کالا.
itemPromotionName	نام تبلیغ مورد	خیر	نام تبلیغ برای مورد.
itemVariant	نوع مورد	خیر	تنوع خاص یک محصول به عنوان مثال، XS، S، M، L برای اندازه؛ یا قرمز، آبی، سبز، سیاه برای رنگ. با پارامتر item_variant پر شده است.
صفحه فرود	صفحه فرود	آره	مسیر صفحه + رشته پرس و جو مرتبط با اولین نمایش صفحه در یک جلسه.
زبان	زبان	آره	تنظیمات زبان مرورگر یا دستگاه کاربر. مثلا انگلیسی
کد زبان	کد زبان	آره	تنظیمات زبان (ISO 639) مرورگر یا دستگاه کاربر. به عنوان مثال، en-us
مرحله	مرحله	آره	سطح بازیکن در یک بازی. با level پارامتر رویداد پر شده است.
پیوند کلاس ها	پیوند دادن کلاس ها	آره	ویژگی کلاس HTML برای یک پیوند خروجی. برای مثال، اگر کاربر روی پیوند <a class="center" href="www.youtube.com"> کلیک کند، این بعد به center باز می گردد. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد link_classes .
لینک دامنه	لینک دامنه	آره	دامنه مقصد پیوند خروجی. برای مثال، اگر کاربر روی پیوند <a href="www.youtube.com"> کلیک کند، این بعد youtube.com برمی‌گرداند. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. با پارامتر رویداد link_domain پر شده است.
شناسه لینک	شناسه پیوند	آره	ویژگی HTML ID برای یک لینک خروجی یا دانلود فایل. برای مثال اگر کاربری روی پیوند <a id="socialLinks" href="www.youtube.com"> کلیک کند، این بعد socialLinks برمی‌گرداند. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد link_id .
متن پیوند	متن پیوند	آره	متن لینک دانلود فایل. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. با پارامتر رویداد link_text پر شده است.
linkUrl	لینک URL	آره	URL کامل برای لینک خروجی یا دانلود فایل. برای مثال، اگر کاربر روی پیوند <a href="https://www.youtube.com/results?search_query=analytics"> کلیک کند، این بعد https://www.youtube.com/results?search_query=analytics برمی‌گردد. . اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد link_url .
manualAdContent	محتوای تبلیغاتی دستی	خیر	محتوای آگهی منتسب به رویداد تبدیل. با پارامتر utm_content پر شده است.
مدت زمان دستی	اصطلاح دستی	خیر	اصطلاحی که به رویداد تبدیل نسبت داده می شود. با پارامتر utm_term پر شده است.
متوسط	متوسط	خیر	رسانه منتسب به رویداد تبدیل.
روش	روش	آره	روشی که با آن یک رویداد راه اندازی شد. با method پارامتر رویداد پر شده است.
دقیقه	دقیقه	خیر	دقیقه دو رقمی ساعتی که رویداد ثبت شد. این بعد از 0 تا 59 متغیر است و در منطقه زمانی ملک شما گزارش می شود.
MobileDeviceBranding	برند دستگاه	آره	سازنده یا نام تجاری (مثلاً: Samsung، HTC، Verizon، T-Mobile).
MobileDeviceMarketingName	دستگاه	آره	نام دستگاه برند (مثلاً: Galaxy S10 یا P30 Pro).
MobileDeviceModel	مدل موبایل	آره	نام مدل دستگاه تلفن همراه (مثلاً: iPhone X یا SM-G950F).
ماه	ماه	آره	ماه رویداد، یک عدد صحیح دو رقمی از 01 تا 12.
newVsReturning	جدید / بازگشت	آره	کاربران جدید 0 جلسه قبلی دارند و کاربران بازگشتی 1 یا چند جلسه قبلی دارند. این بعد دو مقدار را برمی گرداند: new یا returning .
روز nth	روز نهم	خیر	تعداد روزهای پس از شروع محدوده تاریخ.
nthHour	ساعت نهم	خیر	تعداد ساعات پس از شروع محدوده تاریخ. ساعت شروع 0000 است.
nthMinute	دقیقه نهم	خیر	تعداد دقیقه از شروع محدوده تاریخ. دقیقه شروع 0000 است.
nthMonth	ماه نهم	خیر	تعداد ماه‌هایی که از شروع یک محدوده تاریخ می‌گذرد. ماه شروع 0000 است.
هفته nth	هفته نهم	خیر	عددی که نشان‌دهنده تعداد هفته‌های پس از شروع محدوده تاریخ است.
سال nth	سال نهم	خیر	تعداد سال‌هایی که از شروع محدوده تاریخ می‌گذرد. سال شروع 0000 است.
سیستم عامل	سیستم عامل	آره	سیستم عامل هایی که بازدیدکنندگان برنامه یا وب سایت شما استفاده می کنند. شامل سیستم عامل های دسکتاپ و موبایل مانند ویندوز و اندروید است.
نسخه سیستم عامل	نسخه سیستم عامل	آره	نسخه های سیستم عاملی که بازدیدکنندگان وب سایت یا برنامه شما استفاده می کنند. به عنوان مثال، نسخه اندروید 10 نسخه 10 و نسخه iOS 13.5.1 13.5.1 است.
OperatingSystemWithVersion	سیستم عامل با نسخه	آره	سیستم عامل و نسخه. برای مثال اندروید 10 یا ویندوز 7.
کوپن سفارش	کوپن سفارش	آره	کد برای کوپن سطح سفارش.
خروجی	خروجی	آره	اگر پیوند منتهی به یک سایت بخشی از دامنه دارایی نباشد، true برمی‌گرداند. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد outbound .
محل صفحه	مکان صفحه	آره	پروتکل، نام میزبان، مسیر صفحه، و رشته پرس و جو برای صفحات وب بازدید شده؛ برای مثال، قسمت pageLocation https://www.example.com/store/contact-us?query_string=true https://www.example.com/store/contact-us?query_string=true است. پر شده توسط پارامتر رویداد page_location .
pagePath	مسیر صفحه	خیر	بخشی از URL بین نام میزبان و رشته جستجو برای صفحات وب بازدید شده؛ برای مثال، قسمت pagePath https://www.example.com/store/contact-us?query_string=true /store/contact-us است.
pagePathPlusQueryString	مسیر صفحه + رشته پرس و جو	آره	بخشی از URL که پس از نام میزبان برای صفحات وب بازدید شده است. برای مثال، بخش pagePathPlusQueryString از https://www.example.com/store/contact-us?query_string=true /store/contact-us?query_string=true .
ارجاع دهنده صفحه	ارجاع دهنده صفحه	آره	URL ارجاع دهنده کامل شامل نام میزبان و مسیر. این URL ارجاع دهنده نشانی اینترنتی قبلی کاربر است و می تواند دامنه این وب سایت یا دامنه های دیگر باشد. پر شده توسط پارامتر رویداد page_referrer .
عنوان صفحه	عنوان صفحه	آره	عناوین صفحات وب مورد استفاده در سایت شما.
درصد اسکرول شد	درصد پیمایش شد	آره	درصد پایین صفحه ای که کاربر پیمایش کرده است (مثلاً 90 ). اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. با پارامتر رویداد percent_scrolled پر شده است.
سکو	سکو	آره	پلتفرمی که برنامه یا وب سایت شما روی آن اجرا می شود؛ برای مثال، وب، iOS یا اندروید. برای تعیین نوع جریان در گزارش، از هر دو پلتفرم و streamId استفاده کنید.
platformDeviceCategory	دسته پلت فرم / دستگاه	آره	پلتفرم و نوع دستگاهی که وب سایت یا اپلیکیشن موبایل شما روی آن اجرا می شود. (مثال: اندروید / موبایل)
منطقه	منطقه	آره	منطقه جغرافیایی که فعالیت کاربر از آن سرچشمه گرفته است، از آدرس IP آنها مشتق شده است.
وضوح صفحه	وضوح صفحه	آره	وضوح صفحه نمایش مانیتور کاربر. به عنوان مثال، 1920x1080.
عبارت جستجو	عبارت جستجو	آره	عبارت جستجو شده توسط کاربر به عنوان مثال، اگر کاربر از /some-page.html?q=some-term بازدید کند، این بعد some-term برمی گرداند. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار پر می‌شود. پر شده توسط پارامتر رویداد search_term .
بخش	بخش	خیر	یک بخش زیرمجموعه ای از داده های Analytics شما است. برای مثال، از کل مجموعه کاربران شما، یک بخش ممکن است کاربران یک کشور یا شهر خاص باشد. برای کسب اطلاعات بیشتر، بخش ساز را ببینید. بعد بخش، نام تخصیص یافته به بخش در درخواست را با پیشوند 1 برمی‌گرداند (یعنی اگر اولین بخش در درخواست با نام Paid Traffic شده باشد، این بخش در پاسخ 1. Paid Traffic ). اگر نام بخش‌ها در درخواست مشخص نشده باشد، بخش‌ها با نام‌های مبتنی بر 1 نام‌گذاری می‌شوند (یعنی 1. Segment ، 2. Segment ، و غیره).
sessionCampaignId	شناسه کمپین جلسه	خیر	شناسه کمپین بازاریابی برای یک جلسه. شامل کمپین‌های دستی و کمپین‌هایی از پیوندهای یکپارچه‌سازی مانند Google Ads و Search Ads 360 است.
sessionCampaignName	کمپین جلسه	آره	نام کمپین بازاریابی برای یک جلسه. شامل کمپین‌های دستی و کمپین‌هایی از پیوندهای یکپارچه‌سازی مانند Google Ads و Search Ads 360 است.
sessionDefaultChannelGrouping	گروه بندی کانال پیش فرض جلسه	آره	گروه بندی کانال پیش فرض جلسه اساساً بر اساس منبع و رسانه است. شمارشی که شامل Direct , Organic Search , Paid Social , Organic Social , Email , Affiliates , Referral , Paid Search , Video و Display .
sessionGoogleAdsAccountName	نام حساب Google Ads جلسه	خیر	نام حساب از Google Ads که به جلسه منتهی شد. مربوط به customer.descriptive_name در Google Ads API است.
sessionGoogleAdsAdGroupId	شناسه گروه آگهی جلسه Google Ads	خیر	شناسه گروه تبلیغات در Google Ads برای یک جلسه.
sessionGoogleAdsAdGroupName	نام گروه آگهی جلسه Google Ads	خیر	نام گروه تبلیغات در Google Ads برای یک جلسه.
sessionGoogleAdsAdNetworkType	نوع شبکه تبلیغاتی Session Google Ads	آره	شبکه تبلیغاتی که منجر به جلسه شد. شمارشی که شامل Google search ، Search partners ، Google Display Network ، Youtube Search ، Youtube Videos ، Cross-network ، Social و (universal campaign) .
sessionGoogleAdsCampaignType	نوع کمپین Session Google Ads	خیر	نوع کمپین برای کمپین Google Ads که به این جلسه منتهی شد. انواع کمپین تعیین می‌کند که مشتریان کجا تبلیغات شما را ببینند و تنظیمات و گزینه‌های موجود در Google Ads را تعیین می‌کنند. نوع کمپین شمارشی است که شامل موارد زیر است: جستجو، نمایش، خرید، ویدیو، کشف، برنامه، هوشمند، هتل، محلی و حداکثر عملکرد. برای کسب اطلاعات بیشتر، به انتخاب نوع کمپین مناسب مراجعه کنید.
sessionGoogleAdsCreativeId	شناسه خلاق جلسه Google Ads	خیر	شناسه خلاقیت Google Ads که منجر به جلسه ای در وب سایت یا برنامه شما می شود. شناسه‌های خلاقانه تبلیغات فردی را شناسایی می‌کنند.
sessionGoogleAdsCustomerId	شناسه مشتری جلسه Google Ads	خیر	شناسه مشتری از Google Ads که به جلسه منتهی شد. شناسه‌های مشتری در Google Ads به طور منحصربه‌فردی حساب‌های Google Ads را شناسایی می‌کنند.
sessionGoogleAdsKeyword	جلسه متن کلمه کلیدی Google Ads	خیر	کلمه کلیدی منطبق که به جلسه منتهی شد. کلمات کلیدی کلمات یا عباراتی هستند که محصول یا خدمات شما را توصیف می کنند که شما انتخاب می کنید تا تبلیغ خود را در معرض دید مشتریان مناسب قرار دهید. برای کسب اطلاعات بیشتر در مورد کلمات کلیدی، [Keywords: Definition

](//support.google.com/google-ads/answer/6323). sessionGoogleAdsQuery | جلسه جستجوی تبلیغات گوگل | نه | عبارت جستجویی که به جلسه منتهی شد. sessionManualAdContent | محتوای آگهی راهنمای جلسه | بله | محتوای تبلیغاتی که منجر به یک جلسه شد. با پارامتر utm_content پر شده است. sessionManualTerm | دوره راهنمای جلسه | بله | اصطلاحی که منجر به جلسه شد. با پارامتر utm_term پر شده است. جلسه متوسط ​​| رسانه جلسه | بله | رسانه ای که جلسه ای را در وب سایت یا برنامه شما راه اندازی کرد. sessionSa360AdGroupName | نام گروه تبلیغات Session SA360 | نه | نام گروه آگهی از Search Ads 360 که به این جلسه منتهی شد. sessionSa360CampaignName | کمپین Session SA360 | نه | نام کمپین از Search Ads 360 که به این جلسه منتهی شد. sessionSa360CreativeFormat | فرمت خلاق جلسه SA360 | نه | نوع خلاقیت در Search Ads 360 که منجر به این جلسه شد. به عنوان مثال، Responsive search ad یا Expanded text ad . برای کسب اطلاعات بیشتر، به ابعاد منبع ترافیک GA4 مراجعه کنید. sessionSa360EngineAccountId | شناسه اکانت موتور Session SA360 | نه | شناسه اکانت موتور در SA360 که منجر به این جلسه شد. sessionSa360EngineAccountName | نام اکانت موتور Session SA360 | نه | نام اکانت موتور در SA360 که منجر به این جلسه شد. sessionSa360EngineAccountType | نوع اکانت موتور Session SA360 | نه | نوع حساب موتور در Search Ads 360 که به این جلسه منتهی شد. به عنوان مثال، google ads ، bing ، یا baidu . sessionSa360Keyword | متن کلمه کلیدی جلسه SA360 | نه | کلمه کلیدی موتور جستجو از Search Ads 360 که به این جلسه منتهی شد. sessionSa360Medium | Session SA360 متوسط ​​| نه | کلمه کلیدی موتور جستجو از Search Ads 360 که به این جلسه منتهی شد. به عنوان مثال، cpc . sessionSa360Query | پرس و جو جلسه SA360 | نه | عبارت جستجو از Search Ads 360 که به این جلسه منتهی شد. sessionSa360 Source | منبع جلسه SA360 | نه | منبع ترافیک Search Ads 360 که به این جلسه منتهی شد. به عنوان مثال، example.com یا google . منبع جلسه | منبع جلسه | بله | منبعی که جلسه ای را در وب سایت یا برنامه شما راه اندازی کرده است. sessionSourceMedium | منبع جلسه / رسانه | نه | مقادیر ترکیبی ابعاد sessionSource و sessionMedium . sessionSourcePlatform | پلت فرم منبع جلسه | نه | بستر منبع کمپین جلسه. برای ترافیکی که از UTM استفاده می کند، به این فیلد Manual نباشید. این فیلد از بازگشت Manual به بازگشتی (not set) برای راه اندازی ویژگی های آینده به روز می شود. ردیف حمل و نقل | ردیف حمل و نقل | نه | ردیف حمل و نقل (به عنوان مثال زمینی، هوایی، روز بعد) برای تحویل کالای خریداری شده انتخاب شده است. با پارامتر رویداد shipping_tier پر شده است. signedInWithUserId | وارد شده با شناسه کاربری | بله | اگر کاربر با ویژگی User-ID وارد شده باشد، رشته yes . برای کسب اطلاعات بیشتر درباره User-ID، به اندازه گیری فعالیت در پلتفرم ها با User-ID مراجعه کنید. منبع | منبع | نه | منبع منتسب به رویداد تبدیل. منبعمتوسط ​​| منبع / رسانه | نه | مقادیر ترکیبی ابعاد source و medium . منبع پلتفرم | بستر منبع | نه | پلت فرم منبع کمپین رویداد تبدیل. برای ترافیکی که از UTM استفاده می کند، به این فیلد Manual نباشید. این فیلد از بازگشت Manual به بازگشتی (not set) برای راه اندازی ویژگی های آینده به روز می شود. streamId | شناسه جریان | بله | شناسه جریان داده عددی برای برنامه یا وب سایت شما. نام جریان | نام جریان | بله | نام جریان داده برای برنامه یا وب سایت شما. testDataFilterName | نام فیلتر داده تست | نه | نام فیلترهای داده در حالت آزمایشی. شما از فیلترهای داده برای گنجاندن یا حذف داده های رویداد از گزارش های خود بر اساس مقادیر پارامتر رویداد استفاده می کنید. برای کسب اطلاعات بیشتر، به فیلترهای داده مراجعه کنید. شناسه معامله | شناسه تراکنش | بله | شناسه تراکنش تجارت الکترونیک. unifiedPagePathScreen | مسیر صفحه و کلاس صفحه | بله | مسیر صفحه (وب) یا کلاس صفحه (برنامه) که رویداد در آن ثبت شده است. UnifiedPageScreen | مسیر صفحه + رشته کوئری و کلاس صفحه | بله | مسیر صفحه و رشته جستجو (وب) یا کلاس صفحه (برنامه) که رویداد در آن ثبت شده است. unifiedScreenClass | عنوان صفحه و کلاس صفحه | بله | عنوان صفحه (وب) یا کلاس صفحه (برنامه) که رویداد در آن ثبت شده است. unifiedScreenName | عنوان صفحه و نام صفحه | بله | عنوان صفحه (وب) یا نام صفحه (برنامه) که رویداد در آن ثبت شده است. userAgeBracket | سن | بله | براکت سن کاربر userGender | جنسیت | بله | جنسیت کاربر ارائه دهنده ویدئو | ارائه دهنده ویدئو | بله | منبع ویدیو (به عنوان مثال، youtube ). اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار برای ویدیوهای جاسازی‌شده پر می‌شود. پر شده توسط پارامتر رویداد video_provider . عنوان ویدیو | عنوان ویدیو | بله | عنوان ویدیو. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار برای ویدیوهای جاسازی‌شده پر می‌شود. پر شده توسط پارامتر رویداد video_title . آدرس ویدیو | آدرس ویدیو | بله | آدرس ویدیو. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار برای ویدیوهای جاسازی‌شده پر می‌شود. پر شده توسط پارامتر رویداد video_url . virtual CurrencyName | نام ارز مجازی | بله | نام یک ارز مجازی که کاربر با آن در حال تعامل است. به عنوان مثال، خرج کردن یا خرید جواهرات در یک بازی. با پارامتر رویداد virtual_currency_name پر شده است. قابل مشاهده | قابل مشاهده | بله | اگر محتوا قابل مشاهده باشد، true برمی‌گرداند. اگر اندازه‌گیری پیشرفته فعال باشد، به‌طور خودکار برای ویدیوهای جاسازی‌شده پر می‌شود. پر شده توسط پارامتر رویداد visible . هفته | هفته | بله | هفته رویداد، یک عدد دو رقمی از 01 تا 53. هر هفته از یکشنبه شروع می شود. اول ژانویه همیشه در هفته 01 است. اولین و آخرین هفته سال در بیشتر سال ها کمتر از 7 روز است. هفته های غیر از هفته اول و آخر سال همیشه 7 روز دارند. برای سال هایی که اول ژانویه یکشنبه است، اولین هفته آن سال و هفته آخر سال قبل 7 روز است. سال | سال | بله | سال چهار رقمی رویداد به عنوان مثال، 2020.

ابعاد سفارشی

Data API می‌تواند گزارش‌هایی در مورد رویدادها و ابعاد سفارشی با محدوده کاربر ایجاد کند. برای اطلاعات بیشتر درباره ابعاد سفارشی، گزارش ابعاد و معیارهای سفارشی با محدوده رویداد و ویژگی‌های کاربر سفارشی را ببینید. ابعاد سفارشی در یک درخواست گزارش API با نام پارامتر و محدوده ابعاد مشخص می‌شوند. برای مثال، "customEvent:achievement_id" را در یک درخواست Data API برای ایجاد گزارشی برای بعد سفارشی با محدوده رویداد با نام پارامتر "achievement_id" قرار دهید. در صورتی که دارایی این بعد سفارشی با محدوده رویداد را ثبت نکرده باشد، این درخواست API ناموفق خواهد بود.

اگر یک بعد سفارشی با محدوده رویداد قبل از اکتبر 2020 ثبت شده باشد، بعد باید در یک درخواست API با نام رویداد آن مشخص شود. به عنوان مثال، "customEvent:achievement_id\[level_up\]" را برای ابعاد سفارشی با محدوده رویداد با نام پارامتر "achievement_id" و نام رویداد "level_up" اضافه کنید. در اکتبر 2020، Analytics گزارش‌دهی با پارامترهای سفارشی را با ابعاد سفارشی و گزارش سنجه‌های سفارشی با محدوده رویداد جایگزین کرد.

در زیر دستور کلی برای ابعاد سفارشی آمده است. می‌توانید از متد API فراداده پرس و جو کنید تا همه ابعاد سفارشی یک ویژگی را فهرست کنید. در اینجا مثالی از استفاده از متد API متاداده آورده شده است.

نام API عمومی	موجود در بخش ها	شرح
customEvent:parameter_name	آره	ابعاد سفارشی با محدوده رویداد برای parameter_name
customEvent:parameter_name[event_name]	آره	اگر قبل از اکتبر 2020 ثبت شده باشد، ابعاد سفارشی با محدوده رویداد برای parameter_name
customUser:parameter_name	آره	ابعاد سفارشی با محدوده کاربر برای parameter_name

گروه های کانال سفارشی

Data API می تواند گزارش هایی را در گروه های کانال سفارشی ایجاد کند. برای کسب اطلاعات بیشتر درباره گروه‌های کانال سفارشی، به گروه‌های کانال سفارشی در GA4 مراجعه کنید. گروه‌های کانال سفارشی در درخواست گزارش API بر اساس محدوده بعد و شناسه گروه کانال مشخص می‌شوند. برای مثال، "sessionCustomChannelGroup:9432931" را در یک درخواست Data API برای ایجاد گزارشی برای کانال سفارشی با محدوده جلسه با شناسه 9432931 قرار دهید. اگر ویژگی دارای کانال سفارشی با این شناسه نباشد، این درخواست API ناموفق خواهد بود.

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

نام API عمومی	شرح
sessionCustomChannelGroup:custom_channel_id	کانال سفارشی که منجر به این جلسه می شود.
firstUserCustomChannelGroup:custom_channel_id	کانال سفارشی که برای اولین بار این کاربر را به دست آورد.
CustomChannelGroup:custom_channel_id	کانال سفارشی که منجر به رویداد تبدیل شد.

معیارهای

معیارهای زیر می توانند در گزارش های قیف برای هر ویژگی باشند.

نام API	نام رابط کاربری	شرح
فعال کاربران	کاربران فعال	تعداد کاربران مشخصی که از سایت یا برنامه شما بازدید کردند.
funnelStepAbandonmentRate	نرخ رها شدن	درصد کاربرانی که در این مرحله قیف را رها می کنند. این متریک به صورت کسری برگردانده می شود. به عنوان مثال، 0.412 به این معنی است که 41.2٪ از کاربران قیف را در این مرحله رها کردند.
funnelStepAbandonments	رها شدگی ها	تعداد مطلق کاربرانی که در این مرحله قیف را رها می کنند.
funnelStepCompletionRate	نرخ تکمیل	درصد کاربرانی که این مرحله از قیف را کامل کردند. این متریک به صورت کسری برگردانده می شود. به عنوان مثال، 0.588 به این معنی است که 58.8٪ از کاربران این مرحله قیف را تکمیل کردند.