נתוני גרסה שהועברו לארכיון

בדף הזה מוצגים נתוני גרסה לגרסאות שנסגרו של 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

תכונות חדשות

גרסה 1.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.

בעיות מוכרות

ללא.