التقارير التزايدية

أصبحت 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.