Archiwalne informacje o wersjach

Ta strona zawiera informacje o wersjach interfejsu Bid Manager API, które są wycofywane.

Przejdź na naszą główną stronę z informacjami o wersjach, gdzie znajdziesz wszystkie wersje wersji online.

15 kwietnia 2021 r.

Nowe funkcje

Udostępniliśmy interfejs Bid Manager API w wersji 1.1.

1.1

Wycofanie obsługi plików SDF i elementów zamówienia

SDF i element zamówienia wycofujemy usługi.

Użytkownicy, którzy chcą pobrać pliki uporządkowanych danych lub zarządzać elementami zamówienia, muszą zamiast tego korzystać z interfejsu Display & Video 360 API.

Znane problemy

Brak.

6 sierpnia 2020 r.

Nowe funkcje

1.1

Ścieżki Raporty atrybucji ścieżki

TYPE_PATH i TYPE_PATH_ATTRIBUTION report types są teraz dostępne.

Obejmuje to dodanie nowego pola params.options.pathQueryOptions (który zawiera pola pathFilters i channelGrouping) do query i report materiałów.

Dodano nowe Filters:

• FILTER_CHANNEL_GROUPING
• FILTER_EVENT_TYPE
• FILTER_PATH_EVENT_INDEX
• FILTER_PATH_PATTERN_ID

Dodano nowe 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

Znane problemy

Brak.

20 marca 2020 r.

Nowe funkcje

1.1

Asynchroniczne wykonywanie zapytań

Queries.createquery i Queries.runquery metoda teraz pozwalają na asynchroniczne uruchamianie zapytań.

Więcej informacji znajdziesz w przypadku nowego parametru asynchronous w createquery i runquery.

Znane problemy

Brak.

14 stycznia 2020 r.

Nowe funkcje

v1.1

Czas rozpoczęcia harmonogramu zapytań

Metoda Queries.createquery umożliwia teraz określenie daty rozpoczęcia harmonogramów wykonywania zapytań.

Zobacz nowe pole schedule.startTimeMs za .

Znane problemy

Brak.

Styczeń 8, 2020

Nowe funkcje

v1.1

Przełączanie danych docelowych list odbiorców

Metoda Queries.createquery teraz pozwala określić, czy dane na liście odbiorców mają być ograniczone do zamówień reklamowych lub elementów zamówienia.

Więcej informacji znajdziesz w nowym polu params.options.includeOnlyTargetedUserLists.

Znane problemy

Brak.

19 listopada 2019 r.

Nowe funkcje

1.1

Filtr 1:1 do mapowania kolumn w raporcie

Filtry, które były mapowane na kilka kolumn raportu, są teraz mapowane na pojedyncze kolumny.

Na przykład w wersji 1. uwzględnienie filtra FILTER_ADVERTISER powoduje, że w raporcie oprócz kolumny „Identyfikator reklamodawcy” pojawia się też kolumna „Reklamodawca”. W wersji 1.1 wszystkie kolumny raportu mają własne filtry. Na przykład nowy filtr FILTER_ADVERTISER_NAME odpowiada na „Reklamodawca”. Aby w raportach wyświetlać kolumny „Identyfikator reklamodawcy” i „Reklamodawca”, w żądaniach Queries.createquery musisz uwzględnić filtry FILTER_ADVERTISER i FILTER_ADVERTISER_NAME.

Mówiąc dokładniej, żądanie createquery:

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

generuje plik raportu z tymi nagłówkami w wersji 1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

oraz te nagłówki w wersji 1.1:

Advertiser,Impressions

Kod v1 służący do uzyskiwania kolumn raportu:

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

należy zmodyfikować w sposób podobny do tego w wersji 1.1 (filtr notatek kolejność):

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

Podział na strony

Wersja 1.1 dodaje do metod podział na strony Queries.listqueries i Reports.listreports

W wersji 1.1 liczba wyników zwracanych przez te metody jest równa nowo dodanej wartości parametru pageSize (domyślnie jest to 100, jeśli nie zostanie określone inaczej). Odpowiedzi zawierają nowo dodaną nextPageToken pole, które może posłużyć do pobrania następnego zestawu wyników. To pole jest puste, jeśli nie ma już wyników.

Ten kod (wersja 1) służy do pobierania wszystkich raportów należących do określonego zapytania:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

Aby nadal pobierać wszystkie raporty, musisz zmodyfikować te parametry w wersji 1.1 w sposób podobny do tego:

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

Więcej informacji znajdziesz w dokumentacji metod Queries.listqueries i Reports.listreports.

Znane problemy

Brak.