Method: customers.generateIvtReport

Démarre l'exécution d'une requête pour récupérer un résumé quotidien du trafic incorrect pour une plate-forme spécifique. Les résultats seront écrits dans la table de destination BigQuery spécifiée. Le nom d'opération renvoyé peut être utilisé pour interroger l'état d'avancement de la requête.

Le tableau de sortie contient cinq lignes pour chaque jour de la plage de dates. Une ligne pour chacun des quatre types d'appareils et une ligne pour tous les types d'appareils. La ligne "Tous" correspond à la somme des quatre types d'appareils pour ce jour. Chaque colonne contient donc deux fois le total du nombre d'impressions. Si ADH masque les lignes en raison de contraintes de confidentialité, le résumé des lignes filtrées (la ligne sans jour) contient la somme des lignes masquées.

Requête HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Client Ads Data Hub effectuant la demande. sous la forme "&customer/[customerId]'. par exemple.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
Champs
adsDataCustomerId

string (int64 format)

Numéro client Ads Data Hub associé qui détient les données des annonces.
startDate

object (Date)

Premier jour du rapport généré.
endDate

object (Date)

Dernier jour du rapport généré, inclus.
timeZone

string

Facultatif. Fuseau horaire des dates de début et de fin du rapport. Si aucune valeur n'est spécifiée, la valeur par défaut est "UTC".
destTable

string

Table BigQuery de destination pour les résultats de la requête au format 'project.dataset.table_name'. Si le projet est spécifié, il doit être explicitement ajouté à la liste blanche pour le compte ADH du client. Si le projet n'est pas spécifié, utilise le projet par défaut pour le client fourni. Si aucun projet ni ensemble de données n'est spécifié, utilise le projet et l'ensemble de données par défaut.
Champ d'union platform_dimensions. Plate-forme pour laquelle vous pouvez générer des rapports, avec un segment facultatif spécifique à la plate-forme. Si vous ne sélectionnez pas de plate-forme, vous obtiendrez une erreur. platform_dimensions ne peut être qu'un des éléments suivants :
googleAdsDimensions

object (GoogleAdsDimensions)

Créer des rapports sur la plate-forme Google Ads
dv360YoutubeDimensions

object (Dv360Dimensions)

Générer des rapports sur la plate-forme DV360
ytReserveDimensions

object (YouTubeReserveDimensions)

Créer des rapports sur la plate-forme YTR

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adsdatahub

Dimensions Google Ads

Dimensions de filtrage pour la plate-forme Google Ads.

Représentation JSON 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Champs
campaignIds[]

string (int64 format)

ID de campagne Google Ads facultatifs. Si ce champ est vide, des rapports sont disponibles sur toutes les campagnes pour la période spécifiée.
metricType

enum (MetricType)

Désigne la plate-forme sur laquelle effectuer les mesures et les rapports.

MetricType

Désigne la plate-forme sur laquelle effectuer les mesures et les rapports.

Enums
METRIC_TYPE_UNSPECIFIED Type de métrique non spécifié.
METRIC_TYPE_IMPRESSION Données sur les impressions Google Ads.
METRIC_TYPE_YOUTUBE_VIEW Vues YouTube (ou TrueView).

Dimensions DV360

Dimensions de filtrage pour la plate-forme DV360.

Représentation JSON 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Champs
lineItemIds[]

string (int64 format)

ID d'éléments de campagne DV360 facultatifs. Si ce champ est vide, des rapports sont disponibles sur tous les éléments de campagne pour la période spécifiée.
metricType

enum (MetricType)

Désigne la plate-forme sur laquelle effectuer les mesures et les rapports.

YouTubeReserveDimensions

Dimensions de filtrage pour la plate-forme YouTube Reserve.

Représentation JSON 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
Champs
orderIds[]

string (int64 format)

ID de commande YouTube Reserve facultatifs. Si ce champ est vide, un rapport est généré pour toutes les campagnes pour la période spécifiée.
metricType

enum (MetricType)

Désigne la plate-forme sur laquelle effectuer les mesures et les rapports.