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

این صفحه یادداشت‌های انتشار نسخه‌های غروب آفتاب 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);
فیلتر اصلی فیلترهای اضافه شده
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 مراجعه کنید.

مشکلات شناخته شده

هیچ یک.