Notes de version archivées

Cette page fournit les notes de version relatives aux versions abandonnées 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 de fichiers de données structurées et d'éléments de campagne

SDF et élément de campagne sont arrêté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

Aucun

6 août 2020

Nouvelles fonctionnalités

v1.1

Chemin d'accès et Rapports sur l'attribution des chemins

TYPE_PATH et TYPE_PATH_ATTRIBUTION report types sont désormais en direct.

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

Aucun

20 mars 2020

Nouvelles fonctionnalités

v1.1

Exécution de requête asynchrone

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

Aucun

14 janvier 2020

Nouvelles fonctionnalités

v1.1

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

Méthode Queries.createquery permet 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

Aucun

8 janvier 2020

Nouvelles fonctionnalités

v1.1

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

Méthode Queries.createquery permet de spécifier si les données des listes d'audience doivent être limitées à des données d'ordres d'insertion ou d'éléments de campagne.

Voir le nouveau champ params.options.includeOnlyTargetedUserLists pour en savoir plus.

Problèmes connus

Aucun

19 novembre 2019

Nouvelles fonctionnalités

v1.1

Filtre individuel pour signaler le mappage des colonnes

Les filtres associés à plusieurs colonnes de rapport sont désormais mappés sur un seul colonnes.

Par exemple, dans la version 1, inclure le filtre FILTER_ADVERTISER génère un rapport avec les colonnes "Annonceur" en plus de la "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 correspond à "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 concrètement, 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 1.1:

Advertiser,Impressions

Le code v1 suivant est utilisé pour 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);

devront être modifiés comme dans la version 1.1 (filtre de note tri):

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 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 paramètre Champ nextPageToken qui permet de 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;
  }
}

Voir Queries.listqueries et Méthode Reports.listreports pour en savoir plus.

Problèmes connus

Aucun