یادداشت های انتشار بایگانی شده

این صفحه یادداشت‌های انتشار نسخه‌های غروب آفتاب Bid Manager API را ارائه می‌کند.

برای همه نسخه‌ها به نسخه‌های زنده، به صفحه اصلی یادداشت‌های انتشار ما بروید.

15 آوریل 2021

ویژگی های جدید

Released Bid Manager API نسخه 1.1.

نسخه 1.1

خدمات SDF و Line Item غروب آفتاب

سرویس‌های SDF و Line Item اکنون غروب هستند.

کاربرانی که به دنبال دانلود فایل‌های داده ساختاریافته یا مدیریت موارد خط هستند، باید از Display & Video 360 API استفاده کنند.

مسائل شناخته شده

هیچ کدام.

6 آگوست 2020

ویژگی های جدید

نسخه 1.1

گزارش‌های اسناد مسیر و مسیر

report types TYPE_PATH و TYPE_PATH_ATTRIBUTION اکنون فعال هستند.

این شامل افزودن فیلدهای جدید 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

ویژگی های جدید

نسخه 1.1

اجرای پرس و جو ناهمزمان

روش Queries.createquery و Queries.runquery اکنون امکان اجرای پرس و جوها را به صورت ناهمزمان می دهد.

برای جزئیات بیشتر، پارامتر جدید asynchronous در createquery و runquery ببینید.

مسائل شناخته شده

هیچ کدام.

14 ژانویه 2020

ویژگی های جدید

نسخه 1.1

زمان شروع برنامه پرس و جو

روش Queries.createquery اکنون اجازه می دهد تا تاریخی را که در آن زمان بندی اجرای پرس و جو شروع می شود، مشخص کنید.

برای جزئیات بیشتر به فیلد جدید schedule.startTimeMs مراجعه کنید.

مسائل شناخته شده

هیچ کدام.

8 ژانویه 2020

ویژگی های جدید

نسخه 1.1

داده های فهرست مخاطبان هدف را تغییر دهید

روش Queries.createquery اکنون امکان تعیین اینکه آیا داده‌های فهرست مخاطبان باید به سفارش‌های درج خاص یا آیتم‌های خط محدود شود یا خیر، امکان‌پذیر است.

برای جزئیات بیشتر به قسمت جدید params.options.includeOnlyTargetedUserLists مراجعه کنید.

مسائل شناخته شده

هیچ کدام.

19 نوامبر 2019

ویژگی های جدید

نسخه 1.1

فیلتر یک به یک برای گزارش نگاشت ستون

فیلترهایی که به چندین ستون گزارش نگاشت شده اند، اکنون به ستون های تک نگاشت می شوند.

برای مثال، در نسخه 1، شامل فیلتر FILTER_ADVERTISER ، گزارشی با ستون‌های «آگهی‌دهنده» علاوه بر «شناسه آگهی‌دهنده» ارائه می‌کند. در نسخه 1.1، تمام ستون های گزارش فیلترهای مخصوص به خود را دارند. به عنوان مثال، یک فیلتر جدید FILTER_ADVERTISER_NAME به "تبلیغ کننده" نگاشت می شود. برای دریافت هر دو ستون "Advertiser ID" و "Advertiser" در گزارش‌ها، هر دو فیلتر FILTER_ADVERTISER و FILTER_ADVERTISER_NAME به ترتیب باید در درخواست‌های Queries.createquery گنجانده شوند.

به طور دقیق تر، درخواست createquery :

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

یک فایل گزارش با هدرهای زیر در v1 ایجاد می کند:

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);

صفحه بندی

نسخه 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 مراجعه کنید.

مسائل شناخته شده

هیچ کدام.