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

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

الانتقال إلى صفحة ملاحظات الإصدار الرئيسية لجميع الإصدارات وإصدارات مباشرة.

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

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

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

v1.1

إيقاف خدمات SDF وتفاصيل الإعلانات

SDF والعنصر تم إيقافها الآن.

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

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

بلا عُري

6 آب (أغسطس) 2020

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

v1.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

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

v1.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 بـ "المعلِن". للحصول على كلٍ من عمود "المعلن ID (رقم التعريف) و"المعلن" الأعمدة في التقارير، وكلاهما الفلتران 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

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

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 و طريقة Reports.listreports للحصول على المزيد من التفاصيل.

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

بلا عُري