Archivierte Versionshinweise

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

Rufen Sie die Hauptseite der Versionshinweise auf. Dort finden Sie alle Releases für Live-Versionen.

15. April 2021

Neue Funktionen

Veröffentlichung der Bid Manager API Version 1.1.

v1.1

Dienste für SDF und Werbebuchungen werden eingestellt

SDF und Werbebuchung Dienste werden eingestellt.

Nutzer, die strukturierte Daten herunterladen möchten oder Werbebuchungen verwalten, nutzen Sie stattdessen die Optionen Display- und Video 360 API

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

Neu hinzugefügt: Filters:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Neu hinzugefügt: 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

Bekannte Probleme

Keine.

20. März 2020

Neue Funktionen

v1.1

Asynchrone Abfrageausführung

Queries.createquery und Methode Queries.runquery jetzt verwenden die asynchrone Ausführung von Abfragen zulassen.

Neuen Parameter asynchronous ansehen in createquery und runquery.

Bekannte Probleme

Keine.

14. Januar 2020

Neue Funktionen

v1.1

Beginn des Abfragezeitplans

Methode Queries.createquery jetzt ermöglicht die Angabe des Datums, an dem die Ausführungszeitpläne für Abfragen beginnen.

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

Bekannte Probleme

Keine.

8. Januar 2020

Neue Funktionen

v1.1

Daten für Zielgruppenlisten mit Targeting ein-/ausblenden

Methode Queries.createquery jetzt können Sie festlegen, ob Zielgruppenlistendaten auf bestimmte Anzeigenaufträgen oder Werbebuchungen.

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.

Beispielsweise wird in Version 1 mit dem Filter FILTER_ADVERTISER ein Bericht generiert, mit den Spalten „Werbetreibender“ zusätzlich zu "Werbetreibenden-ID". In Version 1.1 wurden alle Berichtsspalten eigene Filter haben. Ein neuer Filter kann beispielsweise 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"],
  ...
}
...
}

erstellt eine Berichtsdatei mit den folgenden Überschriften in v1:

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 ist die Anzahl der Ergebnisse, die von diesen method ist gleich einem neu hinzugefügten Parameter pageSize (Standardeinstellung ist 100, falls nicht angegeben). Antworten enthalten einen neu hinzugefügten nextPageToken-Feld, das kann verwendet werden, um die nächste Ergebnismenge abzurufen. Dieses Feld ist leer, wenn Ergebnisse erschöpft 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();
  }
}

müssen in v1.1 ähnlich wie die folgenden geändert werden, damit mit dem Abrufen aller Berichte fortfahren:

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.