ملاحظات الإصدار المؤرشفة

توفّر هذه الصفحة ملاحظات الإصدار للإصدارات التي تم إيقافها نهائيًا من Bid Manager API.

انتقِل إلى صفحة ملاحظات الإصدار الرئيسية للاطّلاع على جميع الإصدارات التي تم طرحها.

15 نيسان (أبريل) 2021

الميزات الجديدة

تم طرح الإصدار 1.1 من Bid Manager API.

v1.1

إيقاف خدمات SDF و"العناصر" نهائيًا

تمّ إيقاف خدمتَي SDF والعنصر نهائيًا.

المستخدمون الذين يسعون إلى تنزيل البيانات المنظَّمة الملفات أو إدارة تفاصيل الإعلانات بدلاً من ذلك، يمكنك استخدام شاشة العرض Video 360 API.

المشاكل المعروفة

بلا عُري

6 آب (أغسطس) 2020

الميزات الجديدة

الإصدار 1.1

المسار تقارير تحديد مصدر المسارات

يتم بث قناتي TYPE_PATH وTYPE_PATH_ATTRIBUTION report types الآن.

ويشمل ذلك إضافة الحقل الجديد params.options.pathQueryOptions (الذي يحتوي على الحقلين pathFilters وchannelGrouping) إلى موارد query و report.

تمت إضافة Filters جديد:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

تمت إضافة Metrics جديد:

  • METRIC_ACTIVITY_REVENUE
  • METRIC_CONVERTING_PATHS
  • METRIC_EXPOSURE_CONVERSION_RATE
  • METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
  • METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
  • METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
  • METRIC_PATH_CONVERSION_RATE
  • METRIC_PROVISIONAL_IMPRESSIONS
  • METRIC_TOTAL_EXPOSURES
  • METRIC_TOTAL_PATHS

المشاكل المعروفة

بلا عُري

20 آذار (مارس) 2020

الميزات الجديدة

v1.1

تنفيذ طلب بحث غير متزامن

تتيح الآن طريقة Queries.createquery وQueries.runquery تنفيذ طلبات البحث بشكل غير متزامن.

اطّلِع على المَعلمة الجديدة asynchronous في createquery و runquery لمزيد من التفاصيل.

المشاكل المعروفة

بلا عُري

14 كانون الثاني (يناير) 2020

الميزات الجديدة

الإصدار 1.1

وقت بدء الجدول الزمني لطلب البحث

طريقة واحدة (Queries.createquery) الآن يسمح بتحديد التاريخ الذي تبدأ فيه جداول تشغيل الاستعلام.

اطّلِع على الحقل الجديد schedule.startTimeMs للحصول على مزيد من التفاصيل.

المشاكل المعروفة

بلا عُري

8 كانون الثاني (يناير) 2020

الميزات الجديدة

v1.1

تفعيل/إيقاف بيانات قوائم المستخدمين المستهدَفين

تتيح الآن طريقة Queries.createquery تحديد ما إذا كان يجب اقتصار بيانات قائمة الجمهور على طلبات إدراج أو عناصر معيّنة.

عرض الحقل الجديد params.options.includeOnlyTargetedUserLists لمزيد من التفاصيل.

المشاكل المعروفة

بلا عُري

19 تشرين الثاني (نوفمبر) 2019

الميزات الجديدة

v1.1

فلتر واحد لواحد للإبلاغ عن ربط الأعمدة

يتم الآن ربط الفلاتر التي تم ربطها بأعمدة تقارير متعدّدة بعمود واحد والأعمدة.

على سبيل المثال، في الإصدار 1، يؤدي تضمين الفلتر FILTER_ADVERTISER إلى إنشاء تقرير يتضمّن عمودَي "المعلِن" بالإضافة إلى "الرقم التعريفي للمعلِن". في الإصدار 1.1، كل تحتوي أعمدة التقارير على فلاتر خاصة بها. على سبيل المثال، يتمّ ربط فلتر جديد FILTER_ADVERTISER_NAME بـ "المعلِن". للحصول على عمودَي "المعلن الرقم التعريفي" و"المعلن" في التقارير، يجب تضمين الفلترَين FILTER_ADVERTISER و FILTER_ADVERTISER_NAME على التوالي في طلبات Queries.createquery .

على وجه التحديد، يشمل طلب createquery ما يلي:

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

ملف تقرير يحتوي على العناوين التالية في الإصدار 1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

والعناوين التالية في الإصدار 1.1:

Advertiser,Impressions

رمز الإصدار 1 التالي المستخدَم للحصول على أعمدة التقرير:

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);

على غرار ما يلي في الإصدار 1.1 (فلتر الملاحظة) طلب):

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);
الفلتر الأصلي فلاتر مضافة
FILTER_ADVERTISER FILTER_ADVERTISER_NAME
FILTER_ADVERTISER_INTEGRATION_CODE
FILTER_ADVERTISER_INTEGRATION_STATUS
FILTER_AD_POSITION FILTER_AD_POSITION_NAME
FILTER_CARRIER FILTER_CARRIER_NAME
FILTER_CHANNEL_ID FILTER_CHANNEL_NAME
FILTER_CITY FILTER_CITY_NAME
FILTER_COMPANION_CREATIVE_ID FILTER_COMPANION_CREATIVE_NAME
FILTER_DMA FILTER_DMA_NAME
FILTER_INSERTION_ORDER FILTER_INSERTION_ORDER_NAME
FILTER_PARTNER FILTER_PARTNER_NAME
FILTER_PARTNER_STATUS
FILTER_REGION FILTER_REGION_NAME
FILTER_TRUEVIEW_DMA FILTER_TRUEVIEW_DMA_NAME
FILTER_TRUEVIEW_IAR_REGION FILTER_TRUEVIEW_IAR_REGION_NAME
FILTER_USER_LIST_FIRST_PARTY FILTER_USER_LIST_FIRST_PARTY_NAME
FILTER_USER_LIST_THIRD_PARTY FILTER_USER_LIST_THIRD_PARTY_NAME
تقسيم النتائج على عدّة صفحات

الإصدار 1.1 يضيف تقسيمًا على صفحات إلى الطرق Queries.listqueries و Reports.listreports

في الإصدار 1.1، يكون عدد النتائج التي تعرضها هذه الطرق مساويًا لمَعلمة تمت إضافتها حديثًا، وهي pageSize (تكون القيمة التلقائية لها 100 في حال عدم تحديدها). تحتوي الردود على حقل nextPageToken تمت إضافته حديثًا ويمكن استخدامه لاسترداد المجموعة التالية من النتائج. يكون هذا الحقل فارغًا إذا تم استخدام كل النتائج .

رمز v1 التالي لاسترداد جميع التقارير التي تنتمي إلى طلب بحث محدد:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

على غرار ما يلي في الإصدار 1.1، مواصلة استرداد جميع التقارير:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    List<Report> reports = new ArrayList<>(reportListResponse.getReports());
    while (reportListResponse.getNextPageToken() != null
        && reportListResponse.getNextPageToken().length() > 0) {
      // Get next set, or page, of results.
      reportListResponse =
          service
              .reports()
              .listreports(queryId)
              .setPageToken(reportListResponse.getNextPageToken())
              .execute();
      reports.addAll(reportListResponse.getReports());
    }

    return reports;
  }
}

اطّلِع على مستندات Queries.listqueries و methods Reports.listreports لمزيد من التفاصيل.

المشاكل المعروفة

بلا عُري