يوفّر "مدير إعلانات Google" واجهة برمجة تطبيقات SOAP لكل من جهات الإبلاغ والتلاعب، مثل LineItems.
تتوفر مكتبات العملاء بعدة لغات. مثل AdX Seller API، تستخدم واجهة برمجة تطبيقات "مدير الإعلانات" OAuth2 للمصادقة.
لبدء استخدام أول طلب من واجهة برمجة التطبيقات، راجع البدء.
إعداد التقارير في واجهة برمجة تطبيقات "مدير الإعلانات"
توفِّر واجهة برمجة التطبيقات ReportService في "مدير الإعلانات" طريقتين لتشغيل التقارير وتنزيلها:
- إنشاء استعلام في واجهة المستخدم وتشغيله بناءً على معرفه.
- إنشاء ReportQuery مخصّص
باستخدام أيّ من الخيارَين، يتكوّن سير عمل واجهة برمجة التطبيقات من أربع خطوات:
- اطلب runReportJob.
- يمكنك إجراء استطلاع رأي عن حالة التقرير باستخدام getReportJobStatus.
- احصل على عنوان URL إلى التقرير المكتمل باستخدام getReportDownloadUrlWithOptions.
- نزِّل التقرير من عنوان URL المعروض.
لمزيد من التفاصيل، يُرجى الاطّلاع على دليل إعداد التقارير.
المناطق الزمنية لإعداد التقارير
على عكس واجهة برمجة تطبيقات Ad Exchange Seller REST API، في تقارير واجهة برمجة التطبيقات في "مدير الإعلانات"، يتم ضبط القيمة التلقائية على المنطقة الزمنية لشبكتك. ولتغيير ذلك، اضبط الحقل
TimeZoneType.
المقاييس وربط السمات بحساب "مدير إعلانات Google" من AdX
تتوفر الآن جميع مقاييس وأبعاد Ad Exchange Seller REST API المتوافقة في واجهة برمجة التطبيقات لإعداد تقارير "مدير الإعلانات". تم تغيير بعض الأسماء وتم إيقاف البعض الآخر. يُرجى الاطّلاع على الجداول أدناه للحصول على التفاصيل.
المقاييس / الأعمدة
يربط هذا الجدول مقاييس AdX بـ أعمدة "مدير الإعلانات".
| مقياس AdX | عمود "مدير الإعلانات" | اسم أداة طلبات البحث في "مدير الإعلانات" |
|---|---|---|
| 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 | نسبة النقر إلى الظهور |
| 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 | الشريحة الربعية 1 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | الشريحة الربعية 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" بسمات "مدير الإعلانات" .
| سمة AdX | سمة "مدير الإعلانات" | اسم أداة طلبات البحث في "مدير الإعلانات" |
|---|---|---|
| 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 | وحدات DoubleClick الإعلانية |
| 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 | قواعد التسعير |