Google Analytics Reporting API Changelog

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

این صفحه هرگونه تغییر ایجاد شده در API گزارش Google Analytics را که ممکن است بر برنامه شما تأثیر بگذارد، مستند می کند. توصیه می‌کنیم توسعه‌دهندگان API به‌طور دوره‌ای این فهرست را برای اطلاعیه‌های جدید بررسی کنند. همچنین می توانید از طریق فیدهای فهرست شده در بخش اشتراک در زیر، در تغییرات مشترک شوید.

مشترک شدن در تغییرات مرتبط

همه تغییرات API Google Analytics
–
اشتراک درrss

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

همه گزارش تغییرات API
–
اشتراک درrss

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

Core Reporting API Changelog
–
اشتراک درrss

این نسخه اولیه User Activity API است

  • User Activity API به شما امکان می دهد تمام داده های مرتبط با یک Client ID یا User ID را در یک محدوده تاریخ معین بازیابی کنید. در اصل برای حمایت از صاحبان دارایی که می خواهند دسترسی خودکار به داده های کاربر را مستقیماً برای آن کاربر فراهم کنند، در نظر گرفته شده است. برای جزئیات بیشتر به راهنمای API Activity User مراجعه کنید.

این نسخه حداکثر تعداد ردیف های بازگشتی را در مجموعه نتایج Analytics Reporting API v4 افزایش می دهد.

حداکثر تعداد سطرهای بازگشتی در شیء Analytics Reporting API v4 ReportData از 10000 به 100000 افزایش یافته است.

این نسخه پیش نمایشی از سیستم سهمیه مبتنی بر منابع را برای Google Analytics Reporting API نسخه 4 اضافه می کند که امکان استفاده از آستانه نمونه برداری بالاتر را برای مشتریان Analytics 360 (Premium) فراهم می کند.

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

این نسخه ابعاد و معیارهای زیر را منسوخ می‌کند:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

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

زمان

  • بعد جدید ga:dateHourMinute که ترکیبی از ga:date ، ga:hour و ga:minute .

حذف داده ها

این نسخه، ابعاد و معیارهای منسوخ شده زیر را حذف می‌کند:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

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

معیارهای کاربر

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

معیارهای کاربر تحت تأثیر به‌روزرسانی محاسبات:

  • ga:users - تعداد کل کاربران برای دوره زمانی درخواستی.
  • ga:1dayusers - تعداد کل کاربران فعال 1 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:7dayusers - تعداد کل کاربران فعال 7 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:14dayusers - تعداد کل کاربران فعال 14 روزه برای هر روز در بازه زمانی درخواستی.
  • ga:30dayusers - تعداد کل کاربران فعال 30 روزه برای هر روز در بازه زمانی درخواستی.

رویدادهای منحصر به فرد

به پایان دوره زمانی منسوخ شدن ga:uniqueEvents نزدیک می شویم. پس از 26 مارس 2017، تعریف ga:uniqueEvents به‌روزرسانی می‌شود و معیار خصوصی ga:uniqueEventsTemporary از API حذف می‌شود. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.

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

ابعاد کاربر

پیغام خطا

در جایی که قبلاً API یک پیام خطای اشتباه، Unknown dimension(s): یا Unknown metric(s): هنگام درخواست داده با شرایطی که برآورده نشده‌اند، API اکنون این پیام را برمی‌گرداند: Restricted metric(s): ... can only be queried under certain conditions.

ابعاد و معیارهای AdSense

نماهای مرتبط با AdSense از پرس و جو برای ابعاد و معیارهای AdSense محدود خواهند شد. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.

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

ابعاد و معیارهای AdSense

این نسخه مشکلی را برطرف می‌کند که از 1/7/2017 شروع شده بود که در آن پرس و جو برای ابعاد و معیارهای AdSense خطای «متریک ناشناخته» را برای بازدیدهای غیر مرتبط با AdSense نشان می‌داد.

تغییرات آینده

در یا بعد از 1/31/2017 بازدیدهای غیر مرتبط با AdSense از درخواست برای ابعاد و معیارهای AdSense محدود می‌شوند. پرس و جو برای این ابعاد و معیارها با بازدیدهای غیر مرتبط با AdSense منجر به خطا می شود.

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

معیارهای محاسبه شده

این نسخه پشتیبانی از معیارهای محاسبه شده را اضافه می کند.

  • متریک - ga:calcMetric_ - مقدار متریک محاسبه شده درخواستی، که در آن به نام متریک محاسبه شده توسط کاربر اشاره دارد. توجه داشته باشید که نوع داده ga:calcMetric_ می تواند شناور، عدد صحیح، ارز، زمان یا درصد باشد. برای جزئیات، درباره معیارهای محاسبه شده را ببینید.

این نسخه یک معیار جدید به API اضافه می کند. همچنین یک معیار موجود را منسوخ می کند . برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

ردیابی رویداد

تعریف ga:uniqueEvents تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. برای تأثیرگذاری بر این تغییر، از لحاظ فنی معیار ga:uniqueEvents فعلی را مطابق با خط‌مشی منسوخ شدن داده‌های خود منسوخ خواهیم کرد. اگر می‌خواهید تعریف جدید را امتحان کنید، می‌توانید به معیار خصوصی ga:uniqueEventsTemporary مراجعه کنید، که با دقت بیشتری تعداد رویدادهای منحصر به فرد را محاسبه می‌کند. ما همچنین یک متریک جدید ga:uniqueDimensionCombinations را معرفی خواهیم کرد که تعریف فعلی ga:uniqueEvents را حفظ می کند. پس از دوره زمانی منسوخ شدن مناسب (تقریباً 6 ماه)، متریک خصوصی ga:uniqueEventsTemporary حذف خواهد شد و متریک اصلی ga:uniqueEvents به درستی تعداد رویدادهای منحصر به فرد را نشان خواهد داد. برای اطلاعات بیشتر، به اسناد راهنمای رویدادهای منحصر به فرد مراجعه کنید.

رویدادهای منحصر به فرد

  • متریک - ga:uniqueEvents - تعریف ga:uniqueEvents به زودی تغییر خواهد کرد تا تعداد رویدادهای منحصر به فرد را با دقت بیشتری منعکس کند. اگر می‌خواهید تعریف موجود را حفظ کنید، لطفاً به جای آن از ga:uniqueDimensionCombinations استفاده کنید. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.
  • Metric - ga:uniqueDimensionCombinations - Unique Dimension Combinations تعداد ترکیب‌های بعد-مقدار منحصر به فرد را برای هر بعد در یک گزارش می‌شمارد. این به شما امکان می‌دهد ابعاد ترکیبی (پیوسته) را پس از پردازش بسازید، که امکان گزارش انعطاف‌پذیرتر را بدون نیاز به به‌روزرسانی پیاده‌سازی ردیابی یا استفاده از شکاف‌های بعدی سفارشی اضافی فراهم می‌کند. برای اطلاعات بیشتر، اسناد راهنمای رویدادهای منحصر به فرد را ببینید.

تست انتقال - خصوصی

  • متریک - ga:uniqueEventsTemporary - تعداد رویدادهای منحصر به فرد. این تعریف جدید برای ga:uniqueEvents خواهد بود. می توانید از این معیار برای درک تعریف جدید قبل از تغییر استفاده کنید. توجه داشته باشید که این معیار خصوصی است و در مرجع ابعاد و معیارها نشان داده نخواهد شد.

این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

DoubleClick Bid Manager

  • بعد - ga:dbmClickAdvertiser - نام تبلیغ‌کننده DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickAdvertiserId - شناسه تبلیغ‌کننده DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickCreativeId - شناسه خلاق DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Dimension - ga:dbmClickExchange - نام تبادل DBM کلیک DBM که با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickExchangeId - شناسه تبادل DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد).
  • بعد - ga:dbmClickInsertionOrder - نام سفارش درج DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد).
  • بعد - ga:dbmClickInsertionOrderId - شناسه ترتیب درج DBM کلیک DBM مطابق با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickLineItem - نام مورد خط DBM کلیک DBM با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد).
  • بعد - ga:dbmClickLineItemId - شناسه مورد خط DBM کلیک DBM با جلسه Google Analytics مطابقت دارد (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickSite - نام سایت DBM که در آن خلاقیت DBM نشان داده شده و برای کلیک DBM مطابق با جلسه Google Analytics روی آن کلیک شده است (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmClickSiteId - شناسه سایت DBM که در آن خلاقیت DBM نشان داده شده و برای کلیک DBM مطابق با جلسه Google Analytics روی آن کلیک شده است (فقط Analytics 360، نیاز به یکپارچه سازی با DBM دارد).
  • بعد - ga:dbmLastEventAdvertiser - نام تبلیغ‌کننده DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به یکپارچه‌سازی با DBM دارد).
  • بعد - ga:dbmLastEventAdvertiserId - شناسه تبلیغ‌کننده DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventCreativeId - شناسه خلاق DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventExchange - نام تبادل DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventExchangeId - شناسه تبادل DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventInsertionOrder - نام سفارش درج DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventInsertionOrderId - شناسه سفارش درج DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • ابعاد - ga:dbmLastEventLineItem - نام مورد خط DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventLineItemId - شناسه مورد خط DBM آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • بعد - ga:dbmLastEventSite - نام سایت DBM که در آن خلاقیت DBM برای آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد) نشان داده شده و روی آن کلیک شده است.
  • بعد - ga:dbmLastEventSiteId - شناسه سایت DBM که در آن خلاقیت DBM برای آخرین رویداد DBM (نمایش یا کلیک در پنجره بازبینی DBM) مرتبط با جلسه Google Analytics (فقط Analytics 360، نیاز به ادغام با DBM دارد) نشان داده شد و روی آن کلیک کرد.
  • متریک - ga:dbmCPA - eCPA درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • متریک - ga:dbmCPC - eCPC درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • متریک - ga:dbmCPM - eCPM درآمد DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • متریک - ga:dbmCTR - DBM CTR (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • متریک - ga:dbmClicks - کل کلیک‌های DBM (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Metric - ga:dbmConversions - DBM Total Conversions (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Metric - ga:dbmCost - DBM Cost (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Metric - ga:dbmImpressions - DBM Total Impressions (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Metric - ga:dbmROAS - DBM ROAS (فقط Analytics 360، نیاز به ادغام با DBM دارد).
  • Dimension - ga:dsAdGroup - DS Ad Group (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsAdGroupId - DS Ad Group ID (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsAdvertiser - DS Advertiser (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsAdvertiserId - DS Advertiser ID (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsAgency - DS Agency (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsAgencyId - DS Agency ID (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsCampaign - DS Campaign (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsCampaignId - DS Campaign ID (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsEngineAccount - DS Engine Account (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsEngineAccountId - شناسه حساب موتور DS (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsKeyword - DS Keyword (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • Dimension - ga:dsKeywordId - DS Keyword ID (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsCPC - هزینه DS برای تبلیغ کننده در هر کلیک (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsCTR - نرخ کلیک DS (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsClicks - DS Clicks (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsCost - DS Cost (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsImpressions - DS Impressions (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsProfit - DS Profie (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsReturnOnAdSpend - DS Return On Ad Spend (فقط Analytics 360، نیاز به ادغام با DS دارد).
  • ga:dsRevenuePerClick - DS Revenue Per Click (فقط Analytics 360، نیاز به ادغام با DS دارد).

این نسخه بعد جدیدی به API اضافه می کند. این نسخه همچنین محدودیت‌های خاصی را در ترکیب ابعادی که می‌توان با هم جستجو کرد اضافه می‌کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

شبکه جغرافیایی

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

محدودیت های

ابعاد زیر در گروه های زیر را نمی توان با ابعاد در گروه های دیگر جستجو کرد:

  • از گروه اطلاعات خرید دیدن کنید
    • ga:checkoutOptions
    • ga:shoppingStage
  • گروه آزمایشی GWO
    • ga:experimentVariant
    • ga:experimentId
  • گروه علاقه مندی
    • ga:interestOtherCategory
  • در گروه علاقه بازار
    • ga:interestInMarketCategory
  • گروه تبلیغات داخلی:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • گروه مورد علاقه برندینگ:
    • ga:interestAffinityCategory

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

گزارش خطاها

این نسخه شروع به اعمال محدودیت در درخواست های گزارش ناموفق ( 5XX ) می کند.

  • 10 درخواست ناموفق برای هر پروژه در هر نمایه در ساعت.
  • 50 درخواست ناموفق برای هر پروژه در هر نمایه در روز.

محدودیت های محوری

این نسخه شروع به اعمال محدودیت در درخواست های محوری می کند:

  • یک درخواست گزارش اکنون می تواند حداکثر 2 محور داشته باشد.
  • یک محور حداکثر می تواند 4 بعد داشته باشد.
  • ابعاد محوری بخشی از محدودیت در تعداد کل ابعاد مجاز در درخواست است.
  • معیارهای محوری بخشی از محدودیت در تعداد کل معیارهای مجاز در درخواست هستند.

این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

شبکه جغرافیایی

  • بعد - ga:metroId - کد سه رقمی منطقه بازار تعیین شده (DMA) از جایی که ترافیک وارد شده است، که از آدرس های IP یا شناسه های جغرافیایی کاربران مشتق شده است.

DoubleClick for Publishers

  • متریک - ga:dfpImpressions - هر زمان که یک تبلیغ منفرد در وب سایت نمایش داده می شود، نمایش تبلیغ DFP گزارش می شود. به عنوان مثال، اگر یک صفحه با دو واحد تبلیغاتی یک بار مشاهده شود، دو نمایش نمایش داده می‌شود (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:dfpCoverage - پوشش درصدی از درخواست‌های تبلیغاتی است که حداقل یک آگهی را برگردانده است. به طور کلی، پوشش می تواند به شناسایی سایت هایی که حساب DFP قادر به ارائه تبلیغات هدفمند نیست کمک کند. (نمایش آگهی / مجموع درخواست های آگهی) * 100 (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:dfpMonetizedPageviews - این تعداد کل بازدیدهای صفحه در دارایی را که با یک تبلیغ از حساب DFP پیوند شده نشان داده شده است اندازه گیری می کند. توجه داشته باشید که یک صفحه می‌تواند چندین واحد تبلیغاتی داشته باشد (پیوند دادن DFP فعال است و درآمد DFP پنهان نشده است).
  • متریک - ga:dfpImpressionsPerSession - نسبت نمایش‌های تبلیغات DFP به جلسات آنالیز (Ad Impressions / Analytics Sessions) (پیوند DFP فعال است و درآمد DFP را پنهان کنید فعال نیست).
  • متریک - ga:dfpViewableImpressionsPercent - درصد نمایش‌های تبلیغاتی قابل مشاهده. یک نمایش زمانی که در مرورگرهای کاربران ظاهر شده باشد و فرصت دیده شدن را داشته باشد، یک نمایش قابل مشاهده در نظر گرفته می‌شود (پیوند DFP فعال است و درآمد DFP پنهان نشده است).
  • متریک - ga:dfpClicks - تعداد دفعاتی که تبلیغات DFP روی سایت کلیک شده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).
  • متریک - ga:dfpCTR - درصد بازدید از صفحه که منجر به کلیک روی یک تبلیغ DFP شده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).
  • Metric - ga:dfpRevenue - درآمد DFP تخمینی از کل درآمد تبلیغات بر اساس نمایش‌های ارائه‌شده است (پیوند DFP فعال و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:dfpRevenuePer1000Sessions - کل درآمد تخمینی از تبلیغات DFP در هر 1000 جلسه Analytics. توجه داشته باشید که این معیار براساس جلسات سایت است، نه بر اساس نمایش تبلیغات (پیوند DFP فعال است و درآمد DFP پنهان نشده است).»
  • متریک - ga:dfpECPM - هزینه موثر در هر هزار بازدید از صفحه. این درآمد DFP به ازای هر 1000 بازدید از صفحه است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).
  • متریک - ga:backfillImpressions - Backfill Impressions مجموع همه نمایش‌های تبلیغات AdSense یا Ad Exchance است که از طریق DFP به‌عنوان پرکننده استفاده می‌شوند. هر زمان که یک تبلیغ فردی در وب سایت نمایش داده می شود، یک نمایش آگهی گزارش می شود. به عنوان مثال، اگر یک صفحه با دو واحد تبلیغاتی یک بار مشاهده شود، دو نمایش نمایش داده می‌شود (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • Metric - ga:backfillCoverage - Backfill Coverage درصدی از درخواست‌های تبلیغاتی است که حداقل یک آگهی را برگردانده است. به طور کلی، پوشش می تواند به شناسایی سایت هایی کمک کند که حساب ناشر قادر به ارائه تبلیغات هدفمند نیست. (نمایش‌های آگهی / مجموع درخواست‌های آگهی) * 100. اگر هم AdSense و هم Ad Exchange آگهی‌های تکمیلی ارائه می‌دهند، این معیار میانگین وزنی دو حساب تکمیلی است (پیوند DFP فعال است و درآمد DFP فعال نشده است).»
  • متریک - ga:backfillMonetizedPageviews - این تعداد کل بازدیدهای صفحه در دارایی را که با حداقل یک تبلیغ از حساب(های) پرکننده پیوند شده نشان داده شده است، اندازه گیری می کند. توجه داشته باشید که یک بازدید از صفحه واحد پولی می‌تواند شامل چندین نمایش تبلیغاتی باشد (پیوند DFP فعال است و درآمد DFP پنهان نشده است).
  • متریک - ga:backfillImpressionsPerSession - نسبت نمایش‌های تبلیغاتی پس‌پرده به جلسات Analytics (Ad Impressions / Analytics Sessions). اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:backfillViewableImpressionsPercent - درصدی از نمایش‌های تبلیغاتی که قابل مشاهده بودند. یک برداشت زمانی به عنوان یک برداشت قابل مشاهده در نظر گرفته می شود که در مرورگر کاربران ظاهر شده باشد و فرصت دیده شدن داشته باشد. اگر AdSense و Ad Exchange هر دو آگهی‌های پرکننده ارائه می‌دهند، این معیار میانگین وزنی دو حساب پرکننده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).»
  • متریک - ga:backfillClicks - تعداد دفعاتی که تبلیغات backfill روی سایت کلیک شده است. اگر AdSense و Ad Exchange هر دو آگهی‌های پرکننده ارائه می‌دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:backfillCTR - درصد نمایش‌های پرشده که منجر به کلیک روی یک آگهی شده است. اگر AdSense و Ad Exchange هر دو آگهی‌های پرکننده ارائه می‌دهند، این معیار میانگین وزنی دو حساب پرکننده است (پیوند DFP فعال است و درآمد DFP پنهان نشده است).»
  • متریک - ga:backfillRevenue - کل درآمد تخمینی از تبلیغات پشتیبان. اگر AdSense و Ad Exchange هر دو آگهی‌های پرکننده ارائه می‌دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:backfillRevenuePer1000Sessions - کل درآمد تخمینی از تبلیغات پشتیبان در هر 1000 جلسه Analytics. توجه داشته باشید که این معیار براساس جلسات سایت است و نه نمایش تبلیغات. اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).
  • متریک - ga:backfillECPM - هزینه موثر در هر هزار بازدید از صفحه. این درآمد DFP Backfill در هر 1000 بازدید از صفحه است. اگر هم AdSense و هم Ad Exchange تبلیغات پشتیبان ارائه می دهند، این معیار مجموع دو حساب پرکننده است (پیوند DFP فعال است و پنهان کردن درآمد DFP فعال نیست).

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

بخش ها

این نسخه مشکلی را برطرف می‌کند که باعث می‌شود زیرمجموعه‌ای از درخواست‌ها با بخش All Users ( gaid::-1 ) در Core Reporting API V3 کم شمارش شوند و در Analytics Reporting API V4 به دو بخش تقسیم شوند.

نمونه برداری

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

این یک نسخه رفع اشکال است که مشکلی را هنگام ایجاد درخواست‌های گروهی Analytics Reporting API V4 برطرف می‌کند.

درخواست های گروهی

اکنون درخواست‌های همگروهی می‌توانند همه ابعاد همگروهی را درخواست کنند. قبلاً API هنگام درخواست ابعاد ga:acquisition... خطایی را برمی‌گرداند.

درخواست ارزش مادام العمر LTV

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

این نسخه نسخه جدیدی از API را معرفی می کند، Analytics Reporting API V4 . این API جدید پیشرفته ترین روش برنامه نویسی برای دسترسی به داده های گزارش در Google Analytics است.

ویژگی های کلیدی

Google Analytics بر اساس یک زیرساخت گزارش دهی قدرتمند ساخته شده است. API به توسعه دهندگان امکان دسترسی به قدرت پلتفرم Google Analytics را می دهد. برخی از ویژگی های کلیدی در Analytics Reporting API V4 شامل موارد زیر است:

  • عبارات متریک - API به شما امکان می دهد نه تنها معیارهای داخلی بلکه عبارات متریک ریاضی را نیز درخواست کنید. به عنوان مثال، تکمیل هدف به ازای هر تعداد جلسه می‌تواند در درخواست به صورت ga:goal1completions/ga:sessions بیان شود.
  • محدوده تاریخ چندگانه - پشتیبانی از درخواست دو محدوده تاریخ، به شما امکان می دهد داده ها را برای دو دوره در یک درخواست مقایسه کنید.
  • گروه‌ها و ارزش طول عمر - API دارای واژگان غنی برای درخواست گزارش‌های ارزش هم‌گروهی و طول عمر است.
  • چند بخش - اکنون می توانید چندین بخش را در یک درخواست درخواست کنید.

شروع شدن

برای همه جزئیات در مورد شروع کار با API به مستندات توسعه دهنده مراجعه کنید.

خط مشی سهمیه

Analytics Reporting API V4 دارای سهمیه ها و محدودیت های خاص خود است. از آنجایی که این یک API جدید است، این محدودیت ها و سهمیه ها ممکن است تغییر کنند.

مهاجرت

همراه با راهنمای مهاجرت ، ما همچنین یک کتابخانه سازگاری پایتون را در Github در دسترس قرار می دهیم.

ابعاد و متریک

این نسخه همچنین مجموعه ای از ابعاد و معیارها را به طور خاص برای Analytics Reporting API V4 اضافه می کند. برای تعاریف فهرست کامل ، کاوشگر ابعاد و معیارها را ببینید.

  • بعد - ga:cohort - نام گروهی که یک کاربر به آن تعلق دارد بر اساس تعریف گروه‌ها. بسته به نحوه تعریف گروه‌ها، یک کاربر می‌تواند به گروه‌های متعددی تعلق داشته باشد، مشابه اینکه کاربر می‌تواند به چند بخش تعلق داشته باشد.

  • بعد - ga:cohortNthDay - افست روز بر اساس 0 نسبت به تاریخ تعریف گروه. به عنوان مثال، اگر یک گروه با اولین تاریخ بازدید به عنوان 2015-09-01 تعریف شود، برای تاریخ 2015-09-04، ga:cohortNthDay 3 خواهد بود.

  • ga:cohortNthMonth - افست ماه مبتنی بر 0 نسبت به تاریخ تعریف گروه.

  • بعد - ga:cohortNthWeek - افست هفته مبتنی بر 0 نسبت به تاریخ تعریف گروه.

  • بعد - ga:acquisitionTrafficChannel - کانال ترافیکی که از طریق آن کاربر به دست آمده است. از اولین جلسه کاربر استخراج می شود. کانال ترافیک بر اساس قوانین پیش‌فرض گروه‌بندی کانال (در سطح مشاهده در صورت وجود) در زمان جذب کاربر محاسبه می‌شود.

  • Dimension - ga:acquisitionSource - منبعی که کاربر از طریق آن به دست آمده است. برگرفته از اولین جلسه کاربر.

  • Dimension - ga:acquisitionMedium - رسانه ای که از طریق آن کاربر به دست آمده است. برگرفته از اولین جلسه کاربر.

  • Dimension - ga:acquisitionSourceMedium - مقدار ترکیبی ga:userAcquisitionSource و ga:acquisitionMedium.

  • Dimension - ga:acquisitionCampaign کمپینی که از طریق آن کاربر به دست آمده است. برگرفته از اولین جلسه کاربر.

  • متریک - ga:cohortActiveUsers - این معیار در زمینه ابعاد آفست مبتنی بر 0 ( ga:cohortNthDay ، ga:cohortNthWeek ، یا ga:cohortNthMonth ) مرتبط است. این تعداد کاربرانی را در گروه فعال نشان می‌دهد که در پنجره زمانی مربوط به روز/هفته/ماه همگروه فعال هستند. به عنوان مثال، برای ga:cohortNthWeek = 1 ، تعداد کاربران (در گروه) که در هفته دوم فعال هستند. اگر درخواستی هیچ یک از ga:cohortNthDay ، ga:cohortNthWeek ، یا ga:cohortNthMonth را نداشته باشد، این متریک همان مقدار ga:cohortTotalUsers را خواهد داشت.

  • متریک - ga:cohortTotalUsers - تعداد کاربران متعلق به گروه، که به عنوان اندازه کوهورت نیز شناخته می شود.

  • متریک - ga:cohortAppviewsPerUser - بازدیدهای برنامه به ازای هر کاربر برای یک گروه.

  • متریک - ga:cohortGoalCompletionsPerUser - تکمیل هدف برای هر کاربر برای یک گروه.

  • متریک - ga:cohortPageviewsPerUser - بازدید از صفحه به ازای هر کاربر برای یک گروه.

  • متریک - ga:cohortRetentionRate - نرخ حفظ کوهورت.

  • متریک - ga:cohortRevenuePerUser - درآمد هر کاربر برای یک گروه.

  • متریک - ga:cohortVisitDurationPerUser - مدت زمان هر کاربر برای یک گروه.

  • متریک - ga:cohortSessionsPerUser - جلسات به ازای هر کاربر برای یک گروه.

  • Metric - ga:cohortTotalUsersWithLifetimeCriteria - این در زمینه درخواستی که دارای ابعاد ga:acquisitionTrafficChannel ، ga:acquisitionSource ، ga:acquisitionMedium ، یا ga:acquisitionCampaign ، مرتبط است. این تعداد کاربرانی را در گروه‌ها نشان می‌دهد که از طریق کانال، منبع، رسانه یا کمپین فعلی به‌دست می‌آیند. به عنوان مثال، برای ga:acquisitionTrafficChannel=Direct ، تعداد کاربران گروه را نشان می‌دهد که مستقیماً جذب شده‌اند. اگر هیچ یک از ابعاد ذکر شده وجود نداشته باشد، مقدار آن برابر با ga:cohortTotalUsers است.

  • معیار - ga:cohortAppviewsPerUserWithLifetimeCriteria - بازدیدهای برنامه به ازای هر کاربر برای بعد اکتساب برای یک گروه.

  • متریک - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - تکمیل هدف برای هر کاربر برای بعد اکتساب برای یک گروه.

  • معیار - ga:cohortPageviewsPerUserWithLifetimeCriteria - تعداد بازدید از صفحه به ازای هر کاربر برای بعد اکتساب برای یک گروه.

  • معیار - ga:cohortRevenuePerUserWithLifetimeCriteria - درآمد هر کاربر برای بعد اکتساب برای یک گروه.

  • معیار - ga:cohortSessionsPerUserWithLifetimeCriteria - مدت جلسه به ازای هر کاربر برای بعد اکتساب برای یک گروه.

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

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

فعالیت های اجتماعی

این ابعاد و معیارها منسوخ شده اند و پس از 30 سپتامبر 2016 حذف خواهند شد. برای جزئیات بیشتر در مورد حذف داده ها ، خط مشی منسوخ شدن داده ها را مرور کنید:

  • بعد - ga:socialActivityEndorsingUrl - برای یک فعالیت مرکز داده اجتماعی، این نشانی اینترنتی فعالیت اجتماعی است (به عنوان مثال، نشانی اینترنتی پست Google+‎، نشانی اینترنتی نظرات وبلاگ، و غیره).
  • Dimension - ga:socialActivityDisplayName - برای یک فعالیت مرکز داده اجتماعی، این عنوان فعالیت اجتماعی است که توسط کاربران شبکه اجتماعی ارسال شده است.
  • بعد - ga:socialActivityPost - برای یک فعالیت مرکز داده اجتماعی، این محتوای فعالیت اجتماعی است (مثلاً محتوای یک پیام ارسال شده در +Google) که توسط کاربران شبکه اجتماعی پست شده است.
  • Dimension - ga:socialActivityTimestamp - برای یک فعالیت مرکز داده اجتماعی، این زمانی است که فعالیت اجتماعی در شبکه اجتماعی رخ داده است.
  • Dimension - ga:socialActivityUserHandle - برای یک فعالیت مرکز داده اجتماعی، این دسته شبکه اجتماعی (به عنوان مثال، نام یا شناسه) کاربرانی است که فعالیت اجتماعی را آغاز کرده اند."
  • Dimension - ga:socialActivityUserPhotoUrl - برای یک فعالیت مرکز داده اجتماعی، این نشانی اینترنتی عکس مرتبط با نمایه‌های شبکه اجتماعی کاربران است.
  • Dimension - ga:socialActivityUserProfileUrl - برای یک فعالیت مرکز داده اجتماعی، این نشانی اینترنتی نمایه های شبکه اجتماعی کاربران مرتبط است.
  • Dimension - ga:socialActivityTagsSummary - برای یک فعالیت مرکز داده اجتماعی، این مجموعه ای از برچسب های جدا شده با کاما است که مرتبط با فعالیت اجتماعی است.
  • بعد - ga:socialActivityAction - برای یک فعالیت مرکز داده اجتماعی، این نشان دهنده نوع کنش اجتماعی (مثلاً رأی، نظر، 1+ و غیره) مرتبط با فعالیت است.
  • بعد - ga:socialActivityNetworkAction - برای یک فعالیت مرکز داده اجتماعی، این نوع کنش اجتماعی و شبکه اجتماعی است که فعالیت از آنجا شروع شده است.
  • Dimension - ga:socialActivityContentUrl - برای یک فعالیت مرکز داده اجتماعی، این نشانی اینترنتی است که توسط کاربران شبکه اجتماعی مرتبط به اشتراک گذاشته شده است.
  • متریک - ga:socialActivities - تعداد کل فعالیت‌هایی که یک URL محتوا در یک شبکه شریک مرکز داده اجتماعی به اشتراک گذاشته شده یا ذکر شده است.

این نسخه بعد جدیدی به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

پلت فرم یا دستگاه

  • Dimension - ga:browserSize - اندازه درگاه دید مرورگرهای کاربران. اندازه مرورگر یک بعد محدوده جلسه است که ابعاد اولیه نمای درگاه را بر حسب پیکسل ثبت می کند و به صورت عرض X ارتفاع قالب بندی می شود. به عنوان مثال، 1920x960.

این نسخه یک پارامتر جدید به API اضافه می کند.

شامل ردیف های خالی

  • این نسخه پارامتر اختیاری جدید include-empty-rows را اضافه می کند که وقتی روی ردیف های false بدون داده تنظیم شود از پاسخ حذف می شود. مقدار پیش‌فرض true است، که یک تغییر غیرقابل شکست است و به این ترتیب نباید به به‌روزرسانی کد نیاز داشته باشد. برای جزئیات به مستندات مرجع Core Reporting API مراجعه کنید.

این نسخه معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

کاربر

  • متریک - ga:1dayUsers - تعداد کل کاربران فعال 1 روزه برای هر روز در بازه زمانی درخواستی. حداقل یکی از ga:nthDay، ga:date یا ga:day باید به‌عنوان یک بعد مشخص شود تا بتوان این معیار را پرس و جو کرد. برای تاریخ معین، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 1 روزه منتهی به تاریخ معین خواهد بود.
  • متریک - ga:7dayUsers - تعداد کل کاربران فعال 7 روزه برای هر روز در بازه زمانی درخواستی. حداقل یکی از ga:nthDay، ga:date یا ga:day باید به‌عنوان یک بعد مشخص شود تا بتوان این معیار را پرس و جو کرد. برای تاریخ معین، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 7 روزه منتهی به تاریخ معین خواهد بود.
  • متریک - ga:14dayUsers - تعداد کل کاربران فعال 14 روزه برای هر روز در بازه زمانی درخواستی. حداقل یکی از ga:nthDay، ga:date یا ga:day باید به‌عنوان یک بعد مشخص شود تا بتوان این معیار را پرس و جو کرد. برای تاریخ معین، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 14 روزه منتهی به تاریخ معین خواهد بود.
  • متریک - ga:30dayUsers - تعداد کل کاربران فعال 30 روزه برای هر روز در بازه زمانی درخواستی. حداقل یکی از ga:nthDay، ga:date یا ga:day باید به‌عنوان یک بعد مشخص شود تا بتوان این معیار را پرس و جو کرد. برای تاریخ معین، مقدار برگشتی کل کاربران منحصر به فرد برای دوره 30 روزه منتهی به تاریخ معین خواهد بود.

این نسخه معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

DoubleClick Ad Exchange (AdX)

  • متریک - ga:adxCTR - درصد بازدید از صفحه که منجر به کلیک روی یک تبلیغ AdX شده است.
  • متریک - ga:adxClicks - تعداد دفعاتی که تبلیغات AdX روی سایت شما کلیک شده است.
  • متریک - ga:adxCoverage - پوشش درصدی از درخواست‌های تبلیغاتی است که حداقل یک آگهی را برگردانده است. به طور کلی، پوشش می تواند به شما کمک کند سایت هایی را شناسایی کنید که حساب AdX شما قادر به ارائه تبلیغات هدفمند نیست. (نمایش آگهی / مجموع درخواست های آگهی) * 100
  • متریک - ga:adxECPM - هزینه موثر در هر هزار بازدید از صفحه. این درآمد AdX شما در هر 1000 بازدید از صفحه است.
  • متریک - ga:adxImpressions - هر زمان که یک تبلیغ فردی در وب سایت شما نمایش داده می شود، یک نمایش تبلیغات AdX گزارش می شود. به عنوان مثال، اگر یک صفحه با دو واحد تبلیغاتی یک بار مشاهده شود، دو نمایش نمایش داده می شود.
  • متریک - ga:adxImpressionsPerSession - نسبت نمایش تبلیغات AdX به جلسات Analytics (Ad Impressions / Analytics Sessions).
  • متریک - ga:adxMonetizedPageviews - بازدیدهای صفحه پولی شده تعداد کل بازدیدهای صفحه در دارایی شما را که با تبلیغی از حساب AdX پیوند شده شما نشان داده شده است را اندازه گیری می کند. توجه: یک صفحه می تواند چندین واحد تبلیغاتی داشته باشد.
  • متریک - ga:adxRevenue - کل درآمد تخمینی از تبلیغات AdX.
  • متریک - ga:adxRevenuePer1000Sessions - کل درآمد تخمینی از تبلیغات AdX در هر 1000 جلسه Analytics. توجه داشته باشید که این معیار براساس جلسات سایت شما است و نه نمایش تبلیغات.
  • متریک - ga:adxViewableImpressionsPercent - درصد نمایش‌های تبلیغاتی قابل مشاهده. نمایش زمانی به عنوان یک برداشت قابل مشاهده در نظر گرفته می شود که در مرورگر کاربر ظاهر شده باشد و فرصت دیده شدن داشته باشد.

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

ابعاد منسوخ شده

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

  • Dimension - ga:adSlotPosition - به جای آن از ga:adSlot استفاده کنید.
  • Dimension - ga:nextPagePath - به جای آن ga:pagePath استفاده کنید.
  • Dimension - ga:nextContentGroupXX - به جای آن ga:contentGroupXX استفاده کنید.

این نسخه بعد جدیدی به API اضافه می کند. برای فهرست کامل ابعاد و معیارها، مرجع ابعاد و معیارها را مرور کنید.

کلمات پیشنهادی

  • بعد - ga:adQueryWordCount - تعداد کلمات در عبارت جستجو.

این نسخه ابعاد جدیدی به API اضافه می کند. برای فهرست کامل ابعاد و معیارها، مرجع ابعاد و معیارها را مرور کنید.

پلت فرم یا دستگاه

  • Dimension - ga:dataSource - منبع داده یک ضربه. بازدیدهای ارسال شده از ga.js و analytics.js به عنوان "وب" گزارش می شوند. بازدیدهای ارسال شده از SDK های تلفن همراه به عنوان "برنامه" گزارش می شوند. این مقادیر را می توان نادیده گرفت.
  • Dimension - ga:searchAfterDestinationPage - صفحه ای که کاربر پس از انجام جستجوی داخلی در سایت شما از آن بازدید کرده است.

این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند و دو معیار موجود را منسوخ می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را مرور کنید.

تجارت الکترونیک

  • متریک - ga:transactionsPerUser - تعداد کل تراکنش ها تقسیم بر تعداد کل کاربران.
  • متریک - ga:revenuePerUser - کل درآمد فروش ارائه شده در تراکنش بدون احتساب حمل و نقل و مالیات تقسیم بر تعداد کل کاربران.

کاربر

  • متریک - ga:sessionsPerUser - تعداد کل جلسات تقسیم بر تعداد کل کاربران.

شبکه جغرافیایی

  • Dimension - ga:cityId - شناسه‌های شهر کاربران، برگرفته از آدرس‌های IP یا شناسه‌های جغرافیایی.
  • Dimension - ga:countryIsoCode - کد ISO کشور کاربران، برگرفته از آدرس های IP یا شناسه های جغرافیایی. مقادیر به عنوان کد آلفا-2 ISO-3166-1 ارائه شده است.
  • Dimension - ga:regionId - شناسه منطقه کاربران، برگرفته از آدرس های IP یا شناسه های جغرافیایی. در ایالات متحده، منطقه یک ایالت است، مانند نیویورک.
  • Dimension - ga:regionIsoCode - کد ISO منطقه کاربران، برگرفته از آدرس های IP یا شناسه های جغرافیایی. مقادیر به عنوان کد ISO-3166-2 ارائه شده است.
  • Dimension - ga:subContinentCode - کد زیر قاره کاربران، برگرفته از آدرس های IP یا شناسه های جغرافیایی. مثلاً پلینزی یا اروپای شمالی. مقادیر به عنوان کد M.49 UN داده شده است.

DoubleClick Campaign Manager

  • Metric - ga:dcmROAS - DCM Return On Ad Spend (ROAS) (فقط حق بیمه).

معیارهای منسوخ شده

این معیارها منسوخ شده اند. برای جزئیات حذف داده، خط مشی انحلال داده را مرور کنید: + Metric - ga:dcmROI - به جای آن ga:dcmROAS استفاده کنید. + متریک - ga:dcmMargen - به جای آن ga:dcmROAS استفاده کنید.

این نسخه یک معیار جدید به API اضافه می کند و دو معیار موجود را منسوخ می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید.

کلمات پیشنهادی

  • Metric - ga:ROAS - Return On Ad Spend (ROAS) کل درآمد تراکنش و ارزش هدف تقسیم بر هزینه تبلیغات مشتق شده است.

ابعاد و معیارهای منسوخ شده

این ابعاد و معیارها منسوخ شده اند. برای جزئیات در مورد حذف داده ، خط‌مشی انحلال داده را مرور کنید: + Metric - ga:ROI - به جای آن از ga:ROAS استفاده کنید. + متریک - ga:margin - به جای آن ga:ROAS استفاده کنید.

این نسخه معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید.

AdSense

  • متریک - ga:adsenseCoverage - درصد درخواست‌های تبلیغاتی که حداقل یک آگهی را برگرداندند.
  • متریک - ga:adsenseViewableImpressionPercent - درصد نمایش‌هایی که قابل مشاهده بودند.

این نسخه شامل اضافه شدن یک معیار جلسه جدید، یک بعد منابع ترافیک جدید، و ابعاد و معیارهای جدید DoubleClick Campaign Manager است.

ابعاد و متریک

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

جلسه

  • متریک - ga:hits - تعداد کل بازدیدهای ارسال شده به Google Analytics. این معیار همه انواع بازدیدها را جمع می‌کند (مثلاً مشاهده صفحه، رویداد، زمان‌بندی و غیره)

منابع ترافیک

  • Dimension - ga:campaignCode - هنگام استفاده از ردیابی دستی کمپین، مقدار پارامتر ردیابی کمپین utm_id.

DoubleClick Campaign Manager

  • بعد - ga:dcmClickAd - نام تبلیغ DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickAdId - شناسه تبلیغ DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • ابعاد - ga:dcmClickAdType - نام نوع تبلیغ DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickAdTypeId - شناسه نوع تبلیغ DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickAdvertiser - نام تبلیغ‌کننده DCM کلیک DCM که با جلسه Google Analytics مطابقت دارد (فقط حق بیمه).
  • ابعاد - ga:dcmClickAdvertiserId - شناسه تبلیغ‌کننده DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickCampaign - نام کمپین DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickCampaignId - شناسه کمپین DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickCreative - نام خلاق DCM کلیک DCM که با جلسه Google Analytics مطابقت دارد (فقط حق بیمه).
  • بعد - ga:dcmClickCreativeId - شناسه خلاق DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickCreativeType - نام نوع خلاقانه DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • ابعاد - ga:dcmClickCreativeTypeId - شناسه نوع خلاقیت DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • Dimension - ga:dcmClickCreativeVersion - نسخه خلاقانه DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickRenderingId - شناسه رندر DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickSite - نام سایتی که در آن خلاقیت DCM نشان داده شده و برای کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه) کلیک شده است.
  • بعد - ga:dcmClickSiteId - شناسه سایت DCM که در آن خلاقیت DCM نشان داده شد و برای کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه) روی آن کلیک کرد.
  • بعد - ga:dcmClickSitePlacement - نام مکان سایت DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmClickSitePlacementId - شناسه مکان سایت DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • ابعاد - ga:dcmClickSpotId - شناسه پیکربندی Floodlight DCM کلیک DCM مطابق با جلسه Google Analytics (فقط حق بیمه).
  • ابعاد - ga:dcmFloodlightActivity - نام فعالیت DCM Floodlight مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • بعد - ga:dcmFloodlightActivityAndGroup - نام فعالیت DCM Floodlight و نام گروه مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • بعد - ga:dcmFloodlightActivityGroup - نام گروه فعالیت DCM Floodlight مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • ابعاد - ga:dcmFloodlightActivityGroupId - شناسه گروه فعالیت Floodlight DCM مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • ابعاد - ga:dcmFloodlightActivityId - شناسه فعالیت Floodlight DCM مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • ابعاد - ga:dcmFloodlightAdvertiserId - شناسه تبلیغ‌کننده DCM Floodlight مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • ابعاد - ga:dcmFloodlightSpotId - شناسه پیکربندی نورافکن DCM مرتبط با تبدیل نورافکن (فقط حق بیمه).
  • ابعاد - ga:dcmLastEventAd - نام تبلیغ DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventAdId - شناسه تبلیغ DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventAdType - نام نوع تبلیغ DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventAdTypeId - شناسه نوع تبلیغ DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventAdvertiser - نام تبلیغ‌کننده DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventAdvertiserId - شناسه تبلیغ‌کننده DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • Dimension - ga:dcmLastEventAttributionType - دو مقدار ممکن وجود دارد (ClickThrough و ViewThrough). اگر آخرین رویداد DCM مرتبط با جلسه Google Analytics یک کلیک باشد، مقدار آن ClickThrough خواهد بود. اگر آخرین رویداد DCM مرتبط با جلسه Google Analytics یک نمایش تبلیغاتی بود، آنگاه مقدار ViewThrough (فقط حق بیمه) خواهد بود.
  • بعد - ga:dcmLastEventCampaign - نام کمپین DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCampaignId - شناسه کمپین DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCreative - نام خلاق DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCreativeId - شناسه خلاق DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCreativeType - نام نوع خلاقانه DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCreativeTypeId - شناسه نوع خلاقیت DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventCreativeVersion - نسخه خلاقانه DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • ابعاد - ga:dcmLastEventRenderingId - شناسه رندر DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventSite - نام سایتی که در آن خلاقیت DCM برای آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه) نشان داده شد و روی آن کلیک کرد.
  • بعد - ga:dcmLastEventSiteId - شناسه سایت DCM که در آن خلاقیت DCM برای آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه) نشان داده شد و روی آن کلیک کرد.
  • بعد - ga:dcmLastEventSitePlacement - نام مکان سایت DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventSitePlacementId - شناسه مکان سایت DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • بعد - ga:dcmLastEventSpotId - شناسه پیکربندی Floodlight DCM آخرین رویداد DCM (نمایش یا کلیک در پنجره بازبینی DCM) مرتبط با جلسه Google Analytics (فقط حق بیمه).
  • متریک - ga:dcmFloodlightQuantity - تعداد تبدیل‌های DCM Floodlight (فقط حق بیمه).
  • متریک - dcmFloodlightRevenue - درآمد DCM Floodlight (فقط حق بیمه).

این نسخه شامل اضافه شدن ابعاد و معیارهای جدید گروه بندی محتوا است.

ابعاد و متریک

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

گروه بندی محتوا

  • Dimension - ga:landingContentGroupXX - اولین گروه محتوای منطبق در جلسه کاربر.
  • Dimension - ga:nextContentGroupXX - به گروه محتوایی اشاره دارد که پس از گروه محتوای دیگری بازدید شده است.
  • بعد - ga:contentGroupXX - گروه محتوا در یک ویژگی. گروه محتوا مجموعه‌ای از محتوا است که ساختار منطقی را ارائه می‌کند که می‌توان آن را با کد رهگیری یا تطابق عنوان صفحه/url regex یا قوانین از پیش تعریف‌شده تعیین کرد.
  • بعد - ga:previousContentGroupXX - به گروه محتوایی اشاره دارد که قبل از یک گروه محتوای دیگر بازدید شده است.
  • متریک - ga:contentGroupUniqueViewsXX - تعداد صفحات مختلف (یکتا) در یک جلسه برای گروه محتوای مشخص شده. این هر دو pagePath و pageTitle را برای تعیین یکتایی در نظر می گیرد.

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

بخش ها

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

ابعاد و متریک

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

تجارت الکترونیک پیشرفته

  • بعد - ga:internalPromotionCreative - محتوای خلاقانه طراحی شده برای تبلیغات.
  • بعد - ga:internalPromotionId - شناسه ای که برای تبلیغ استفاده می کنید.
  • بعد - ga:internalPromotionName - نام تبلیغ.
  • بعد - ga:internalPromotionPosition - موقعیت تبلیغ در صفحه وب یا صفحه برنامه.
  • ابعاد - ga:orderCouponCode - کد برای کوپن سطح سفارش.
  • ابعاد - ga:productBrand - نام تجاری که محصول تحت آن فروخته می شود.
  • بعد - ga:productCategoryHierarchy - دسته سلسله مراتبی که محصول در آن طبقه بندی می شود (Enhanced Ecommerce).
  • بعد - ga:productCategoryLevelXX - سطح (1-5) در سلسله مراتب دسته بندی محصول، از بالا شروع می شود.
  • ابعاد - ga:productCouponCode - کد کوپن در سطح محصول.
  • Dimension - ga:productListName - نام لیست محصولی که محصول در آن ظاهر می شود.
  • بعد - ga:productListPosition - موقعیت محصول در لیست محصول.
  • ابعاد - ga:productVariant - تنوع خاص یک محصول، به عنوان مثال، XS، S، M، L برای اندازه یا قرمز، آبی، سبز، سیاه برای رنگ.
  • ابعاد - ga:checkoutOptions - گزینه های کاربر مشخص شده در طول فرآیند پرداخت، به عنوان مثال، FedEx، DHL، UPS برای گزینه های تحویل یا Visa، MasterCard، AmEx برای گزینه های پرداخت. این بعد باید در کنار استیج خرید استفاده شود.
  • بعد - ga:shoppingStage - مراحل مختلف تجربه خرید که کاربران در یک جلسه تکمیل کردند، به عنوان مثال، PRODUCT_VIEW، ADD_TO_CART، CHECKOUT و غیره.
  • متریک - ga:internalPromotionCTR - میزان کلیک کاربران برای مشاهده تبلیغات داخلی (تعداد کلیک / تعداد دفعاتی که تبلیغ ظاهر شد).
  • متریک - ga:internalPromotionClicks - تعداد کلیک‌ها روی یک تبلیغ داخلی.
  • متریک - ga:internalPromotionViews - تعداد بازدیدهای یک تبلیغ داخلی.
  • متریک - ga:localProductRefundAmount - مبلغ بازپرداخت برای یک محصول معین به ارز محلی.
  • متریک - ga:localRefundAmount - کل مبلغ بازپرداخت برای تراکنش به ارز محلی.
  • متریک - ga:productAddsToCart - تعداد دفعاتی که محصول به سبد خرید اضافه شده است.
  • متریک - ga:productCheckouts - تعداد دفعاتی که محصول در فرآیند تسویه حساب گنجانده شده است.
  • متریک - ga:productDetailViews - تعداد دفعاتی که کاربران صفحه جزئیات محصول را مشاهده کردند.
  • متریک - ga:productListClicks - تعداد دفعاتی که کاربران روی محصول وقتی در لیست محصول ظاهر شد کلیک کردند.
  • متریک - ga:productListViews - تعداد دفعاتی که محصول در لیست محصول ظاهر شده است.
  • متریک - ga:productListCTR - نرخی که کاربران روی محصول در لیست محصول کلیک کردند.
  • متریک - ga:productRefunds - تعداد دفعاتی که بازپرداخت برای محصول صادر شده است.
  • متریک - ga:productRefundAmount - کل مبلغ بازپرداخت مرتبط با محصول.
  • متریک - ga:productRemovesFromCart - تعداد دفعاتی که محصول از سبد خرید حذف شده است.
  • متریک - ga:productRevenuePerPurchase - میانگین درآمد محصول در هر خرید (که معمولاً با کد کوپن محصول استفاده می شود).
  • متریک - ga:buyToDetailRate - خریدهای منحصر به فرد تقسیم بر نماهای صفحات جزئیات محصول.
  • متریک - ga:cartToDetailRate - اضافه‌های محصول تقسیم بر نماهای جزئیات محصول.
  • متریک - ga:quantityAddedToCart - تعداد واحدهای محصول اضافه شده به سبد خرید.
  • متریک - ga:quantityCheckedOut - تعداد واحدهای محصول موجود در پرداخت.
  • متریک - ga:quantityRefunded - تعداد واحدهای محصول بازپرداخت شده.
  • متریک - ga:quantityRemovedFromCart - تعداد واحدهای محصول حذف شده از سبد خرید.
  • متریک - ga:refundAmount - مبلغ ارز بازپرداخت شده برای یک تراکنش.
  • متریک - ga:totalRefunds - تعداد بازپرداخت هایی که صادر شده است.

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

ابعاد و متریک

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

سیستم

  • Dimension - ga:sourcePropertyDisplayName - نام نمایش ویژگی منبع ویژگی های جمع آوری شده. این فقط برای ویژگی های جمع آوری معتبر است.
  • بعد - ga:sourcePropertyTrackingId - شناسه ردیابی ویژگی منبع ویژگی های جمع آوری شده. این فقط برای ویژگی های جمع آوری معتبر است

گروه بندی کانال

  • Dimension - ga:channelGrouping - گروه بندی کانال پیش فرض که در نمای (نمایه) به اشتراک گذاشته می شود.
  • ابعاد - ga:correlationModelId - شناسه مدل همبستگی برای محصولات مرتبط.
  • ابعاد - ga:queryProductId - شناسه محصول مورد درخواست.
  • Dimension - ga:queryProductName - نام محصول مورد نظر.
  • ابعاد - ga:queryProductVariation - تنوع محصول مورد نظر.
  • ابعاد - ga:relatedProductId - شناسه محصول مرتبط.
  • Dimension - ga:relatedProductName - نام محصول مرتبط.
  • ابعاد - ga:relatedProductVariation - تنوع محصول مرتبط.
  • متریک - ga:correlationScore - امتیاز همبستگی برای محصولات مرتبط.
  • متریک - ga:queryProductQuantity - مقدار محصول مورد نظر.
  • متریک - ga:relatedProductQuantity - مقدار محصول مرتبط.

تصحیح نام ستون سرصفحه

  • یک اشکال در نسخه 2014/04/16 وجود داشت. اگر یک بعد یا متریک منسوخ شده را درخواست کردید، API سرصفحه های ستون را با بعد یا متریک جایگزین برمی گرداند. اکنون به درستی همان بعد یا نام متریک استفاده شده در درخواست را برمی گرداند.

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

ابعاد و معیارهای جدید

ابعاد زیر به Core Reporting API اضافه شده است:

کلمات پیشنهادی

  • بعد - ga:isTrueViewVideoAd - Yes یا No - نشان می دهد که آیا تبلیغ یک تبلیغ ویدیویی AdWords TrueView است یا خیر.

زمان

  • بعد - ga:nthHour - فهرست برای هر ساعت در محدوده تاریخ مشخص شده. شاخص برای ساعت اول روز اول (یعنی تاریخ شروع) در محدوده تاریخ 0، 1 برای ساعت بعد و غیره است.

تغییر نام ابعاد و متریک

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

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

حضار

  • Dimension - ga:visitorAgeBracket - به جای آن ga:userAgeBracket استفاده کنید.
  • Dimension - ga:visitorGender - به جای آن ga:userGender استفاده کنید.

تجارت الکترونیک

  • متریک - ga:transactionRevenuePerVisit - به جای آن ga:transactionRevenuePerSession استفاده کنید.
  • متریک - ga:transactionsPerVisit - به جای آن ga:transactionsPerSession استفاده کنید.

ردیابی رویداد

  • متریک - ga:eventsPerVisitWithEvent - به جای آن ga:eventsPerSessionWithEvent استفاده کنید.
  • متریک - ga:visitsWithEvent - به جای آن ga:sessionsWithEvent استفاده کنید.

تبدیل های هدف

  • متریک - ga:goalValuePerVisit - به جای آن ga:goalValuePerSession استفاده کنید.
  • متریک - ga:percentVisitsWithSearch - به جای آن ga:percentSessionsWithSearch استفاده کنید.
  • متریک - ga:searchVisits - به جای آن ga:searchSessions استفاده کنید.

ردیابی صفحه

  • متریک - ga:pageviewsPerVisit - به جای آن ga:pageviewsPerSession استفاده کنید.

جلسه

  • Dimension - ga:visitLength - به جای آن ga:sessionDurationBucket استفاده کنید.
  • متریک - ga:avgTimeOnSite - به جای آن ga:avgSessionDuration استفاده کنید.
  • متریک - ga:timeOnSite - به جای آن ga:sessionDuration استفاده کنید.
  • متریک - ga:visitBounceRate - به جای آن ga:bounceRate استفاده کنید.
  • متریک - ga:visits - به جای آن از ga:sessions استفاده کنید.

تعاملات اجتماعی

  • Dimension - ga:socialInteractionNetworkActionVisit - به جای آن ga:socialInteractionNetworkActionSession استفاده کنید.
  • متریک - ga:socialInteractionsPerVisit - به جای آن ga:socialInteractionsPerSession استفاده کنید.

کاربر

  • Dimension - ga:daysSinceLastVisit - به جای آن ga:daysSinceLastSession استفاده کنید.
  • Dimension - ga:visitCount - به جای آن ga:sessionCount استفاده کنید.
  • Dimension - ga:visitorType - به جای آن از ga:userType استفاده کنید.
  • Dimension - ga:visitsToTransaction - به جای آن ga:sessionsToTransaction استفاده کنید.
  • متریک - ga:newVisits - به جای آن ga:newUsers استفاده کنید.
  • متریک - ga:percentNewVisits - به جای آن ga:percentNewSessions استفاده کنید.
  • متریک - ga:visitors - به جای آن از ga:users استفاده کنید.

بخش ها: Core Reporting API نسخه 2.4 و نسخه 3.0

پشتیبانی از بخش های جدید در Core Reporting API.

  • پارامتر segment اکنون از بخش های کاربر و دنباله پشتیبانی می کند. بخش های سطح کاربر و سطح جلسه ایجاد شده در رابط وب را می توان با پارامتر segment جستجو کرد.
  • یک نحو جدید برای بخش های پویا برای استفاده با پارامتر segment در دسترس است. برای جزئیات بیشتر به راهنمای توسعه بخش بخش ها مراجعه کنید
  • dynamic:: منسوخ شده است. توصیه می شود در اسرع وقت به سینتکس جدید مهاجرت کنید.

این نسخه شامل قالب جدید پاسخ جدول داده ها و افزودن و حذف ابعاد و معیارها است (برای فهرست کامل تعاریف ، مرجع ابعاد و معیارها را مرور کنید).

خروجی جدول داده ها

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

  • یک پارامتر درخواست output اختیاری به API اضافه شده است. می توان از آن برای انتخاب فرمت خروجی داده های Analytics در پاسخ استفاده کرد که به طور پیش فرض JSON است. اگر روی datatable تنظیم شود، یک ویژگی dataTable که حاوی یک شی جدول داده است در پاسخ گنجانده می شود. این شی را می توان مستقیماً با نمودارهای Google استفاده کرد. برای جزئیات به مرجع Core Reporting API مراجعه کنید.

ابعاد و معیارهای جدید

ابعاد و معیارهای زیر به Core Reporting API اضافه شده است:

زمان

  • Dimension - ga:minute - دقیقه را در ساعت برمی گرداند. مقادیر ممکن بین 00 و 59 هستند.
  • بعد - ga:nthMinute - فهرست برای هر دقیقه در محدوده تاریخ مشخص شده. شاخص برای دقیقه اول روز اول (یعنی، تاریخ شروع) در محدوده تاریخ 0 ، 1 برای دقیقه بعد و غیره است.

حضار

  • بعد - ga:visitorAgeBracket - براکت سنی بازدیدکننده.
  • بعد - ga:visitorGender - جنسیت بازدید کننده.
  • Dimension - ga:interestAffinityCategory - نشان می دهد که کاربران تمایل بیشتری به یادگیری در مورد دسته مشخص شده دارند.
  • Dimension - ga:interestInMarketCategory - نشان می دهد که کاربران تمایل بیشتری به خرید محصولات یا خدمات در دسته مشخص شده دارند.
  • Dimension - ga:interestOtherCategory - نشان می دهد که کاربران تمایل بیشتری به یادگیری در مورد دسته مشخص شده دارند و به احتمال زیاد آماده خرید هستند.

ابعاد و معیارهای مجاز در بخش‌ها

اکنون می‌توان از این ابعاد و معیارها در بخش‌ها استفاده کرد:

  • بعد - ga:sourceMedium - مقادیر ترکیبی ga:source و ga:medium .
  • متریک - ga:localItemRevenue - درآمد محصول به ارز محلی.

ابعاد و معیارهای منسوخ شده

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

  • Dimension - ga:isMobile - به جای آن از ga:deviceCategory استفاده کنید (به عنوان مثال، ga:deviceCategory==mobile ).
  • Dimension - ga:isTablet - به جای آن از ga:deviceCategory استفاده کنید (به عنوان مثال، ga:deviceCategory==tablet ).
  • متریک - ga:entranceBounceRate - به جای آن ga:visitBounceRate استفاده کنید.

این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید.

Adsense

  • دسترسی به داده های Adsense اضافه شده است:

    • Met - ga:adsenseRevenue - کل درآمد حاصل از تبلیغات AdSense.
    • Met - ga:adsenseAdUnitsViewed - تعداد واحدهای تبلیغات AdSense مشاهده شده. واحد تبلیغات مجموعه ای از تبلیغات است که در نتیجه یک قطعه از کد تبلیغات AdSense نمایش داده می شود. جزئیات: https://support.google.com/adsense/answer/32715 .
    • Met - ga:adsenseAdsViewed - تعداد تبلیغات AdSense مشاهده شده. تبلیغات چندگانه را می توان در یک واحد تبلیغاتی نمایش داد.
    • Met - ga:adsenseAdsClicks - تعداد دفعاتی که تبلیغات AdSense در سایت شما کلیک شده است.
    • Met - ga:adsensePageImpressions - تعداد بازدید از صفحه که طی آن یک تبلیغ AdSense نمایش داده شده است. نمایش صفحه می تواند چندین واحد تبلیغاتی داشته باشد.
    • Met - ga:adsenseCTR - درصدی از نمایش صفحه که منجر به کلیک روی یک تبلیغ AdSense شده است. ( ga:adsenseAdsClicks/ga:adsensePageImpressions )
    • Met - ga:adsenseECPM - هزینه تخمینی به ازای هر هزار نمایش صفحه. این درآمد AdSense شما در هر 1000 نمایش صفحه است. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Met - ga:adsenseExits - تعداد جلساتی که به دلیل کلیک کاربر روی تبلیغ AdSense به پایان رسید.

زمان

  • Dim - ga:isoYear - سال ISO بازدید. جزئیات: http://en.wikipedia.org/wiki/ISO_week_date . ga:isoYear باید فقط با ga:isoWeek استفاده شود زیرا ga:week نشان دهنده تقویم میلادی است.
  • Dim - ga:isoYearIsoWeek - مقادیر ترکیبی ga:isoYear و ga:isoWeek .

کلمات پیشنهادی

  • این داده ها در گزارش های Adwords یافت می شوند:

    • کم نور - ga:adKeywordMatchType - انواع تطابق اعمال شده برای کلمات کلیدی شما (عبارت، دقیق، گسترده). جزئیات: درک گزارش عبارات جستجو .

کنترل اندازه نمونه جدید و ویژگی های تاریخ نسبی

تاریخ های نسبی
  • پشتیبانی از تاریخ های نسبی به Core Reporting API اضافه شده است. today ، yesterday و NdaysAgo اکنون مقادیر معتبری برای پارامترهای جستجوی start-date و end-date هستند.
  • استفاده از این مقادیر به طور خودکار محدوده تاریخ را بر اساس تاریخ فعلی در زمان انجام پرس و جو و بر اساس منطقه زمانی نمای (نمایه) مشخص شده در پرس و جو تعیین می کند. برای جزئیات بیشتر به مرجع API مراجعه کنید.
سطح نمونه برداری
  • پارامتر جدیدی به نام samplingLevel معرفی شده است که به شما امکان می دهد سطح نمونه برداری (یعنی تعداد بازدیدهایی که برای محاسبه نتیجه استفاده می شود) را برای یک درخواست گزارش تنظیم کنید. مقادیر مجاز عبارتند از: DEFAULT ، FASTER ، و HIGHER_PRECISION .
  • 2 فیلد جدید به API Response اضافه شده است: sampleSize و sampleSpace . می توانید از این مقادیر برای محاسبه درصد بازدیدهایی که برای یک پاسخ نمونه استفاده شده است استفاده کنید.
  • برای جزئیات بیشتر به مرجع API و نمونه برداری مراجعه کنید.

رفع اشکال

  • ga:adwordsCustomerID اکنون به درستی شناسه مشتری AdWords 10 رقمی مربوط به AdWords API AccountInfo.customerId را برمی گرداند. این اصلاح، پیوستن به داده های Analytics را با چندین حساب AdWords امکان پذیر می کند.

به عنوان بخشی از راه‌اندازی بخش‌های جدید ، تغییرات زیر را در Core Reporting API اعمال خواهیم کرد.

  • پارامتر segment اکنون از شناسه الفبایی جدید برای بخش‌های پیشرفته سفارشی پشتیبانی می‌کند که در مجموعه مدیریت API Segments برگردانده می‌شود.
  • شناسه‌های عددی فعلی برای بخش‌های سفارشی اکنون در حال منسوخ شدن هستند. این شناسه های قدیمی به مدت 6 ماه پشتیبانی خواهند شد. ما برنامه‌هایی را که شناسه‌های بخش کاربر را ذخیره می‌کنند، توصیه می‌کنیم تا به شناسه‌های الفبایی عددی جدید جابجا شوند. پس از پایان دوره منسوخ شدن، هر درخواستی با شناسه های عددی قدیمی یک خطا برمی گرداند.
  • در حال حاضر، فقط بخش های سطح بازدید ایجاد شده در رابط وب از طریق پارامتر segment قابل پرس و جو خواهند بود.
  • بخش‌های پیش‌فرض موجود با شناسه‌های عددی منفی تحت تأثیر قرار نخواهند گرفت. با این حال، بخش های پیش فرض جدید در حال حاضر پشتیبانی نمی شوند.

این نسخه ابعاد و معیارهای جدیدی را به API اضافه می کند. برای فهرست کامل تعاریف ، مرجع ابعاد و متریک را بررسی کنید.

ردیابی برنامه

  • این داده‌ها در گزارش‌های نمایه برنامه یافت می‌شوند:
    • Dim - ga:appId - شناسه برنامه.
    • Dim - ga:appInstallerId - شناسه نصب کننده (به عنوان مثال، فروشگاه Google Play) که برنامه از آن دانلود شده است. به طور پیش فرض، شناسه نصب کننده برنامه بر اساس روش PackageManager#getInstallerPackageName تنظیم می شود.
    • Dim - ga:appName - نام برنامه.
    • Dim - ga:appVersion - نسخه برنامه.
    • Dim - ga:exitScreenName - نام صفحه هنگام خروج کاربر از برنامه.
    • Dim - ga:landingScreenName - نام اولین صفحه مشاهده شده.
    • کم نور - ga:screenDepth - تعداد بازدید از صفحه نمایش در هر جلسه به عنوان یک رشته گزارش شده است. می تواند برای هیستورگرام مفید باشد.
    • Dim - ga:screenName - نام صفحه نمایش.
    • Met - ga:avgScreenviewDuration - میانگین زمانی که کاربران بر روی یک صفحه نمایش در چند ثانیه سپری می کنند.
    • Met - ga:timeOnScreen - زمان صرف شده برای مشاهده صفحه فعلی.
    • Met - ga:screenviews - تعداد کل بازدیدهای صفحه. از این به جای ga:appviews استفاده کنید.
    • Met - ga:uniqueScreenviews - تعداد ga:screenviews مختلف (یکتا) در یک جلسه. از این به جای ga:uniqueAppviews استفاده کنید.
    • Met - ga:screenviewsPerSession - میانگین تعداد ga:screenviews در هر جلسه. از این به جای ga:appviewsPerVisit استفاده کنید.

منسوخ

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

  • Met - ga:appviews - به جای آن از ga:screenviews استفاده کنید.
  • Met - ga:uniqueAppviews - به جای آن ga:uniqueScreenviews استفاده کنید.
  • Met - ga:appviewsPerVisit - به جای آن ga:screenviewsPerSession استفاده کنید.

متغیرها یا ستون های سفارشی

  • دسترسی به ابعاد و معیارهای سفارشی:

    • Dim - ga:dimensionXX - نام بعد سفارشی درخواستی، جایی که XX به عدد/شاخص بعد سفارشی اشاره دارد.
    • Met - ga:metricXX - نام معیار سفارشی درخواستی، که در آن XX به تعداد/شاخص معیارهای سفارشی اشاره دارد.

تغییرات اسناد و مدارک

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

  • ga:customVarName(n) → ga:customVarNameXX
  • ga:customVarValue(n) → ga:customVarValueXX

تجارت الکترونیک

  • Dim - ga:currencyCode - کد ارز محلی معامله بر اساس استاندارد ISO 4217.
  • Met - ga:localItemRevenue - درآمد محصول به ارز محلی.
  • Met - ga:localTransactionRevenue - درآمد تراکنش به ارز محلی.
  • Met - ga:localTransactionShipping - هزینه حمل و نقل تراکنش به ارز محلی.
  • Met - ga:localTransactionTax - مالیات تراکنش به ارز محلی.

استثناها

  • این داده ها از ردیابی استثنا به دست می آیند.
    • Dim - ga:exceptionDescription - شرح استثنا.
    • Met - ga:exceptionsPerScreenview - تعداد استثناهای پرتاب شده تقسیم بر تعداد بازدیدهای صفحه.
    • Met - ga:fatalExceptionsPerScreenview - تعداد استثناهای کشنده تقسیم بر تعداد بازدیدهای صفحه.

تبدیل های هدف

  • کم نور - ga:goalCompletionLocation - مسیر صفحه یا نام صفحه که با هر نوع مقصدی از تکمیل هدف مطابقت دارد.
  • Dim - ga:goalPreviousStep1 - مسیر صفحه یا نام صفحه که با هر نوع مقصدی مطابقت دارد، یک قدم قبل از مکان تکمیل هدف.
  • Dim - ga:goalPreviousStep2 - مسیر صفحه یا نام صفحه که با هر نوع مقصدی مطابقت دارد، دو مرحله قبل از مکان تکمیل هدف.
  • Dim - ga:goalPreviousStep3 - مسیر صفحه یا نام صفحه که با هر نوع مقصدی مطابقت دارد، سه مرحله قبل از مکان تکمیل هدف.

تغییرات اسناد و مدارک

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

  • ga:goal(n)AbandonRate → ga:goalXXAbandonRate
  • ga:goal(n)Abandons → ga:goalXXAbandons
  • ga:goal(n)Completions → ga:goalXXCompletions
  • ga:goal(n)ConversionRate → ga:goalXXConversionRate
  • ga:goal(n)Starts → ga:goalXXStarts
  • ga:goal(n)Value → ga:goalXXValue
  • ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate
  • Met - ga:percentSearchRefinements - درصد تعداد دفعاتی که یک اصلاح (به عنوان مثال، انتقال) بین کلمات کلیدی جستجوی داخلی در یک جلسه اتفاق می افتد.

ردیابی صفحه

  • Met - ga:pageValue - میانگین مقدار این صفحه یا مجموعه ای از صفحات. ارزش صفحه ((درآمد تراکنش + ارزش کل هدف) تقسیم بر تعداد بازدید از صفحه منحصر به فرد برای صفحه یا مجموعه ای از صفحات) است.

پلت فرم یا دستگاه

  • این داده از رشته HTTP User-Agent مشتق شده است.

    • Dim - ga:deviceCategory - نوع دستگاه: رومیزی، رایانه لوحی یا تلفن همراه.
    • Dim - ga:isTablet - نشان دهنده بازدیدکنندگان تبلت است. مقادیر ممکن Yes یا No هستند.
    • Dim - ga:mobileDeviceMarketingName - نام بازاریابی مورد استفاده برای دستگاه تلفن همراه.

تعاملات اجتماعی

  • این داده ها از ردیابی تعامل اجتماعی در محل می آید.

    • Dim - ga:socialEngagementType - نوع نامزدی. ارزش های ممکن عبارتند از: Socially Engaged یا Not Socially Engaged .

زمان

  • Dim - ga:dateHour - مقادیر ترکیبی ga:date و ga:hour .
  • Dim - ga:dayOfWeekName - نام روز هفته (به انگلیسی).
  • Dim - ga:isoWeek - شماره هفته ISO، که در آن هر هفته با دوشنبه شروع می شود. جزئیات: http://en.wikipedia.org/wiki/ISO_week_date .
  • Dim - ga:yearMonth - مقادیر ترکیبی ga:year و ga:month .
  • Dim - ga:yearWeek - مقادیر ترکیبی ga:year و ga:week .

منابع ترافیک

  • Dim - ga:fullReferrer - URL ارجاع دهنده کامل شامل نام میزبان و مسیر.
  • Dim - ga:sourceMedium - مقادیر ترکیبی ga:source و ga:medium .
  • این نسخه 2 معیار آزمایش جدید را اضافه می کند: - ga:experimentId - ga:experimentVariant
  • این نسخه 5 معیار سرعت سایت جدید را اضافه می کند:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • این نسخه یک بخش پیش‌فرض جدید برای ترافیک تبلت اضافه می‌کند، gaid::-13 .

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

ردیابی برنامه

  • این داده‌ها در گزارش‌های SDK ردیابی اپلیکیشن موبایل یافت می‌شوند:
    • Met - ga:uniqueAppviews - تعداد بازدیدهای برنامه در هر جلسه.
    • Met - 'ga:appviews - تعداد کل بازدیدهای برنامه.
    • Met - ga:appviewsPerVisit - میانگین تعداد بازدیدهای برنامه در هر جلسه.

منابع ترافیک

  • Dim - ga:socialNetwork - رشته ای که نام شبکه اجتماعی را نشان می دهد. این می تواند به شبکه اجتماعی ارجاع دهنده برای منابع ترافیک یا به شبکه اجتماعی برای فعالیت های مرکز داده های اجتماعی مرتبط باشد. به عنوان مثال Google+، Blogger، reddit و غیره.
  • Dim - ga:hasSocialSourceReferral - بازدیدهایی را نشان می دهد که از یک منبع اجتماعی به سایت رسیده اند (یعنی یک شبکه اجتماعی مانند Google+، Facebook، Twitter و غیره). مقادیر ممکن بله یا خیر هستند که حرف اول باید بزرگ باشد.

فعالیت های اجتماعی

  • این داده ها از فعالیت خارج از سایت وارد شده از شرکای Social Data Hub می آید.
    • Dim - ga:socialActivityDisplayName - برای یک فعالیت مرکز داده اجتماعی، این رشته عنوان فعالیت اجتماعی ارسال شده توسط کاربر شبکه اجتماعی را نشان می دهد.
    • کم نور - ga:socialActivityEndorsingUrl - برای یک فعالیت مرکز داده اجتماعی، این رشته نشانی اینترنتی فعالیت اجتماعی را نشان می دهد (مثلاً URL پست +Google، URL نظر وبلاگ و غیره)
    • Dim - ga:socialActivityPost - برای یک فعالیت مرکز داده اجتماعی، این رشته محتوای فعالیت اجتماعی پست شده توسط کاربر شبکه اجتماعی را نشان می دهد (مثلا محتوای پیام یک پست +Google)
    • Dim - ga:socialActivityTimestamp - برای یک فعالیت مرکز داده اجتماعی، این رشته زمانی را نشان می دهد که فعالیت اجتماعی در شبکه اجتماعی رخ داده است.
    • Dim - ga:socialActivityUserPhotoUrl - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده URL عکس مرتبط با نمایه شبکه اجتماعی کاربر است.
    • Dim - ga:socialActivityUserProfileUrl - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده URL نمایه شبکه اجتماعی کاربر مرتبط است.
    • Dim - ga:socialActivityContentUrl - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده URL به اشتراک گذاشته شده توسط کاربر شبکه اجتماعی مرتبط است.
    • Dim - ga:socialActivityTagsSummary - برای یک فعالیت مرکز داده اجتماعی، این مجموعه ای از برچسب ها با کاما جدا شده با فعالیت اجتماعی است.
    • Dim - ga:socialActivityUserHandle - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده دسته شبکه اجتماعی (یعنی نام) کاربری است که فعالیت اجتماعی را آغاز کرده است.
    • Dim - ga:socialActivityAction - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده نوع کنش اجتماعی مرتبط با فعالیت است (مثلا رأی، نظر، 1+ و غیره).
    • Dim - ga:socialActivityNetworkAction - برای یک فعالیت مرکز داده اجتماعی، این رشته نشان دهنده نوع کنش اجتماعی و شبکه اجتماعی است که فعالیت از آنجا شروع شده است.
    • Met - ga:socialActivities - تعداد فعالیت‌هایی که یک URL محتوا در یک شبکه شریک مرکز داده‌های اجتماعی به اشتراک گذاشته شده/ذکر شده است.

تعاملات اجتماعی

  • این داده ها از ردیابی تعامل اجتماعی در محل می آید.
    • کم نور - ga:socialInteractionAction - برای تعاملات اجتماعی، رشته ای نشان دهنده کنش اجتماعی در حال ردیابی است (به عنوان مثال 1+، لایک، نشانک)
    • Dim - ga:socialInteractionNetwork - برای تعاملات اجتماعی، یک رشته نشان دهنده شبکه اجتماعی در حال ردیابی (به عنوان مثال Google، Facebook، Twitter، LinkedIn)
    • کم نور - ga:socialInteractionNetworkAction - برای تعاملات اجتماعی، رشته ای نشان دهنده پیوستگی ga:socialInteractionNetwork و ga:socialInteractionAction در حال ردیابی (به عنوان مثال Google: +1، Facebook: like)
    • Dim - ga:socialInteractionTarget - برای تعاملات اجتماعی، رشته ای نشان دهنده URL (یا منبع) است که عملکرد شبکه اجتماعی را دریافت می کند.
    • Met - ga:socialInteractions - تعداد کل تعاملات اجتماعی در سایت شما.
    • Met - ga:uniqueSocialInteractions - تعداد کل تعاملات اجتماعی منحصر به فرد در سایت شما. بر اساس جفت مقدار ga:socialInteractionNetwork و ga:socialInteractionAction
    • Met - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions . میانگین تعداد تعاملات اجتماعی در هر بازدید از سایت شما.

جغرافیا / شبکه

  • Dim - ga:metro - منطقه بازار تعیین شده (DMA) که ترافیک از آنجا شروع شده است.

ردیابی صفحه

  • Dim - ga:pagePathLevel1 - این بعد تمام pagePath ها را در اولین سطح سلسله مراتبی در pagePath جمع می کند.
  • Dim - ga:pagePathLevel2 - این بعد تمام pagePath ها را در سطح سلسله مراتبی دوم در pagePath جمع می کند.
  • Dim - ga:pagePathLevel3 - این بعد تمام pagePath ها را در سطح سلسله مراتبی سوم در pagePath جمع می کند.
  • Dim - ga:pagePathLevel4 - این بعد تمام pagePath ها را در سطح سلسله مراتبی چهارم در pagePath جمع می کند. تمام سطوح اضافی در سلسله مراتب pagePath نیز در این بعد جمع می شوند.

ردیابی استثنا

  • این داده ها از داده های ردیابی استثنا به دست می آیند.

    • Met - ga:exceptions - تعداد استثناهایی که به Google Analytics ارسال شد.
    • Met - ga:fatalExceptions - تعداد استثناهایی که isFatal روی true تنظیم شده است.

زمان بندی کاربر

  • این داده ها از داده های زمان بندی کاربر به دست می آیند.

    • Dim - ga:userTimingCategory - رشته ای برای دسته بندی همه متغیرهای زمان بندی کاربر به گروه های منطقی برای اهداف گزارش دهی آسان تر.
    • Dim - ga:userTimingLabel - رشته ای برای نشان دادن نام عمل منبعی که ردیابی می شود.
    • Dim - ga:userTimingVariable - رشته ای که می تواند برای افزایش انعطاف پذیری در تجسم زمان بندی کاربر در گزارش ها استفاده شود.
    • Dim - ga:userTimingValue تعداد میلی ثانیه در زمان سپری شده ارسال شده به Google Analytics.
    • Met - ga:userTimingSample - تعداد نمونه هایی که ارسال شد.
    • Met - ga:avgUserTimingValue - میانگین زمان بندی کاربر. ga:userTimiingValue / ga:userTimiingSample .

دستگاه / پلتفرم

  • این داده ها از عامل کاربر داده های جمع آوری شده می آید.
    • Dim - ga:mobileDeviceBranding - سازنده موبایل یا نام تجاری (مثلاً: Samsung، HTC، Verizon، T-Mobile).
    • کم نور - ga:mobileDeviceModel - مدل دستگاه همراه (مثال: Nexus S)
    • Dim - ga:mobileInputSelector - انتخابگر مورد استفاده در دستگاه تلفن همراه (مثلاً: صفحه لمسی، جوی استیک، چرخ کلیک، قلم)
    • Dim - ga:mobileDeviceInfo - نام تجاری، مدل و نام بازاریابی مورد استفاده برای شناسایی دستگاه تلفن همراه.

رفع اشکال

  • اکنون API کاراکترهای UTF-8 را در یک فیلتر یا بخش پویا به درستی مدیریت می‌کند.

این نسخه به حساب های حق بیمه Google Analytics امکان دسترسی حداکثر 50 متغیر سفارشی را می دهد.

این نسخه 2 اشکال را برطرف می کند:

رفع اشکال

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

  • ترکیب یک فیلتر متریک با یک بخش پیشرفته دیگر خطایی را برنمی گرداند.

این نسخه معیارهای جدید سرعت سایت را به API اضافه می کند.

معیارهای جدید

  • معیارهای سرعت سایت زیر اضافه شده است:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

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

API نسخه 2.3 Reminder Deprecation

  • نسخه 2.3 API صادرات داده به مدت 2 ماه از بین رفته است. تقریباً در 4 ماه دیگر ما این سرویس را خاموش خواهیم کرد و فقط از API New Reporting API نسخه 3.0 و نسخه 2.4 پشتیبانی می کنیم.

  • ما به شدت توصیه می کنیم برنامه های خود را به نسخه 3.0 مهاجرت کنید.

  • در 4 ماه درخواست به میراث نسخه 2.3 XML Data Feed به نسخه 2.4 ارسال می شود و نسخه 2.4 XML را باز می گرداند. در آن مرحله ، تمام خط مشی های سهمیه نسخه 2.4 در مورد درخواست های نسخه 2.3 اعمال می شود.

  • کلیه درخواست های نسخه 2.3 JSON یا کتابخانه مشتری Google Data JavaScript که از نسخه 2.3 JSON Output استفاده می کند ، 404 کدهای وضعیت را برمی گرداند.

  • برای به دست آوردن سهمیه کامل ، هر دو نسخه 3.0 و نسخه 2.4 به شما نیاز دارند که برنامه خود را در کنسول Google APIS ثبت کنید و در هر درخواست از یک کلید API (یا OAUTH 2.0) استفاده کنید.

ما یک اشکال کوچک را با ga:visitLength . این بعد اکنون داده های صحیح را برمی گرداند.

این نسخه بر همه توسعه دهندگان API Google Analytics تأثیر می گذارد. این دو نسخه جدید از API را اعلام می کند ، برای ثبت نام نیاز به برنامه ها دارد ، یک خط مشی سهمیه جدید را معرفی می کند و نام API را به API گزارش اصلی تغییر می دهد. سرانجام ، API صادرات داده موجود نسخه 2.3 را کاهش می دهد.

نسخه 3.0

  • Core Reporting API نسخه 3.0 آخرین نسخه اصلی API ما است و به عقب سازگار نیست. تمام توسعه آینده API در این نسخه انجام خواهد شد.

  • ویژگی های جدید

    • خروجی مبتنی بر JSON جدید اندازه پاسخ ~ 10 برابر از خروجی XML قبلی را کاهش می دهد.
    • کتابخانه های جدید مشتری Google API که از جاوا ، جاوا اسکریپت ، پایتون ، PHP ، روبی و .NET پشتیبانی می کنند.
    • پشتیبانی از Google Discovery API .
    • پشتیبانی از OAUTH 2.0 به عنوان روش جدید و توصیه شده برای مجوز کاربران.

  • به روز رسانی ها

    • URL جدید برای درخواست: https://www.googleapis.com/analytics/v3/data/ga… .
    • نشانه های ثبت نام و توسعه دهندگان مورد نیاز.
    • کلیه درخواست های داده های پیکربندی باید از طریق API مدیریت انجام شود.

نسخه 2.4

  • Core Reporting API نسخه 2.4 یک نسخه نسخه جزئی است که بیشتر به عقب سازگار با API Export Data Export نسخه 2.3 است.

  • به روز رسانی ها

    • URL جدید برای درخواست: https://www.googleapis.com/analytics/v2.4/data…
    • نشانه های ثبت نام و توسعه دهندگان مورد نیاز.
    • خروجی XML سازگار با نسخه 2.3 ، بنابراین سایر کتابخانه های موجود در Google Data Client همچنان به کار خود ادامه می دهند.
    • کد خطا برای خطاهای سهمیه از 503 به 403 تغییر کرده است
    • پاسخ های JSON پشتیبانی نمی شود.
    • Google Data Data JavaScript Client Client پشتیبانی نمی شود.
    • بدون فید حساب کلیه درخواست های داده های پیکربندی باید از طریق API مدیریت انجام شود.

ثبت

  • کلیه برنامه های ساخته شده با استفاده از API Google Analytics باید از طریق کنسول Google APIS به عنوان یک پروژه ثبت شوند.

  • هر درخواست به API باید شامل کلید API یا برای OAUTH 2.0 ، شناسه مشتری و راز مشتری باشد.

خط مشی سهمیه

  • سهمیه زیر برای هر دو API ANLAYTICS (API مدیریت و API صادرات داده) اعمال می شود

    • 50،000 درخواست در هر پروژه در روز
    • 10 نمایش در هر ثانیه (QPS) در هر آدرس IP

  • سهمیه زیر مربوط به API صادرات داده است

    • 10،000 درخواست در هر پروفایل در روز
    • 10 درخواست همزمان در هر نمایه

  • برای برنامه های ثبت نشده ، ما سهمیه ای بسیار کم GRACE را برای تست کمی از آزمایش ارائه می دهیم.

تحقیرها

  • این نسخه همچنین از استهلاک نسخه 2.3 و خاموش شدن آینده فید حساب در API صادرات داده خبر می دهد. در 6 ماه:

    • درخواست های نسخه 2.3 XML Data Feed به نسخه 2.4 ارسال می شود و یک پاسخ نسخه 2.4 را برمی گرداند. در آن مرحله ، تمام خط مشی های سهمیه نسخه 2.4 در مورد درخواست های نسخه 2.3 اعمال می شود.

    • درخواست های نسخه 2.3 JSON با پاسخ نسخه 2.4 پشتیبانی نمی شود و 404 Not Found . اگر به پاسخ JSON نیاز دارید ، به نسخه 3.0 ارتقا دهید.

    • درخواست های مربوط به فید حساب در API صادرات داده 404 Not Found . کلیه درخواست های داده های پیکربندی باید از طریق API مدیریت انجام شود.

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

  • داده های AdWords اکنون طی یک ساعت به روز می شوند. قبل از به روزرسانی داده ها روزانه.

  • ما تعدادی از محدودیت های ترکیب معتبر را با داده های AdWords آرام کرده ایم.

چند هفته پیش ما تغییری در رد درخواست های API ایجاد کردیم که از ga:adGroup یا ga:adContent با ga:impressions ، از آنجا که این ترکیب بازگشت. با این تغییر ، این ترکیب اکنون برگشته است و برای بازگشت داده های صحیح ثابت شده است. .

این نسخه برخی از ترکیبات نامعتبر از ابعاد و معیارها را برطرف می کند

ترکیب معیارها/ابعاد نامعتبر رفع شد

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

    • ابعاد محصول را نمی توان با معیارهای معامله ترکیب کرد.
    • ga:adContent یا ga:adGroup نمی توان با ga:impressions .

    به جای بازگشت یک پاسخ با 0 نتیجه ، API اکنون 400 کد خطای را برای کلیه نمایش داده هایی که درخواست این ترکیب ها را دارند ، برمی گرداند.

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

از بین بردن فاصله اطمینان

  • اگر قبلاً این کار را نکرده اید ، لطفاً استفاده از مقادیر فاصله اطمینان را برای معیارها متوقف کنید. با استفاده از این نسخه ، داده های داده API Export API برای تمام مقادیر فاصله اطمینان 0.0 باز می گردد. در یک ماه یا بیشتر ، ما این ویژگی را از همه عناصر متریک به طور کامل حذف خواهیم کرد.

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

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

به روز رسانی داده های جدید

  • ما 3 معیار جدید که با عملکرد سرعت سایت به API می پردازند اضافه کردیم:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

به روز رسانی متریک

  • برای مشخص کردن مقادیر ارزی در فیلترها ، باید مقدار واقعی منتقل شده از کد ردیابی را مشخص کنید ، (به عنوان مثال 1 واحد اکنون به عنوان 1 مشخص می شود).

  • ga:CTR اکنون درصد واقعی را برمی گرداند (به عنوان مثال مقدار 2 ٪ به عنوان 2 بازگردانده می شود).

این نسخه باعث بهبود عملکرد خوراک داده می شود و داده های جدیدی را اضافه می کند:

ارتقای کارایی

  • این نسخه تأخیر داده ها را 30 تا 35 ٪ بهبود می بخشد.

به روز رسانی داده های جدید

  • ما لیست ابعاد و معیارهایی را که در بخش های پیشرفته مجاز است به روز کرده ایم. لطفاً به لیست به روز شده مراجعه کنید تا اطمینان حاصل کنید که درخواست های شما معتبر است.

تغییرات آتی

  • در حال حاضر ، شما باید مقدار فیلتر ارزی را به عنوان واحدهای میکرو مشخص کنید ، (به عنوان مثال 1 واحد ارز به عنوان 1000000 مشخص شده است). در آینده نزدیک ، شما باید مقدار واقعی منتقل شده از کد ردیابی را مشخص کنید ، (به عنوان مثال 1 واحد اکنون به عنوان 1 مشخص می شود).

  • در حال حاضر ، ga:CTR percent است و مقدار 0.02 را برمی گرداند. در آینده نزدیک این تغییر می کند تا درصد واقعی را برگرداند (به عنوان مثال 2).

این نسخه داده های بیشتری را به فید داده ها اضافه می کند:

به روز رسانی داده های جدید

  • بعد زمان زیر اضافه شده است: ga:dayOfWeek

  • متریک جستجوی داخلی زیر اضافه شده است: ga:percentVisitsWithSearch

  • معیارهای ردیابی رویداد زیر اضافه شده است:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

تغییرات آتی

در حال حاضر API 401 کد وضعیت را برای موضوعات مختلف مجوز باز می گرداند. طی دو هفته آینده ، از وضعیت 401 منحصراً برای نشانه های نامعتبر استفاده می شود و به توسعه دهندگان راهی برای خطا در رسیدگی به این استثناء خاص می دهد.

این نسخه داده های قابل توجهی بیشتر به فید داده ها اضافه می کند:

به روز رسانی داده های جدید

  • محاسبه ga:visitors برای بازگشت تعداد بازدید کنندگان منحصر به فرد در محدوده تاریخ تغییر یافته است و اکنون از ابعاد و ترکیب های متریک بیشتر پشتیبانی می کند.

  • 10 ابعاد جدید AdWords اضافه شده است: ga:adDistributionNetwork ، ga:adMatchType ، ga:adPlacementDomain ga:adMatchedQuery ga:adPlacementUrl ، GA: ga:adFormat ، ga:adTargetingType ، GA ga:adTargetingOption ، ga:adDisplayUrl ، ga:adDestinationUrl .

  • Metric ga:organicSearches به گروه مبارزات انتخاباتی اضافه شده است.

  • Metric ga:searchResultViews به گروه جستجوی سایت داخلی اضافه شده است.

  • 3 ابعاد جدید مبتنی بر زمان اضافه شده است: ga:nthDay ، ga:nthWeek ، ga:nthMonth .

  • گروه بندی ابعاد و معیارها تغییر یافته است تا بهتر از ویژگی های آنها بازتاب یابد.

معیارهای جدید محاسبه شده

معیارهای محاسبه شده زیر از محاسبات با استفاده از معیارهای پایه حاصل می شود. توجه: هر نام با (n) از مقادیر 1-20 پشتیبانی می کند.

  • هدف مبتنی بر: ga:costPerConversion ، ga:costPerGoalConversion ga:costPerTransaction ، GA ga:goal(n)AbandonRate ga:goal(n)Abandons ، ga:goal(n)ConversionRate ، ga:goalAbandonRateAll ، GA ga:goalAbandonsAll ga:goalConversionRateAll ، ga:goalValueAllPerSearch ، ga:goalValuePerVisit .

  • محتوای مبتنی بر: ga:entranceBounceRate ، ga:visitBounceRate ، ga:entranceRate ، ga:exitRate ، GA: ga:pageviewsPerVisit ، ga:avgTimeOnPage ، ga:avgTimeOnSite ، ga:avgEventValue .

  • جستجوی سایت داخلی مبتنی بر: ga:avgSearchDepth ، ga:avgSearchDuration ، ga:searchGoalConversionRateAll ga:avgSearchResultViews ، GA: SearchGoAlconversionRateAll ، ga:searchGoal(n)ConversionRate ، ga:searchExitRate .

  • تجارت الکترونیک مبتنی بر: ga:itemsPerPurchase ، GA ga:percentNewVisits ga:margin ، GA ga:revenuePerItem ، ga:revenuePerTransaction ، GA: REAUNEPERTRANSACTION ، ga:ROI ، ga:RPC ، ga:totalValue ، ga:transactionRevenuePerVisit ، ga:transactionsPerVisit .

این نسخه ویژگی جدیدی را به فید داده اضافه می کند:

ویژگی های جدید

  • یک عنصر XML جدید اضافه شده است به کاربران این امکان را می دهد که آیا داده ها نمونه برداری شده است یا خیر. true . این عنصر همیشه باز می گردد که آیا داده ها نمونه برداری شده اند یا نه با true یا false . کتابخانه های جاوا و جاوا اسکریپت نیز برای دسترسی به این عنصر با روش های یاور به روز شده اند.

این نسخه 2 اشکال را برطرف می کند:

رفع اشکال

  • پیش از این اضافه کردن یک اپراتور یا اپراتور به یک عبارت فیلتر با ابعاد (به عنوان مثال ، ga:keyword==store,ga:keyword==bar ) ​​می تواند در مقادیر مختلفی از آن باشد که هر فیلتر به صورت جداگانه در چندین نمایش داده شده اعمال می شود. این ثابت شده است و با استفاده از اپراتور OR اکنون مقادیر ثابت را برمی گرداند.

  • برخی از پیام های خطای API برای فیلترهای نامعتبر به روز شده اند تا شامل این نشوید که آیا این یک ابعاد یا فیلتر متریک است که باعث ایجاد خطا شده است (اگرچه بیان واقعی فیلتر متخلف همچنان بازگردانده خواهد شد).

این نسخه 3 اشکال را برطرف می کند:

رفع اشکال

  • یک مسئله رمزگذاری در کتابخانه مشتری JavaScript برطرف شده است. ردیاب شماره تحلیلی

  • اشکالی که مانع از بازگشت فید حساب می شود وقتی نام هدف ، مسیر هدف ، ارزش مقایسه هدف یا نوع مقایسه هدف به طور نادرست تعیین شده است ، اکنون ثابت شده است.

  • در پارامتر فیلتر پرس و جو از داده های فید نامعتبر است یا یک ابعاد و متریک است. به عنوان مثال: ga:source==google,ga:visits>5 . پیام خطا برای این پرس و جو نامعتبر به روز شده است تا بگوید: Cannot OR dimension filter(s) with metric filter .

این نسخه داده های جدیدی را اضافه می کند و یک اشکال را برطرف می کند:

ویژگی های جدید

  • 5 بعد زیر در گروه جدید D8. Adwords :

    • ga:adwordsAdGroupId : با AdGroup Adwords API ADGROUP.ID مطابقت دارد
    • ga:adwordsCampaignId : مطابق با کمپین APIWORDS API.ID
    • ga:adwordsCreativeId : با Adwords API AD.ID مطابقت دارد
    • ga:adwordsCriteriaId : مطابق با معیار API ADWORDS.ID
    • ga:adwordsCustomerId : به حساب AdWords API AccountInfo.CustomerId پاسخ می دهد

رفع اشکال

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

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

ویژگی های جدید

  • بخش پیش فرض آیفون (GAID ::-11) افزایش یافته است تا اکنون در مورد همه دستگاه های تلفن همراه گزارش شود. شناسه مانند قبل (-11) است ، اما نام این بخش اکنون است: Mobile Traffic .

  • میزان نمونه برداری مورد استفاده API اکنون همان رابط وب است. این داده ها را برای گزارش های نمونه برداری شده با رابط وب به ارمغان می آورد و قوام بین این دو را افزایش می دهد.

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

    • یک ویژگی وب واحد ممکن است حداکثر 10،000 درخواست در هر 24 ساعت ایجاد کند.
    • یک برنامه فقط می تواند در هر دوره 1 ثانیه ای 10 درخواست کند.
    • یک برنامه فقط در هر زمان معین می تواند 4 درخواست در انتظار داشته باشد.

  • برخی از محدودیت ها در زمینه های ابعاد و متریک آرام شده است. ga:nextPagePath و ga:previousPagePath اکنون بخشی از D3. Content گروه D3. Content D8. Custom Variable گروه D8. Custom Variable اکنون D6. Custom Variable گروه D6. Custom Variable . لطفاً برای این ترکیبات جدید به راهنمای مرجع به روز شده مراجعه کنید.

رفع اشکال

  • ما یک اشکال در مورد چگونگی گزارش API از مقدار confidenceInterval برای معیارها برطرف کردیم. پیش از این ، فواصل اطمینان می تواند مقدار INF یا یک عدد از 0 تا 1 داشته باشد. اکنون تمام فواصل اطمینان از مقدار INF یا یک عدد بیشتر از یا برابر با 0 برخوردار هستند.

  • ga:itemQuantity و ga:uniquePurchases قبلاً تعویض شده و ارزش یکدیگر را برگردانده اند. آنها اکنون برای بازگشت داده های صحیح ثابت شده اند.

یادآوری منسوخ شدن ابعاد و معیارها

  • اگر قبلاً این کار را نکرده اید ، لطفاً استفاده از ابعاد و معیارهای قبلاً کاهش یافته را متوقف کنید

این نسخه تعدادی از ویژگی های جدید را اضافه می کند:

این نسخه شماره نسخه اصلی را به 2 افزایش می دهد

  • برخی از ویژگی ها به استفاده از آخرین کتابخانه های مشتری نیاز دارند. ما به طور رسمی پشتیبانی می کنیم: جاوا و جاوا اسکریپت . کتابخانه های شخص ثالث هنوز به روز نشده اند.

    • نسخه 2 ممکن است با افزودن عنوان GData-Version: 2 به هر حساب یا درخواست خوراک داده درخواست شود ، برای اطلاعات بیشتر مستندات را بخوانید.
    • یک فضای نام جدید XML به فید های حساب و داده اضافه شده است:
      xmlns:ga='http://schemas.google.com/ga/2009'

  • API اکنون از پروتکل داده Google نسخه 2 پشتیبانی می کند.

پشتیبانی از بخش بندی پیشرفته

  • پارامتر پرس و جو بخش پویا:

    • ...&segment=dynamic:: بیان
    • اجازه می دهد تا بخش های پیشرفته "در پرواز" ایجاد شود.
    • بیان می تواند هر ابعاد یا متریک باشد و باید همان نحو را به عنوان فیلترها دنبال کند.

  • پارامتر پرس و جو بخش های پیش فرض و سفارشی:

    • ...&segment=gaid:: شماره
    • جایی که شماره شناسه ای است که به یک بخش پیشرفته در رابط وب Google Analytics تعریف شده است.
    • شناسه را می توان در فید حساب یافت.

  • فید حساب داده های بخش را از طریق عناصر و ویژگی های XML زیر شرح می دهد:

    • ga:visitorType==Returning Visitor

  • فید داده همچنین یک عنصر XML را نشان می دهد که نشان می دهد آیا بخشی در درخواست API اعمال شده است یا خیر.

  • جزئیات بیشتر در مورد بخش های پیشرفته در مستندات ما.

داده های هدف جدید در دسترس است

  • مقصد و اهداف نوع نامزدی موجود در فید حساب:

  • 48 معیارهای هدف جدید برای اهداف 5-20 اضافه شده است که همه goal(n)Completions پیروی می کنند ، جایی که (n) تعداد بین 1 تا 20 است.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value

  • GoalCompletionAll ، GoalStartsAll و GoalValueAll به روز شده اند تا داده های هدف جدید را به خود اختصاص دهند.

داده های متغیر سفارشی جدید

  • کلیه متغیرهای سفارشی که تاکنون توسط هر نمایه جمع آوری شده است به عنوان یک عنصر XML جدید به فید حساب اضافه شده است:

  • 10 ابعاد جدید برای متغیرهای سفارشی اضافه شده است. آنها کنوانسیون customVar(n) را دنبال می کنند که (n) می تواند یک عدد بین 1 تا 5 باشد.

    • ga:customVarName(n)
    • ga:customVarValue(n)

ابعاد و معیارهای کاهش یافته برای حذف!

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

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • ابعاد زیر تغییر نام داده شده است:

    • ga:countOfVisits اکنون ga:visitCount
    • ga:countOfVisitsToATransaction اکنون ga:visitsToTransaction

این نسخه ویژگی های جدیدی را اضافه می کند و برخی از عملکردهای قدیمی را کاهش می دهد:

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

    • GA: Countofvisits
    • GA: countofvisitstoatransaction
    • GA: SourceMedium
    • GA: HESTNEWVISITS

  • ابعاد زیر تغییر نام داده شده است:

    • GA: Countofvisits اکنون GA است: بازدید
    • GA: Countofvisitstoatransaction اکنون GA است: بازدید

  • تمام داده های ردیابی رویداد اکنون به عنوان 2 گروه جدید در معرض دید است:

    D7. رویدادها (ابعاد) * GA: EventCategor * GA: EventAction * GA: EventLabel

    M7. رویدادها (معیارها) * GA: EventValue * GA: Totalevents * GA: Uniqueevents

  • اکنون داده های ناوبری سایت از طریق ابعاد زیر در معرض دید قرار می گیرد:

    D6. ناوبری * GA: قبلی PagePath * GA: NextPagePath

  • ناوبری صفحه فرود اکنون از طریق ابعاد زیر در معرض دید قرار می گیرد:

    D3. محتوا * GA: LandingPagePath * GA: SecondPagePath

  • حداکثر طول عبارات منظم در پارامتر پرس و جو فیلتر فید داده از 32 به 128 کاراکتر افزایش یافته است.

  • گزارش مدت بازدید (که از طریق UI تحت بازدید کنندگان -> وفاداری بازدید کننده یافت می شود) اکنون از طریق بعد جدید در معرض دید قرار می گیرد:

    • GA: طول بازدید

این نسخه API صادرات داده های Google Analytics را به شرح زیر به روز می کند:

  • برخی از محدودیت ها در زمینه های ابعاد و متریک آرام شده است. اکنون می توانید بیشتر ابعاد سطح محتوا و بازدید کننده را با هم پرس و جو کنید ، به عنوان مثال ga:pagePath و ga:source اکنون یک ترکیب معتبر است. لطفاً به راهنمای مرجع به روز شده برای این ترکیبات جدید مراجعه کنید: http://code.google.com/apis/analytics/docs/gdata/gdatareferencevalidcombos.html

  • تعداد کل ردیف هایی که در یک درخواست می توان از آنها خواسته شد به 10،000 افزایش یافته است. تعداد پیش فرض ردیف های برگشتی هنوز 1000 است ، اما اکنون می توان با تنظیم پارامتر پرس و جو max-results افزایش یافت.

  • فید حساب اکنون دو عنصر داده جدید را برای هر شناسه جدول (ارز و منطقه زمانی) برمی گرداند.

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

  • تمام تغییرات استهلاک قبلی به وجود آمده است.

این نسخه ویژگی های مستهلک شده را از بتا خصوصی ما حذف می کند:

  • درخواست های فید حساب دیگر از نام کاربری در آنها پشتیبانی نمی کند. در عوض ، فقط درخواست ها را در قالب زیر می پذیرد:
    https://www.google.com/analytics/feeds/accounts/default

  • معیارهای زیر حذف می شوند و دیگر کار نمی کنند. درعوض ، ما دستورالعمل هایی در مورد چگونگی محاسبه این مقادیر در اینجا ارائه داده ایم: http://code.google.com/apis/analytics/docs/gdata/gdatareferencecommoncccolutions.html

    • GA: avgpageduration
    • GA: avgpageViews
    • GA: avgsessiontime
    • GA: تندرست
    • GA: Exitrate
    • GA: CostperConversion
    • GA: CONTPERGOALCONVERNION
    • GA: Costpertransaction
    • GA: REVENUEPERCLICK
    • GA: درآمدهای پرسشنامه
    • GA: REVENUEPERVISIT
    • GA: DonutionedFunnels1
    • GA: DonutionedFunnels2
    • GA: DonurededFunnels3
    • GA: DonutionedFunnels4
    • GA: GoalConversionRate
    • GA: GoalConversionRate1
    • GA: GoalConversionRate2
    • GA: GoalConversionRate3
    • GA: GoalConversionRate4
    • GA: GoalValuePervisit

  • ابعاد و معیارهای زیر تغییر نام داده شده است. نامهای قدیمی دیگر کار نمی کنند. لطفاً تأیید کنید که از اسامی رسمی در اسناد ما در اینجا استفاده می کنید: http://code.google.com/apis/analytics/docs/gdata/gdatareferencedimensionsmetrics.html

    ابعاد * GA: SubcontinentRegion ⇒ GA: زیر قاره * GA: سازمان ⇒ GA: NetworkLocation * GA: دامنه ⇒ GA: NetworkDomain * GA: VisionNumber ⇒ GA: Countofvisits * GA: Platform ⇒ GA: Operatingsystem * GA: PlatformVersion ⇒ GA: OperatingSystemPersion * GA: محتوا ⇒ GA: AdContent * GA: Requesturi ⇒ GA: PagePath * GA: Requesturi1 ⇒ GA: LandingPagePath * GA: Requesturilast ⇒ GA: ExitPagePath * GA: InternalSearchNext ⇒ GA: SearchKeywordRefinement * GA: GA: GA: GA: Search Keyword * GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: ga: InternalSearchType ⇒ GA: SearchCategor * GA: HasInternalSearch ⇒ GA: Searchused * GA: RequestUrifrom ⇒ GA: SearchStartPage * GA: RequestUrito ⇒ GA: SearchDestinationPage * GA: ProductCode ⇒ GA: ProductKu

    Metrics * GA: Newvisitors ⇒ GA: Newvisits * GA: PageDuration ⇒ GA: TimeOnpage * GA: Visionduration ⇒ GA: TimeNsite * GA: CORT ⇒ GA: Adcost * GA: Clicks ⇒ GA: AdClicks * GA: ClickThroughRate ⇒ GA: CTR * GA: CONTPERCLICK ⇒ GA: CPC * GA: CastpermilleImpressions ⇒ GA: CPM * GA: SearchTransitions ⇒ GA: SearchRefinements * GA: UniqueInternalSearches ⇒ GA: SearchUniques * GA: Visswithsearches ⇒ GA: GA: ProductPurchases ⇒ GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: GA: Productrevenue ⇒ GA: AttemRevenue * GA: محصولات ⇒ GA: UniquePurchases * GA: درآمد ⇒ GA: TransactionRevenue * GA: حمل و نقل ⇒ GA: Transactionsing * GA: TransactionTax * GA: GAORCOMPLETIONS1 ⇒ GA: Goal1Completions * GA: GAORCOMPLETIONS2 ⇒ GA: GAOR2Completions * GA: GoalCompletions3 ⇒ GA: Goal3Completions * GA: GoalCompletions4 ⇒ GA: Goal4Completions * GA: GAOLSTARTS1 ⇒ GA: GAOR1STARTS * GA: GAORSTARTS2 ⇒ GA: GAOR2STARTS * GA: GAORSTARTS3 ⇒ GA: GA GASTARTS * GA GASTARTS * GASTARTS GA: GA GA: GA: GA: GA: GA: GA: GA: GA: Goal4Starts * GA: GoalValue1 ⇒ GA: Goal1Value * GA: GoalValue2 ⇒ GA: Goal2Value * GA: GoalValue3 ⇒ GA: Goal3Value * GA: GoalValue4 ⇒ GA: GAON4Value