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);
Pierwotny filtr Dodane filtry
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
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.