Obecnie przenosimy niektóre typy raportów z raportów offline na błyskawiczne. Gdy użytkownik zostanie przeniesiony, odpowiedzi queries.list będą zawierać istniejące raporty błyskawiczne. Więcej informacji znajdziesz na naszym blogu.

Ta strona została przetłumaczona przez Cloud Translation API.

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.