הערות מוצר שהועברו לארכיון

בדף הזה מוצגים נתוני גרסה לגרסאות שנסגרו של Bid Manager API.

אפשר לעבור אל דף נתוני הגרסה הראשי של כל הגרסאות כדי גרסאות פעילות.

15 באפריל 2021

תכונות חדשות

הושקה גרסה 1.1 של Bid Manager API.

v1.1

סגירת שירותי SDF ופריט שירות

SDF ופריט נסגרים.

משתמשים שרוצים להוריד נתונים מובְנים קבצים או ניהול פריטים במקום זאת, השתמשו בכלי Display & Video 360 API

בעיות מוכרות

ללא.

6 באוגוסט 2020

תכונות חדשות

v1.1

נתיב ו דוחות שיוך (Attribution) של נתיבים

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. עם העמודות 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

קוד גרסה 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, מספר התוצאות שהחזירו ה-methods שווה לפרמטר שנוסף לאחרונה pageSize (ברירת המחדל היא 100 אם לא צוין). התשובות מכילות שדה חדש שנוסף שדה nextPageToken שמכיל אפשר להשתמש בה כדי לאחזר את קבוצת התוצאות הבאה. השדה הזה ריק אם התוצאות מוצה.

קוד גרסה 1 הבא לאחזור כל הדוחות ששייכים לשאילתה ספציפית:

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 לקבלת פרטים נוספים.

בעיות מוכרות

ללא.