آپدیت Search Analytics API برای نمایش شفافیت در تازگی داده‌ها

گوگل به‌تازگی آپدیت Search Analytics API خودش رو با یک فیلد جدید در بخش metadata آپدیت کرده که به توسعه‌دهنده‌ها و متخصص‌های سئو کمک می‌کنه بفهمن آیا داده‌هایی که دارن بررسی می‌کنن هنوز کامل نشده یا همچنان در حال پردازشه.

این آپدیت جدید باعث میشه که سطح شفافیت در مورد تازگی داده‌ها (Data Freshness) بالا بره و افرادی که به آمارهای دقیق و لحظه‌ای برای تصمیم‌گیری‌های مارکتینگ نیاز دارن، راحت‌تر متوجه بشن که داده‌هایی که در اختیار دارن، نهایی هستن یا نه. این موضوع به‌خصوص برای تحلیل دقیق‌تر داده‌های سرچ کنسول و اجتناب از برداشت اشتباه از آمارهای اولیه بسیار مهمه.

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

جزئیات جدید در آپدیت Search Analytics API

در آپدیت جدید Search Analytics API گوگل، فیلد metadata زمانی ظاهر میشه که در درخواست API از پارامتر dataState با مقدار all یا hourly_all استفاده بشه. این موضوع باعث میشه شما به داده‌هایی دسترسی پیدا کنید که هنوز در حال جمع‌آوری هستن و به‌طور کامل پردازش نشده‌ان.

در حال حاضر، دو مقدار جدید در این بخش معرفی شده:

• first_incomplete_date: نشون میده از چه تاریخی داده‌ها هنوز ناقص هستن. این مقدار فقط زمانی دیده میشه که داده‌ها بر اساس تاریخ دسته‌بندی شده باشن.

• first_incomplete_hour: نشون میده از کدوم ساعت داده‌ها هنوز کامل نیستن. این مقدار فقط در صورت گروه‌بندی ساعتی نمایش داده میشه.

این دو مقدار به شما کمک می‌کنن تا تشخیص بدید که آمارهای اخیر می‌تونن به‌عنوان داده‌های نهایی در نظر گرفته بشن یا ممکنه هنوز با پردازش نهایی گوگل تغییر کنن.

چرا این موضوع برای گزارش‌گیری سئو اهمیت داره؟

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

گوگل توی مستندات رسمی خودش گفته:

“تمام مقادیری که بعد از first_incomplete_date میان، ممکنه هنوز به‌طور قابل توجهی تغییر کنن.”

برای کسانی که از سیستم‌های گزارش‌گیری خودکار استفاده می‌کنن، این آپدیت یه قابلیت ارزشمنده؛ چون میشه منطق هوشمندتری تعریف کرد. مثلاً می‌تونید به‌صورت خودکار، داده‌هایی که تازه هستن ولی هنوز ناقص‌ان رو علامت‌گذاری یا حتی از گزارش حذف کنید تا تحلیل‌ها دقیق‌تر باشن و مخاطبان گزارش‌ها یا مشتریان سئو دچار برداشت اشتباه نشن.

هماهنگی زمانی در آپدیت Search Analytics API

در آپدیت جدید Search Analytics API، تمام زمان‌هایی که در فیلد metadata نمایش داده میشن، بر اساس تایم‌زون America/Los_Angeles هستن؛ یعنی فارغ از اینکه درخواست از کجا ارسال شده یا وب‌سایت مربوط به چه منطقه‌ای باشه، زمان‌ها همیشه بر اساس منطقه لس‌آنجلس ثبت میشن. بنابراین توسعه‌دهنده‌ها باید این نکته رو در زمان یکپارچه‌سازی داده‌ها با سیستم‌های محلی در نظر بگیرن.

سازگاری کامل با ساختار قبلی API

گوگل این آپدیت رو به‌صورت کاملاً backward-compatible پیاده‌سازی کرده. یعنی فیلد جدید metadata به‌عنوان یک آبجکت اختیاری به پاسخ‌ها اضافه شده و به‌صورت پیش‌فرض تغییری در خروجی‌های قبلی API ایجاد نمی‌کنه. به‌عبارت دیگه، اگر کسی از قبل از این API استفاده می‌کرده، با این آپدیت دچار مشکل نمیشه و فقط در صورت نیاز می‌تونه از ویژگی جدید استفاده کنه.

نکات پیشنهادی برای پیاده‌سازی بهتر

برای اینکه بیشترین بهره‌برداری رو از این آپدیت Search Analytics API داشته باشید، گوگل چند توصیه مهم ارائه داده:

• در زمان درخواست داده‌های جدید، حتماً بررسی کنید که آیا فیلد metadata موجود هست یا نه.

• اگه داده‌ها هنوز کامل نشده بودن، بهتره در گزارش‌ها هشدار یا یادداشت تکمیلی درج کنید.

• زمان به‌روزرسانی گزارش‌های خودکار رو طوری تنظیم کنید که بعد از عبور از بازه ناقص باشه تا آمار دقیق‌تری داشته باشید.

گوگل همچنین یادآوری کرده که این API به‌دلیل محدودیت‌های سیستم، فقط سطرهای برتر (Top Rows) رو ارائه میده و شامل مجموعه داده کامل نیست.

آینده‌ای شفاف‌تر در گزارش‌گیری سئو

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

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

در حال حاضر، این فیلد metadata از طریق درخواست‌های استاندارد API در دسترسه و جزئیات کامل پیاده‌سازی هم در مستندات رسمی Search Analytics API منتشر شده.

ترجمه : Google Updates Search Analytics API To Clarify Data Freshness