Archivierte Versionshinweise

Diese Seite enthält Versionshinweise für eingestellte Versionen der Bid Manager API.

Auf der Hauptseite mit den Versionshinweisen finden Sie alle Releases für Liveversionen.

15. April 2021

Neue Funktionen

Die Bid Manager API v1.1 wurde veröffentlicht.

v1.1

Dienste für SDF und Werbebuchungen werden eingestellt

SDF und Werbebuchung Dienste werden eingestellt.

Nutzer, die strukturierte Datendateien herunterladen oder Werbebuchungen verwalten möchten, müssen stattdessen die Display & Video 360 API verwenden.

Bekannte Probleme

Keine.

6. August 2020

Neue Funktionen

v1.1

Pfad und Berichte zur Pfadattribution

TYPE_PATH und TYPE_PATH_ATTRIBUTION report types sind jetzt live.

Dazu gehört das neue Feld params.options.pathQueryOptions (enthält die Felder pathFilters und channelGrouping) query und report Ressourcen

Neue Filters hinzugefügt:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Neue Metrics hinzugefügt:

  • 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

Bekannte Probleme

Keine.

20. März 2020

Neue Funktionen

v1.1

Asynchrone Abfrageausführung

Mit den Methoden Queries.createquery und Queries.runquery können Abfragen jetzt asynchron ausgeführt werden.

Weitere Informationen finden Sie im neuen Parameter asynchronous unter createquery und runquery.

Bekannte Probleme

Keine.

14. Januar 2020

Neue Funktionen

v1.1

Startzeit des Abfragezeitplans

Mit der Methode Queries.createquery können Sie jetzt das Datum angeben, an dem die Zeitpläne für die Abfrageausführung beginnen.

Neues Feld ansehen schedule.startTimeMs für erhalten Sie weitere Informationen.

Bekannte Probleme

Keine.

8. Januar 2020

Neue Funktionen

v1.1

Daten zu Zielgruppenlisten mit Targeting ein- und ausblenden

Mit der Methode Queries.createquery können Sie jetzt angeben, ob Daten aus Zielgruppenlisten auf bestimmte Anzeigenaufträge oder Werbebuchungen beschränkt werden sollen.

Neues Feld ansehen params.options.includeOnlyTargetedUserLists .

Bekannte Probleme

Keine.

19. November 2019

Neue Funktionen

v1.1

1:1-Filter und Berichtspaltenzuordnung

Filter, die mehreren Berichtsspalten zugeordnet sind, Spalten.

Wenn Sie in Version 1 beispielsweise den Filter FILTER_ADVERTISER hinzufügen, enthält der Bericht neben der Spalte „Werbetreibenden-ID“ auch die Spalte „Werbetreibender“. In Version 1.1 wurden alle Berichtsspalten eigene Filter haben. Beispiel: Ein neuer Filter FILTER_ADVERTISER_NAME wird „Werbetreibender“ zugeordnet. Um sowohl "Werbetreibender ID“ und "Werbetreibender" in Berichten enthalten die Filter FILTER_ADVERTISER und FILTER_ADVERTISER_NAME muss bzw. müssen in Queries.createquery -Anfragen.

Konkret bedeutet die createquery-Anfrage:

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

generiert in Version 1 eine Berichtsdatei mit den folgenden Überschriften:

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

und die folgenden Header in Version 1.1:

Advertiser,Impressions

Mit dem folgenden V1-Code wurden die Berichtsspalten abgerufen:

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

müssen in v1.1 in etwa so geändert werden (Hinweisfilter Reihenfolge):

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);
Ursprünglicher Filter Hinzugefügte Filter
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
Seitenumbruch

v1.1 fügt Methoden zur Paginierung hinzu Queries.listqueries und Reports.listreports

In Version 1.1 entspricht die Anzahl der mit diesen Methoden zurückgegebenen Ergebnisse einem neu hinzugefügten Parameter pageSize. Wenn dieser nicht angegeben wird, ist der Standardwert 100. Antworten enthalten ein neu hinzugefügtes Feld nextPageToken, mit dem die nächsten Ergebnisse abgerufen werden können. Dieses Feld ist leer, wenn keine Ergebnisse mehr vorhanden sind.

Mit dem folgenden V1-Code können Sie alle Berichte abrufen, die zu einer bestimmten Abfrage gehören:

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

    return reportListResponse.getReports();
  }
}

muss in Version 1.1 ähnlich wie unten dargestellt geändert werden, damit weiterhin alle Berichte abgerufen werden können:

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

Weitere Informationen finden Sie unter Queries.listqueries und Methode Reports.listreports in der Dokumentation.

Bekannte Probleme

Keine.