אנחנו מעבירים בשלב זה קבוצת משנה של סוגי דוחות מדיווח אופליין לדיווח מיידי. אחרי העברת משתמש, התגובות של queries.list יכללו דוחות מיידיים קיימים. בפוסט הזה בבלוג אפשר לקרוא מידע נוסף.

דף זה תורגם על ידי Cloud Translation API.

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

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

בעיות מוכרות

ללא.