يوفّر "مدير إعلانات Google" واجهة برمجة تطبيقات SOAP لإعداد التقارير ومعالجة عناصر إدارة الإعلانات، مثل LineItems.
تتوفّر مكتبات برامج بعدة لغات. مثل AdX Seller API، تستخدم Ad Manager API بروتوكول OAuth2 للمصادقة.
للبدء في تقديم أول طلب بيانات من واجهة برمجة التطبيقات، يُرجى الاطّلاع على البدء.
إعداد التقارير في Ad Manager API
توفّر واجهة برمجة التطبيقات ReportService في Ad Manager طريقتَين لتشغيل التقارير وتنزيلها:
- إنشاء طلب بحث في واجهة المستخدم وتشغيله استنادًا إلى معرّفه
- إنشاء ReportQuery مخصّص
في كلا الخيارَين، يتألف سير عمل واجهة برمجة التطبيقات من أربع خطوات:
- استدعِ runReportJob.
- استطلِع حالة التقرير باستخدام getReportJobStatus.
- احصل على عنوان URL للتقرير المكتمل باستخدام getReportDownloadUrlWithOptions.
- نزِّل التقرير من عنوان URL الذي تم عرضه.
لمزيد من التفاصيل، يُرجى الاطّلاع على دليل إعداد التقارير.
المناطق الزمنية لإعداد التقارير
على عكس Ad Exchange Seller REST API، يتم ضبط التقارير في Ad Manager API تلقائيًا على المنطقة الزمنية لشبكتك. لتغيير ذلك، اضبط الحقل
TimeZoneType.
ربط المقاييس والسمات في AdX بـ "إدارة إعلانات Google"
تتوفّر الآن جميع مقاييس وسمات Ad Exchange Seller REST API المتوافقة في واجهة برمجة التطبيقات لإعداد التقارير في "إدارة إعلانات Google". تم تغيير بعض الأسماء وتم إيقاف بعضها نهائيًا. يُرجى الاطّلاع على الجداول أدناه لمعرفة التفاصيل.
المقاييس / الأعمدة
يربط هذا الجدول مقاييس AdX بأعمدة "إدارة إعلانات Google".
| مقياس AdX | عمود "إدارة إعلانات Google" | اسم أداة طلب البحث في "مدير إعلانات Google" |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | مرّات الظهور التي تم تفعيل "العرض النشط" لها |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | مرات الظهور التي تم قياسها في العرض النشط |
| ACTIVE_VIEW_MEASURABLE_RATIO | (متوقّفة نهائيًا) | (متوقّفة نهائيًا) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | مرّات الظهور التي تمّت مشاهدتها في العرض النشط |
| ACTIVE_VIEW_VIEWABLE_RATIO | (متوقّفة نهائيًا) | (متوقّفة نهائيًا) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | متوسط الوقت القابل للعرض (بالثواني) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | مرات ظهور الإعلان |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | التكلفة الفعلية لكل ألف ظهور للإعلان |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | طلبات عرض الإعلانات |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | التغطية |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | نسبة النقر إلى الظهور لطلب الإعلان |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | التكلفة الفعلية لكل ألف ظهور لطلب الإعلان |
| عدد النقرات | AD_EXCHANGE_CLICKS | النقرات |
| COST_PER_CLICK | AD_EXCHANGE_CPC | تكلفة النقرة |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | طلبات عرض الإعلان في الصفقات |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | الاستجابات لعروض الأسعار في الصفقات |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | نسبة مطابقة الصفقات |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | الطلبات المطابقة للصفقات |
| الأرباح | AD_EXCHANGE_ESTIMATED_REVENUE | الإيرادات المقدَّرة |
| INDIVIDUAL_AD_IMPRESSIONS | (متوقّفة نهائيًا) | (متوقّفة نهائيًا) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | نسبة النقر إلى ظهور الإعلان |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (اقتراح جديد) AD_EXCHANGE_AD_ECPM | (اقتراح جديد) التكلفة التقديرية لكل ألف ظهور للإعلان |
| LIFT_RATE | AD_EXCHANGE_LIFT | تحسين |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | الطلبات المطابقة |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | التكلفة الفعلية لكل ألف ظهور مطابق |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | معدّل مغادرة الفيديو أثناء تحميله |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | معدل الانسحاب من مشاهدة الفيديو |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | الربع الأول من الفيديو |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | الربع الثالث من الفيديو |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | معدّل تخطّي الإعلانات في TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | عدد مشاهدات إعلانات TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | نسبة المشاهدات المكتملة لإعلانات TrueView |
الأبعاد
يربط هذا الجدول سمات AdX بسمات "إدارة إعلانات Google".
| سمة AdX | سمة "مدير إعلانات Google" | اسم أداة طلب البحث في "مدير إعلانات Google" |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | موقع إلكتروني |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | المواقع الجغرافية المستهدَفة للإعلانات |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | العلامات |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (غير متوفّر) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | أحجام المساحات الإعلانية |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | نطاقات المُعلِن |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | المعلنون |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | مجالات المعلنين |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | الوكالات |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (غير متوفّر) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | العلامات التجارية |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (غير متوفّر) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | أنواع العلامات التجارية |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (غير متوفّر) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | شبكات المشترين |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (غير متوفّر) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | البلدان |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | أحجام تصميمات الإعلانات |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (غير متوفّر) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (غير متوفّر) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | القنوات |
| التاريخ | AD_EXCHANGE_DATE | الأيام |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | أرقام تعريف الصفقات |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | أسماء الصفقات |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (غير متوفّر) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | الوحدات الإعلانية في DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | مصادر الطلبات |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | مواقع Google الإلكترونية |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | منصّات عرض الإعلانات (DSP) |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | الأنواع القابلة للتوسيع |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | ملكية المساحات الإعلانية |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | أسماء شركاء الشبكة |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | أسماء التطبيقات |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | أسماء شركات النقل |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | الأجهزة |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | أنواع المستودعات |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | أنظمة التشغيل |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | النطاق التردّدي |
| الشهر | AD_EXCHANGE_MONTH | الأشهر |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | فئات الأجهزة |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (غير متوفّر) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | المنتجات |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (غير متوفّر) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | أنواع الاستهداف |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (غير متوفّر) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | أنواع المعاملات |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (غير متوفّر) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | عناوين URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (غير متوفّر) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | مدد إعلانات الفيديو |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | أنواع إعلانات الفيديو |
| الأسبوع | AD_EXCHANGE_WEEK | الأسابيع |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (غير متوفّر) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | قواعد التسعير |