Google Analytics - همه تغییرات API پیکربندی

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

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

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

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

همه تغییرات API پیکربندی
–
اشتراک درrss

شامل مدیریت API و Provisioning API.

تنظیمات حفظ اطلاعات کاربر در مدیریت API

اکنون می‌توان تنظیمات حفظ داده‌های کاربر را با استفاده از فیلدهای جدید «dataRetentionTtl» و «dataRetentionResetOnNewActivity» که به منبع WebProperty اضافه شده‌اند، پیکربندی برنامه‌نویسی کرد.

این نسخه اولیه User Deletion API است:

  • User Deletion API به مشتری Google Analytics اجازه می دهد تا داده های یک کاربر نهایی را از یک پروژه یا دارایی وب حذف کند. درخواست های حذف کاربر را می توان با استفاده از پروژه های Firebase یا ویژگی های Google Analytics انجام داد. برای جزئیات بیشتر به نمای کلی API حذف کاربر مراجعه کنید.

عملیات را در مدیریت API بنویسید

عملیات نوشتن در مدیریت API (مانند ایجاد، به‌روزرسانی، حذف، وصله) برای منابع Web Property، View (Profile) و Goal دیگر نیازی به لیست سفید ندارند. محدودیت روزانه پیش‌فرض برای همه عملیات Write در مدیریت API 50 نوشتن در روز است. برای اطلاعات بیشتر به صفحه محدودیت ها و سهمیه ها مراجعه کنید.

معیارهای سفارشی

این یک نسخه رفع اشکال است؛ مشکل ایجاد یک متریک سفارشی از نوع TIME هنگامی که min_value تنظیم نشده بود، ناموفق بود را برطرف می کند. اکنون درخواست‌های بدون min_value یک معیار سفارشی با min_value پیش‌فرض 0 ایجاد می‌کنند.

ارزها

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

  • UAH، AED، BOB، CLP، COP، EGP، HRK، ILS، MAD، MYR، PEN، PKR، RON، RSD، SAR، SGD، VEF، LVL

برای اطلاعات بیشتر رجوع کنید به: - مرجع نماها (نمایه ها) . - مقاله مرکز راهنمایی مرجع ارز .

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

مخاطبان بازاریابی مجدد

مدیریت API به شما این امکان را می‌دهد که مخاطبان بازاریابی مجدد را برای یک ویژگی Google Analytics create ، get ، list کنید، update و patch . برای کسب اطلاعات بیشتر در مورد نحوه عملکرد مخاطبان بازاریابی مجدد، به مقاله درباره مخاطبان بازاریابی مجدد در مرکز راهنمایی Analytics مراجعه کنید.

گزارش های نمونه برداری نشده

API گزارش های نمونه برداری نشده دیگر محدودیت 100 گزارش در روز ندارد. API از همان سیستم توکن در روز برای هر ویژگی استفاده می کند که هنگام ایجاد یک گزارش نمونه برداری نشده از طریق رابط وب.

گزارش های نمونه برداری نشده

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

بازدیدها (نمایه ها)

این نسخه ویژگی botFilteringEnabled را به منبع view (پروفایل) اضافه می کند. این ویژگی نشان می دهد که آیا فیلتر ربات برای یک View (نمایه) فعال است یا خیر. برای جزئیات به اسناد مرجع مشاهده (نمایه ها) مراجعه کنید.

گزارش های نمونه برداری نشده

این نسخه روش delete را به گزارش‌های بدون نمونه اضافه می‌کند. برای جزئیات، به گزارش های نمونه برداری نشده، اسناد مرجع را حذف کنید .

بخش ها

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

بخش ها

این یک نسخه رفع اشکال است. این نسخه مشکلی را برطرف می‌کند که باعث می‌شود کاربران دارای بخش‌های خصوصی که به چندین نما (پروفایل) پین شده‌اند، هنگام فراخوانی روش فهرست بخش‌ها، پاسخ خطای 500 دریافت کنند.

این نسخه یک پارامتر اضافی به URL TOS Provisioning API اضافه می کند:

  • افزودن پارامتر URL، provisioningSignup=false ، مشکلی را که هنگام تهیه یک حساب Google Analytics برای یک کاربر بدون هیچ حساب Google Analytics رخ می دهد، برطرف می کند. توسعه دهندگان باید کد خود را به روز کنند تا این پارامتر را به URL TOS اضافه کنند.

دسته بندی

با این نسخه، علاوه بر پشتیبانی دسته‌ای عمومی، ما پشتیبانی ویژه‌ای را برای User Permissions API اضافه کرده‌ایم. درخواست‌های دسته‌ای مجوزهای کاربر شاهد افزایش عملکرد قابل توجه و کاهش استفاده از سهمیه خواهند بود.

بازدیدها (نمایه ها)

با این نسخه، ویژگی currency View (Profile) اکنون اگر در طی یک عملیات درج تنظیم نشود، به طور پیش فرض USD خواهد بود. همچنین عملیات get و list ، USD را به بازدیدها (نمایه‌هایی) که قبلاً بدون خاصیت currency ایجاد شده‌اند، برمی‌گرداند.

فیلترها

این نسخه حذف نهایی فیلدهای فیلتر منسوخ IS_MOBILE و IS_TABLET را نشان می دهد که باید با DEVICE_CATEGORY=mobile و DEVICE_CATEGORY=tablet جایگزین شوند. درج، به‌روزرسانی و وصله درخواست‌هایی که فیلدهای فیلتر را برای استفاده از IS_MOBILE و IS_TABLET تنظیم می‌کنند، یک خطا برمی‌گردانند.

فیلترها

این نسخه با افزودن ویژگی fieldIndex به تمام بخش‌های جزئیات فیلتر، پشتیبانی را برای استفاده از یک بعد سفارشی برای یک فیلد فیلتر اضافه می‌کند. برای مثال، اکنون می‌توانید عبارت فیلتر را با یک "field": "CUSTOM_DIMENSION" و "fieldIndex": "1" تا فیلتر در اولین بعد سفارشی کار کند.

اهداف

این نسخه همچنین مشکلی را هنگام ایجاد یک هدف با "comparisonValue": "0" شکست می خورد.

این نسخه، پایان نهایی و حذف منبع dailyUpload را نشان می دهد. منبع dailyUpload رسماً در 20 ژوئن 2014 منسوخ شد. تمام واردات داده های هزینه اکنون باید با استفاده از منبع آپلود انجام شود.

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

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

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

پاسخ متد list برای همه مجموعه‌ها اکنون شامل یک لیست خالی برای ویژگی items می‌شود، زمانی که مجموعه فاقد منبع باشد. قبلاً ویژگی items از پاسخ حذف می شد. برای جزئیات کامل در مورد پرسش‌ها و پاسخ‌ها برای داده‌های پیکربندی Google Analytics به مرجع API مراجعه کنید.

رفع اشکال

این نسخه دامنه جدیدی را برای API مدیریت Google Analytics معرفی می کند. - analytics.manage.users.readonly - مشاهده مجوزهای کاربر Google Analytics.

یک قسمت فیلترهای DEVICE_CATEGORY جدید اضافه شده است و IS_MOBILE و IS_TABLET اکنون منسوخ شده اند. از DEVICE_CATEGORY=mobile و DEVICE_CATEGORY=tablet استفاده کنید.

منبع View (نمایه) اکنون شامل یک ویژگی enhancedECommerceTracking است که نشان می دهد تجارت الکترونیک پیشرفته فعال ( true ) یا غیرفعال ( false ) است.

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

واردات داده

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

آپلودها

  • منبع upload اکنون از انواع آپلود زیر پشتیبانی می کند:
    • داده های کمپین
    • داده های محتوا
    • داده های هزینه
    • اطلاعات محصول
    • داده های بازپرداخت
    • داده های کاربر
  • منبع upload دارای یک روش migrateDataImport جدید برای انتقال منابع داده customDataSources Cost Data موجود است.

منسوخ شدن آپلودهای روزانه

  • منبع dailyUpload اکنون منسوخ شده است! برای جزئیات بیشتر در مورد مهاجرت برای استفاده از ویژگی واردات داده، به راهنمای مهاجرت مراجعه کنید.
  • منبع dailyUpload به مدت شش ماه دیگر به کار خود ادامه می‌دهد، در این مرحله، هر customDataSources باقی‌مانده با ویژگی uploadType تنظیم شده روی analytics#dailyUploads به طور خودکار منتقل می‌شود و فقط با منبع upload کار می‌کند.
  • کاربران فعلی منبع dailyUpload باید کد خود را به روز کنند و برای استفاده از منبع آپلود در اسرع وقت مهاجرت کنند.

این نسخه اولیه Provisioning API است:

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

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

  • پیوندهای AdWords در مدیریت API به شما امکان می‌دهد پیوندهایی را بین حساب‌های Google AdWords و دارایی‌های Google Analytics ایجاد، فهرست‌بندی، دریافت، به‌روزرسانی، اصلاح و حذف کنید و مدیریت کنید که بازدیدها (نمایه‌ها) به داده‌های Adwords مرتبط شده‌اند.

فیلترها

  • فیلترها در مدیریت API به شما این امکان را می‌دهند که فیلترهایی را برای حساب Google Analytics خود ایجاد، فهرست‌بندی، دریافت، به‌روزرسانی، اصلاح و حذف کنید. پیوندهای فیلتر نمایه به شما این امکان را می دهند که پیوندهای بین فیلترها و نماها (پروفایل ها) را ایجاد، فهرست، دریافت، به روز رسانی، اصلاح و حذف کنید.

گزارش های بدون نمونه: مدیریت API

یک منبع جدید به مدیریت API به نام گزارش‌های نمونه‌برداری نشده اضافه می‌شود. گزارش‌های بدون نمونه، گزارش‌های Google Analytics (GA) هستند که با استفاده از داده‌های نمونه‌برداری نشده تولید شده‌اند. گزارش‌های بدون نمونه در حال حاضر فقط برای کاربران GA Premium در دسترس است.

بخش ها: مدیریت API نسخه 2.4 و نسخه 3.0

تغییرات زیر در مجموعه Segments اعمال شده است:

  • بخش های کاربر و دنباله اکنون در API پشتیبانی می شوند.
  • مجموعه Segments اکنون تمام بخش‌های سطح جلسه داخلی و سفارشی و بخش‌های سطح کاربر را برمی‌گرداند.
  • ویژگی definition برای بخش ها اکنون از نحو بخش های جدید استفاده می کند. این شامل تعاریفی برای بخش‌های سطح جلسه موجود است که از definition: " " definition: " " به definition: "sessions::condition:: " definition: "sessions::condition:: " .
  • ویژگی type جدیدی به منبع Segment اضافه شده است تا مشخص کند که آیا یک بخش CUSTOM است (یعنی توسط کاربر در رابط وب ایجاد شده است) یا BUILT_IN (یعنی ارائه شده توسط Google Analytics).

آزمایش

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

  • ga:adsenseAdsClicks — تعداد دفعاتی که تبلیغات AdSense در سایت شما کلیک شده است.
  • ga:adsenseAdsViewed — تعداد تبلیغات AdSense مشاهده شده. تبلیغات چندگانه را می توان در یک واحد تبلیغاتی نمایش داد.
  • ga:adsenseRevenue - کل درآمد حاصل از تبلیغات AdSense.

مجموعه خلاصه های حساب جدید

  • مجموعه AccountSummaries به مدیریت API اضافه شده است. خلاصه ای از اطلاعات برای هر حساب، دارایی، و نمای (نمایه) که یک کاربر مجاز به آن در یک درخواست واحد و سریع دسترسی دارد، ارائه می دهد. برای جزئیات به راهنمای برنامه‌نویس خلاصه حساب‌ها مراجعه کنید.

به دلیل منسوخ شدن ابعاد ga:isMobile و ga:isTablet تغییرات زیر در بخش های پیش فرض ایجاد شده است:

  • Segment gaid::-11 از Mobile Traffic به Mobile and Tablet Traffic تغییر نام داده است. تعریف این بخش از ga:isMobile==Yes به ga:deviceCategory==mobile,ga:deviceCategory==tablet تغییر کرده است. توجه داشته باشید که ga:isMobile شامل ترافیک تبلت است که در تعریف جدید منعکس شده است. اگر فقط ترافیک تلفن همراه را می‌خواهید، به استثنای تبلت، به بخش جدید ترافیک موبایل ( gaid::-14 ) بروید.
  • تعریف Segment gaid::-13 از ga:isTablet==Yes به ga:deviceCategory==tablet تغییر کرده است. این همچنان نشان دهنده ترافیک رایانه لوحی است.
  • Segment gaid::-14 اضافه شد. نام بخش Mobile Traffic و تعریف آن ga:deviceCategory==mobile است.

رفع اشکال:

  • اطلاعات منطقه زمانی برای بازدیدها (نمایه ها) ثابت شده است. جزئیات : قبل از این اصلاح، در موارد خاصی هنگام فهرست کردن نمای (پروفایل) در مدیریت API، اطلاعات منطقه زمانی نادرست برای یک نما (نمایه) برگردانده شد. اکنون اطلاعات منطقه زمانی برای نماها (نمایه ها) با آنچه در رابط مدیریت Google Analytics تنظیم شده است سازگار است.

این نسخه عملیات نوشتن برای منابع Web Property، View (Profile) و Goal و مجموعه ای از 3 منبع جدید را معرفی می کند که مدیریت مجوزهای کاربر را فعال می کند.

API های راه اندازی و پیکربندی حساب

  • اکنون می توان نماها (نمایه ها) را ایجاد، به روز کرد، وصله کرد و حذف کرد. برای جزئیات بیشتر در مورد روش های جدید ، مرجع مشاهده (نمایه ها) را بررسی کنید.
  • اکنون می‌توان ویژگی‌ها و اهداف وب را ایجاد، به‌روزرسانی و وصله کرد. برای جزئیات بیشتر در مورد روش‌های جدید ، مرجع Web Properties و Goals را مرور کنید.
  • اکنون می توان یک ویژگی وب، مشاهده (نمایه) یا هدف را با روش get درخواست کرد.
  • این ویژگی‌ها در حال حاضر به‌عنوان پیش‌نمایش برنامه‌نویس در نسخه بتا محدود در دسترس هستند. اگر علاقه مند به ثبت نام هستید، درخواست دسترسی به نسخه بتا کنید .

مجوزهای کاربر در مدیریت API

  • منبع accountUserLinks جدید مدیریت مجوزهای حساب را برای کاربران امکان پذیر می کند.
  • منبع جدید webpropertyUserLinks مدیریت مجوزهای مالکیت را برای کاربران امکان پذیر می کند.
  • منبع profileUserLinks جدید مدیریت مجوزهای نمایش (نمایه) را برای کاربران امکان پذیر می کند.
  • مجوزهای یک کاربر مجاز اکنون به عنوان بخشی از منابع حساب ، ویژگی وب و مشاهده (نمایه) در دسترس است.
  • یک محدوده جدید معرفی شده است و برای مدیریت مجوزهای کاربر مورد نیاز است. https://www.googleapis.com/auth/analytics.manage.users .
  • برای جزئیات بیشتر به راهنمای برنامه نویس مجوزهای کاربر مراجعه کنید.

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

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

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

  • profileCount - تعداد نمایه یک دارایی را برمی‌گرداند. این به شما امکان می‌دهد تا ویژگی‌هایی را فیلتر کنید که هیچ نمایه‌ای ندارند (یعنی profileCount = 0).
  • industryVertical - عمودی/رده صنعت انتخاب شده برای یک دارایی را برمی‌گرداند.

رفع اشکال:

  • ویژگی eCommerceTracking منبع نمایه اکنون با تنظیمات تجارت الکترونیک در بخش مدیریت رابط وب سازگار است. زمانی که ردیابی تجارت الکترونیک فعال باشد true و در غیر این صورت false برمی گردد.
  • منبع Webproperty اکنون دارای یک ویژگی level است که نشان می‌دهد که ویژگی وب PREMIUM یا STANDARD است.
  • یک نقطه پایانی جدید به مدیریت API نسخه 3 برای دسترسی و اصلاح منابع آزمایشی اضافه شده است.
  • منبع Profile اکنون شامل یک ویژگی type برای تشخیص اینکه آیا یک نمایه برای یک وب سایت یا برنامه پیکربندی شده است، می باشد. دو مقدار ممکن عبارتند از: WEB یا APP .

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

  • کدهای خطا، دلایل و توضیحات جدید به بدنه پاسخ های خطای API اضافه شده است. همه کدها برای هر دو نسخه - نسخه 2.4 و نسخه 3.0 - مدیریت API مستند شده اند.

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

داده های جدید

  • مجموعه Advanced Segment اکنون حاوی یک قسمت segmentId است که می تواند در پارامتر بخش Data Export API استفاده شود.

تغییرات

  • نوع داده برای max-results به integer تغییر کرده است.

  • مقدار پیش فرض و حداکثر برای max-results به 1000 تغییر یافته است.

رفع اشکال

  • حساب‌ها، ویژگی‌های وب، و نمایه‌های آزمایش‌های Google Website Optimizer دیگر در مجموعه‌های مربوطه آنها گنجانده نمی‌شود.

این نسخه دو نسخه جدید از API را با بسیاری از ویژگی‌های جدید اضافه می‌کند و نسخه قدیمی را منسوخ می‌کند. تغییرات بر نحوه درخواست و مدیریت داده ها از API تأثیر می گذارد.

نسخه 3.0

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

  • داده های جدید

    • نمایش کامل اهداف رویداد
    • شناسه خصوصی وب داخلی که می تواند برای پیوند عمیق به رابط کاربری GA استفاده شود
    • تنظیمات نمایه برای صفحه پیش‌فرض و پارامترهای جستجوی سایت

  • تغییرات

نسخه 2.4

  • این یک ارتقاء نسخه جزئی است که عمدتاً با نسخه 2.3 موجود سازگار است.

  • تغییرات

    • سیاست سهمیه بندی جدید
    • ادغام با Google APIs Console برای مدیریت دسترسی API و درخواست سهمیه بیشتر
    • پشتیبانی مداوم از مکانیسم های مجوز موجود و OAuth 2.0
    • URL جدید برای درخواست: https://www.googleapis.com/analytics/v2.4/management/…
    • پاسخ ها فقط در XML
    • از کتابخانه سرویس گیرنده Google Data JavaScript پشتیبانی نمی شود
    • خروجی XML مطابق با نسخه 2.3 است، بنابراین سایر کتابخانه های سرویس گیرنده Google Data موجود به کار خود ادامه خواهند داد.

منسوخ شدن

  • ما در حال منسوخ شدن نسخه قدیمی 2.3 مدیریت API هستیم. به مدت دو ماه به کار خود ادامه می دهد و پس از آن تمام درخواست های v2.3 یک پاسخ v2.4 را برمی گرداند.

این نسخه بتا API مدیریت Google Analytics است!

اطلاعات جدید

کتابخانه های مشتری به روز شده

  • مدیریت API در همان کتابخانه Google Analytics Data Export API منتشر می شود. هر دو کتابخانه Google Data Java و JavaScript به روز شده اند. هر فید را می توان با تعیین URI فید مناسب برای متد getManagementFeed() کتابخانه ها دسترسی داشت.

مستندات جدید

  • بخش جدیدی از اسناد توسعه دهنده Google Analytics ایجاد شده است تا نحوه عملکرد مدیریت API جدید را توضیح دهد.