Notes de version archivées

Cette page fournit les notes de version des versions obsolètes de l'API Bid Manager.

Accédez à la page principale des notes de version pour voir toutes les versions afin de en ligne.

15 avril 2021

Nouvelles fonctionnalités

Lancement de la version 1.1 de l'API Bid Manager.

v1.1

Arrêt des services SDF et d'éléments de campagne

Les services SDF et Élément de campagne sont désormais abandonnés.

Utilisateurs qui souhaitent télécharger des données structurées les fichiers ou les éléments de campagne de gestion doivent utilisez plutôt les boutons Affichage et l'API Video 360.

Problèmes connus

Aucune.

6 août 2020

Nouvelles fonctionnalités

v1.1

Rapports sur les chemins et l'attribution des chemins

TYPE_PATH et TYPE_PATH_ATTRIBUTION report types sont désormais disponibles.

Cela inclut l'ajout du nouveau champ params.options.pathQueryOptions (qui contient les champs pathFilters et channelGrouping) sur query et report ressources.

Nouvel Filters ajouté:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Nouvel Metrics ajouté:

  • 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

Problèmes connus

Aucune.

20 mars 2020

Nouvelles fonctionnalités

v1.1

Exécution de requêtes asynchrones

Queries.createquery et Méthode Queries.runquery à présent permettent d'exécuter des requêtes de manière asynchrone.

Voir le nouveau paramètre asynchronous dans createquery et runquery pour en savoir plus.

Problèmes connus

Aucune.

14 janvier 2020

Nouvelles fonctionnalités

v1.1

Heure de début de la planification de la requête

La méthode Queries.createquery permet désormais de spécifier la date à laquelle les planifications d'exécution des requêtes commencent.

Voir le nouveau champ schedule.startTimeMs pour plus de détails.

Problèmes connus

Aucune.

8 janvier 2020

Nouvelles fonctionnalités

v1.1

Activer/Désactiver les données des listes d'audience ciblées

La méthode Queries.createquery permet désormais de spécifier si les données de la liste d'audience doivent être limitées à des ordres d'insertion ou des éléments de campagne spécifiques.

Pour en savoir plus, consultez le nouveau champ params.options.includeOnlyTargetedUserLists.

Problèmes connus

Aucune.

19 novembre 2019

Nouvelles fonctionnalités

v1.1

Filtre individuel pour le mappage des colonnes de rapport

Les filtres associés à plusieurs colonnes de rapport ne renvoient désormais qu'à un seul colonnes.

Par exemple, dans la version 1, l'inclusion du filtre FILTER_ADVERTISER génère un rapport avec les colonnes "Annonceur" en plus de "Référence annonceur". Dans la version 1.1, les colonnes d'un rapport disposent de leurs propres filtres. Par exemple, un nouveau filtre FILTER_ADVERTISER_NAME est mappé sur "Annonceur". Pour obtenir à la fois ID" et "Annonceur" colonnes dans les rapports, les filtres FILTER_ADVERTISER et FILTER_ADVERTISER_NAME, respectivement, devront être inclus dans Queries.createquery requêtes.

Plus précisément, la requête createquery :

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

génère un fichier de rapport contenant les en-têtes suivants dans la version 1:

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

et les en-têtes suivants dans la version v1.1 :

Advertiser,Impressions

Le code v1 suivant permettait d'obtenir les colonnes du rapport :

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

doit être modifié comme suit dans la version 1.1 (ordre de tri du filtre de notes) :

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);
Filtre d'origine Filtres ajoutés
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
Pagination

La version 1.1 ajoute une pagination aux méthodes Queries.listqueries et Reports.listreports

Dans la version 1.1, le nombre de résultats renvoyés par méthodes est égal à un nouveau paramètre pageSize (la valeur par défaut est 100 s'il n'est pas spécifié). Les réponses contiennent un champ nextPageToken nouvellement ajouté qui peut être utilisé pour récupérer l'ensemble de résultats suivant. Ce champ est vide si des résultats sont épuisés.

Le code v1 suivant permet de récupérer tous les rapports appartenant à une requête spécifique:

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

    return reportListResponse.getReports();
  }
}

devront être modifiés de la même manière que dans la version 1.1, afin de poursuivre la récupération de tous les rapports:

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

Pour en savoir plus, consultez la documentation des méthodes Queries.listqueries et Reports.listreports.

Problèmes connus

Aucune.