Informacje o zarchiwizowanej wersji

Na tej stronie znajdziesz informacje o wycofanych wersjach interfejsu API usługi Bid Manager.

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

15 kwietnia 2021 r.

Nowe funkcje

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

v1.1

Wycofanie usług SDF i elementów zamówienia

SDF i element zamówienia wycofujemy usługi.

Użytkownicy, którzy chcą pobrać uporządkowane dane Pliki lub zarządzanie elementami zamówienia muszą zamiast tego użyj funkcji Display & Video 360 API.

Znane problemy

Brak.

6 sierpnia 2020 r.

Nowe funkcje

v1.1

Ścieżki Raporty atrybucji ścieżki

TYPE_PATH i TYPE_PATH_ATTRIBUTION report types są już na żywo.

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

Dodano nowe urządzenie Filters:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Dodano nowe urządzenie 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

v1.1

Asynchroniczne uruchomienie zapytania

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

Zobacz nowy parametr asynchronous w: createquery i runquery, aby uzyskać więcej informacji.

Znane problemy

Brak.

14 stycznia 2020 r.

Nowe funkcje

v1.1

Czas rozpoczęcia harmonogramu zapytania

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

Zobacz nowe pole schedule.startTimeMs za .

Znane problemy

Brak.

Styczeń 8, 2020

Nowe funkcje

v1.1

Przełącz dane dotyczące list odbiorców docelowych

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.

Zobacz nowe pole params.options.includeOnlyTargetedUserLists .

Znane problemy

Brak.

19 listopada 2019 r.

Nowe funkcje

v1.1

Mapowanie kolumn w raporcie 1:1

Filtry zmapowane na wiele kolumn raportu są teraz mapowane na pojedyncze kolumny.

Na przykład w wersji 1 zastosowanie filtra FILTER_ADVERTISER powoduje wygenerowanie raportu z kolumnami „Reklamodawca” oprócz pola „Advertiser ID” (Identyfikator reklamodawcy). W wersji 1.1 wszystkie kolumny raportu mają własne filtry. Na przykład nowy filtr FILTER_ADVERTISER_NAME odpowiada terminowi „Advertiser” (Reklamodawca). Aby wyświetlić zarówno kolumnę „Reklamodawca”, ID” i „Reklamodawca” kolumn w raportach, oba filtry FILTER_ADVERTISER i FILTER_ADVERTISER_NAME należy umieścić odpowiednio Queries.createquery. żądań.

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

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

spowoduje wygenerowanie pliku raportu z następującymi nagłówkami w wersji 1:

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

oraz następujące nagłówki w wersji 1.1:

Advertiser,Impressions

Ten kod w wersji 1 używany do pobierania 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 podobny sposób 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 zwróconych przez te metody są równe nowo dodanemu parametrowi pageSize (domyślnie jest to 100, jeśli nie podano żadnej wartości). 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 wyniki zostały wyczerpane.

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

musi zostać zmodyfikowana w sposób podobny do opisanego poniżej w wersji 1.1, kontynuuj pobieranie wszystkich raportów:

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

Zobacz Queries.listqueries i Metoda Reports.listreports dokumentację.

Znane problemy

Brak.