التقارير التزايدية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى
واجهة Search Ads 360 Reporting API الجديدة واستخدامها.
بدلاً من تلقّي نسخة احتياطية من جميع البيانات في كل مرة تطلب فيها تقريرًا، يمكنك أن تطلب بشكل دوري فقط البيانات التي تغيّرت منذ آخر تقرير لك. ومن المرجح أن تكون هذه التقارير المتزايدة أصغر بكثير من تقرير كامل.
إذا طلبت تقارير متزايدة، فيجب أن تكون على دراية بما يلي:
- مع ذلك، من الأفضل طلب تقرير كامل من حين لآخر تحسبًا
لفقدان بعض التغييرات المتزايدة. على سبيل المثال، إذا طلبت تقارير تدريجية أسبوعية خلال شهر كانون الثاني (يناير)، يجب في نهاية شهر شباط (فبراير) طلب تقرير كامل عن
شهر كانون الثاني (يناير) لضمان تلقّي جميع بيانات شهر كانون الثاني (يناير).
- بسبب أنّه لا يمكن دائمًا تحديد ما إذا كانت بعض الكيانات قد تغيّرت أم لا، سيحتوي التقرير التزايدي على كيان إذا اشتبهت "إعلانات شبكة البحث 360" في أنّ العنصر قد تغيّر. وهذا يعني أنّ التقارير المتزايدة قد تحتوي على بيانات لم تتغيّر.
لطلب تقرير تزايدي، حدِّد إحدى سمات Reports.request.timeRange
التالية:
changedMetricsSinceTimestamp=timestampيطلب هذا التقرير مقاييس التغييرات منذ الطابع الزمني المحدّد. بما أنّه يتم
تخزين المقاييس بدقة يوميًا وقد تتغير لمدة يوم واحد وليس آخر، يجب تقسيم هذه الطلبات حسب اليوم (يجب أن يتوفّر عمود date). على سبيل المثال، إذا كان تقرير keyword يحتوي على الأعمدة clicks وactions وdate، سيعرض صفًا لكل كلمة رئيسية وتاريخ تغيّر العدد المسجَّل للنقرات أو الإجراءات منذ الطابع الزمني المحدّد.
يجب ألا يكون الطابع الزمني قبل 8 أيام من وقت الطلب. للحصول على
كل المقاييس المتغيّرة، احرص على تقديم طلب changedMetricsSinceTimestamp
مرة واحدة على الأقل كل 7 أيام، وإعداد تقرير كامل لكل تاريخ
بعد استقرار المقاييس (الانتظار لمدة 7 أيام على الأقل). ومن أمثلة
الأنماط إنشاء تقريرين كل يوم: تقرير
متزايد للمقاييس التي تغيرت خلال آخر 36 ساعة، وتقرير
كامل للمقاييس التي حدثت قبل 8 أيام.
changedAttributesSinceTimestamp=timestampيطلب هذا الحقل السمات التي تم تغييرها منذ الطابع الزمني المحدّد. ويمكن أن يتضمّن طلب
changedAttributesSinceTimestamp أعمدة السمات فقط (بدون أعمدة مقياس أو أعمدة)، ولا يعمل مع
تقارير الأحداث الأوّلية، مثل
تقارير conversion. على سبيل المثال، سيعرض تقرير campaign الذي يتضمّن العمودَين dailyBudget وcampaignStartDate صفًا لكل حملة تغيّرت ميزانيتها اليومية أو تاريخ بدئها منذ الطابع الزمني المحدّد.
يُرجى العلم أنّه لا يتم تسجيل التغييرات التي تطرأ على السمات الرئيسية في تقارير
changedAttributesSinceTimestamp. على سبيل المثال، قد تكتسب كلمة رئيسية استراتيجية عروض أسعارها من المجموعة الإعلانية الرئيسية.
حتى إذا تم تخصيص استراتيجية عروض أسعار جديدة للمجموعة الإعلانية، قد لا تظهر هذه الكلمة الرئيسية في التقرير. عادةً ما تحتوي أعمدة السمات التي تعتمد قيمتها على العناصر الرئيسية (وبالتالي يمكن أن تتغيّر بدون الاطّلاع عليها من خلال تقارير changedAttributesSinceTimestamp) على البادئة "فعالة"، مثل effectiveLabelIds أو effectiveBidStartegy.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-12-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-12-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
