به جای اینکه هر بار که گزارشی را درخواست می‌کنید، به‌جای دریافت کمپ از همه داده‌ها، می‌توانید به صورت دوره‌ای فقط داده‌هایی را درخواست کنید که از آخرین گزارش شما تغییر کرده است. این گزارش های افزایشی احتمالاً به طور قابل توجهی کوچکتر از یک گزارش کامل خواهند بود.
در صورت درخواست گزارش های افزایشی، باید از موارد زیر آگاه باشید:
- هنوز ایده خوبی است که هر چند وقت یکبار درخواست گزارش کامل کنید، فقط در صورتی که برخی تغییرات تدریجی از بین بروند. به عنوان مثال، اگر در طول ژانویه درخواست گزارش های افزایشی هفتگی دارید، در پایان فوریه باید یک گزارش کامل برای ژانویه درخواست کنید تا مطمئن شوید که همه داده های ژانویه را دریافت می کنید.
- از آنجایی که همیشه نمی‌توان تعیین کرد که آیا برخی از موجودیت‌ها تغییر کرده‌اند یا خیر، اگر Search Ads 360 حتی مشکوک به تغییر آن موجودیت باشد، یک گزارش افزایشی حاوی یک موجودیت خواهد بود. این بدان معناست که گزارش‌های افزایشی ممکن است حاوی داده‌هایی باشند که تغییر نکرده‌اند.
برای درخواست گزارش افزایشی، یکی از ویژگی های Reports.request.timeRange زیر را مشخص کنید:
-
changedMetricsSinceTimestamp= timestamp معیارهایی را درخواست می کند که از زمان تعیین شده تغییر کرده است. از آنجایی که معیارها با جزئیات روزانه ذخیره می‌شوند و ممکن است برای یک روز تغییر کنند، اما نه روز دیگر، چنین درخواست‌هایی باید بر اساس روز تقسیم شوند (ستون
dateباید وجود داشته باشد). به عنوان مثال، یک گزارشkeywordبا ستون‌هایclicks،actionsوdate، یک ردیف برای هر کلمه کلیدی و تاریخی برمی‌گرداند که در آن تعداد کلیک‌ها یا اقدامات ثبت‌شده از زمان مشخص شده تغییر کرده است.مهر زمانی نباید زودتر از 8 روز قبل از زمان درخواست باشد. برای ثبت همه معیارهای در حال تغییر، حتماً حداقل هر 7 روز یک بار یک درخواست
changedMetricsSinceTimestampارائه دهید و پس از تسویه معیارها، یک گزارش کامل برای هر تاریخ تهیه کنید (ایمن تر است که حداقل 7 روز صبر کنید). یک الگوی نمونه این است که هر روز دو گزارش ایجاد کنید: یک گزارش افزایشی برای معیارهایی که در 36 ساعت گذشته تغییر کرده‌اند و یک گزارش کامل برای معیارهایی که 8 روز پیش رخ داده‌اند.-
changedAttributesSinceTimestamp= timestamp ویژگی هایی را درخواست می کند که از زمان نشان داده شده تغییر کرده اند. یک درخواست
changedAttributesSinceTimestampفقط می تواند شامل ستون های ویژگی باشد (بدون ستون های متریک یا بخش)، و برای گزارش های رویداد خام مانند گزارش هایconversionکار نمی کند. به عنوان مثال، یک گزارشcampaignبا ستون‌هایdailyBudgetوcampaignStartDateیک ردیف برای هر کمپینی که بودجه روزانه یا تاریخ شروع آن از زمان مشخص شده تغییر کرده است، برمی‌گرداند.توجه داشته باشید که تغییرات در ویژگی های والد در گزارش هایchangedAttributesSinceTimestampثبت نمی شود. برای مثال یک کلمه کلیدی ممکن است استراتژی پیشنهادی خود را از گروه تبلیغاتی والد به ارث ببرد. حتی اگر یک استراتژی پیشنهادی جدید به گروه تبلیغات اختصاص داده شود، ممکن است این کلمه کلیدی در گزارش ظاهر نشود. ستون‌های مشخصه‌ای که مقدار آن‌ها به موجودیت‌های اصلی بستگی دارد (و بنابراین می‌توانند بدون دریافت گزارش‌هایchangedAttributesSinceTimestampتغییر کنند) معمولاً دارای پیشوند «effective» هستند، مانندeffectiveLabelIdsیاeffectiveBidStartegy.