في ما يلي بعض حالات الاستخدام الشائعة لواجهة برمجة التطبيقات DV360 Exchange Reporting API.
إنشاء تقرير
يمكنك الرجوع إلى مستندات generateReport
تعليمات حول كيفية إنشاء تقرير.
الحصول على التقرير (المعروف سابقًا باسم "سحب التقرير")
راجِع مستندات getReport للحصول على تعليمات عن كيفية إجراء ذلك.
لسحب تقرير.
الأعمدة في "صف التقرير" في ملف التقرير
| الحقول | ملاحظات |
|---|---|
| تاريخ الحدث حسب التوقيت العالمي المتفق عليه | string تاريخ التقرير بالتنسيق YYYYMMDD. |
| ساعة الحدث بالتوقيت العالمي المتفق عليه | string الساعة من التقرير. تُستخدَم في تقارير كل ساعة، والتي تمثّل الساعة من اليوم. القيم من 0 إلى 23، علمًا أنّ 0 تمثّل [0:00:00 ~ 1:00:00) بالتوقيت العالمي المنسّق (UTC). |
| الرقم التعريفي للناشر | سلسلة الرقم التعريفي للناشر، على سبيل المثال، "10005_1350300". |
| الرقم التعريفي لتصميم الإعلان | string (تنسيق int64) رقم تعريف تصميم الإعلان. |
| نوع تصميم الإعلان | string نوع تصميم الإعلان لصف التقرير، مثل صورة أو صوت. يمكن العثور على عمليات الربط في قسم "ربط الكيانات". |
| رقم تعريف البلد | string رقم تعريف البلد (المنطقة). يمكن الوصول إلى عملية الربط من خلال ملفات قارئ الكيان من خلال واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" أو واجهة برمجة تطبيقات DoubleClick Bid Manager. |
| رقم تعريف الشريك | سلسلة رقم تعريف الشريك للمشتري (يظهر عادةً الرقم التعريفي للشريك في "مساحة العرض والفيديو 360") |
| رقم تعريف مصدر المستودع | string رقم تعريف مصدر المستودع. يرتبط هذا الحقل بحقل "رقم تعريف الصفقة" من الطلب. |
| البيئة | string نوع البيئة، مثلًا، جهاز جوّال أو كمبيوتر مكتبي. يرتبط هذا الحقل بحقل "نوع الجهاز" الوارد في الطلب. يمكن العثور على عمليات الربط في قسم "ربط الكيانات". |
| أسبوع التوقيت العالمي المنسَّق | string يمثل تاريخ أول يوم من الأسبوع الأسبوع في صف التقرير. |
| شهر التوقيت العالمي المنسَّق (UTC) | string الشهر الذي يتضمّن السنة في صف التقرير بالتنسيق YYYY/MM |
| مرات الظهور | string (تنسيق int64) قيمة الظهور في تاريخ/ساعة/أسبوع محدّد |
| تكلفة مرات الظهور (بالدولار الأمريكي) | number (تنسيق مزدوج) تكلفة مرات الظهور في تاريخ/ساعة/أسبوع محدّد، بالعملة بالدولار الأمريكي. |
| مرات الظهور غير الصالحة | string (تنسيق int64) مرّة ظهور غير صالحة للزيارات في الأسبوع المحدّد. |
| تكلفة مرات الظهور غير الصالحة (بالدولار الأمريكي) | string (تنسيق int64) مرّة ظهور غير صالحة للزيارات في الأسبوع المحدّد، بالعملة بالدولار الأمريكي. |