Method: accounts.reports.search

Récupère un rapport défini par une requête de recherche. La réponse peut contenir moins de lignes que spécifié par pageSize. Appuyez-vous sur nextPageToken pour déterminer si d'autres lignes peuvent être demandées.

Requête HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Identifiant du compte à l'origine de l'appel. Il doit s'agir d'un compte individuel ou d'un sous-compte MC. Format: accounts/{account}

Corps de la requête

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

Représentation JSON
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Champs
query

string

Obligatoire. Requête qui définit un rapport à récupérer.

Pour plus de détails sur la manière de construire votre requête, consultez le guide sur le langage de requête. Pour obtenir la liste complète des tables et des champs disponibles, consultez la section "Champs disponibles".

pageSize

integer

Facultatif. Nombre de ReportRows à récupérer sur une seule page. La valeur par défaut est 1 000. Les valeurs supérieures à 5 000 sont forcées à 5 000.

pageToken

string

Facultatif. Jeton de la page à récupérer. Si aucune valeur n'est spécifiée, la première page de résultats est renvoyée. Pour demander la page de résultats suivante, la valeur obtenue à partir de nextPageToken dans la réponse précédente doit être utilisée.

Corps de la réponse

Message de réponse pour la méthode ReportService.Search.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Champs
results[]

object (ReportRow)

Lignes correspondant à la requête de recherche.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si cette valeur est omise, il n'y a pas de pages suivantes.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ReportRow

Ligne de résultats renvoyée par la requête de recherche.

Seul le message correspondant à la table interrogée est renseigné dans la réponse. Dans le message renseigné, seuls les champs explicitement demandés dans la requête sont renseignés.

Représentation JSON
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Champs
productPerformanceView

object (ProductPerformanceView)

Champs disponibles pour la requête dans la table productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Champs disponibles pour la requête dans la table nonProductPerformanceView.

productView

object (ProductView)

Champs disponibles pour la requête dans la table productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Champs disponibles pour la requête dans la table priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Champs disponibles pour la requête dans la table priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Champs disponibles pour la requête dans la table bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Champs disponibles pour la requête dans la table bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Champs disponibles pour la requête dans la table competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Champs disponibles pour la requête dans la table competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Champs disponibles pour la requête dans la table competitiveVisibilityBenchmarkView.

ProductPerformanceView

Champs disponibles pour la requête dans la table productPerformanceView.

Données sur les performances des produits pour votre compte, y compris les métriques de performances (par exemple, clicks) et les dimensions en fonction desquelles les métriques de performances sont segmentées (par exemple, offerId). Les valeurs des dimensions du produit, telles que offerId, reflètent l'état d'un produit au moment de l'impression.

Vous ne pouvez pas sélectionner de champs de segment dans les requêtes sans sélectionner également au moins un champ de métrique.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Champs
date

object (Date)

Date dans le fuseau horaire du marchand à laquelle les métriques s'appliquent. Segmenter.

La condition sur date est obligatoire dans la clause WHERE.

week

object (Date)

Premier jour de la semaine (lundi) de la date des métriques dans le fuseau horaire du marchand. Segmenter.

conversionValue

object (Price)

Valeur des conversions attribuées au produit, enregistrée le jour de la conversion. Métrique.

Disponible uniquement pour la source de trafic FREE.

marketingMethod

enum (MarketingMethodEnum)

Méthode marketing à laquelle les métriques s'appliquent. Segmenter.

customerCountryCode

string

Code du pays où se trouve le client au moment de l'événement. La valeur est représentée au format ISO 3166. Segmenter.

Si le pays du client ne peut pas être déterminé, un "ZZ" spécial est renvoyé.

offerId

string

Identifiant du produit fourni par le marchand. Segmenter.

title

string

Titre du produit. Segmenter.

brand

string

Marque du produit. Segmenter.

categoryL1

string

Catégorie de produits (1er niveau) dans la classification des produits Google. Segmenter.

categoryL2

string

Catégorie de produits (2e niveau) dans la classification des produits Google. Segmenter.

categoryL3

string

Catégorie de produits (3e niveau) dans la classification des produits Google. Segmenter.

categoryL4

string

Catégorie de produits (4e niveau) dans la classification des produits Google. Segmenter.

categoryL5

string

Catégorie de produits (5e niveau) dans la classification des produits Google. Segmenter.

productTypeL1

string

Type de produit (1er niveau) dans la classification des produits du marchand Segmenter.

productTypeL2

string

Type de produit (2e niveau) dans la classification des produits du marchand Segmenter.

productTypeL3

string

Type de produit (3e niveau) dans la classification des produits du marchand Segmenter.

productTypeL4

string

Type de produit (4e niveau) dans la classification des produits du marchand Segmenter.

productTypeL5

string

Type de produit (5e niveau) dans la classification des produits du marchand Segmenter.

customLabel0

string

Étiquette personnalisée 0 pour un regroupement personnalisé de produits. Segmenter.

customLabel1

string

Étiquette personnalisée 1 pour un regroupement personnalisé de produits. Segmenter.

customLabel2

string

Étiquette personnalisée 2 pour un regroupement personnalisé de produits. Segmenter.

customLabel3

string

Étiquette personnalisée 3 pour un regroupement personnalisé de produits. Segmenter.

customLabel4

string

Étiquette personnalisée 4 pour un regroupement personnalisé de produits. Segmenter.

clicks

string (int64 format)

Nombre de clics. Métrique.

impressions

string (int64 format)

Nombre de fois où les produits du marchand sont affichés. Métrique.

clickThroughRate

number

Taux de clics : nombre de clics (clics) sur les produits du marchand divisé par le nombre d'affichages des produits (impressions). Métrique.

conversions

number

Nombre de conversions attribuées au produit, enregistrées le jour de la conversion. En fonction du modèle d'attribution, une conversion peut être répartie sur plusieurs clics, et chaque clic se voit attribuer un crédit spécifique. Cette métrique correspond à la somme de tous ces crédits. Métrique.

Disponible uniquement pour la source de trafic FREE.

conversionRate

number

Nombre de conversions divisé par le nombre de clics, enregistré à la date de l'impression. Métrique.

Disponible uniquement pour la source de trafic FREE.

MarketingMethodEnum

Valeurs de la méthode marketing.

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Non spécifié.
ORGANIC Marketing naturel.
ADS Marketing basé sur la publicité.

NonProductPerformanceView

Champs disponibles pour la requête dans la table nonProductPerformanceView.

Données sur les performances des images et des liens vers des boutiques en ligne redirigeant vers des pages qui ne présentent pas de produits. Cela inclut les métriques de performances (par exemple, clicks) et les dimensions en fonction desquelles les métriques de performances sont segmentées (par exemple, date).

Vous ne pouvez pas sélectionner de champs de segment dans les requêtes sans sélectionner également au moins un champ de métrique.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Champs
date

object (Date)

Date dans le fuseau horaire du marchand à laquelle les métriques s'appliquent. Segmenter.

La condition sur date est obligatoire dans la clause WHERE.

week

object (Date)

Premier jour de la semaine (lundi) de la date des métriques dans le fuseau horaire du marchand. Segmenter.

clicks

string (int64 format)

Nombre de clics sur des images et des liens vers des boutiques en ligne redirigeant vers des pages qui ne présentent pas de produits. Métrique.

impressions

string (int64 format)

Nombre de fois où des images et des liens vers des boutiques en ligne redirigeant vers des pages qui ne sont pas liées aux produits ont été affichés. Métrique.

clickThroughRate

number

Taux de clics : nombre de clics (clicks) divisé par le nombre d'impressions (impressions) d'images et de liens vers des boutiques en ligne redirigeant les utilisateurs vers des pages qui ne contiennent pas de produits. Métrique.

ProductView

Champs disponibles pour la requête dans la table productView.

Produits de l'inventaire actuel. Les produits de ce tableau sont identiques à ceux de la sous-API Products, mais tous les attributs de produit de la sous-API Products ne sont pas disponibles pour les requêtes dans ce tableau. Contrairement à la sous-API Products, ce tableau permet de filtrer la liste de produits renvoyée par attribut de produit. Pour récupérer un seul produit d'ici le id ou répertorier tous les produits, vous devez utiliser la sous-API Products.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Champs
price

object (Price)

Prix du produit. sont absents si les informations sur le prix du produit ne sont pas disponibles.

gtin[]

string

Liste des codes article internationaux (GTIN, Global Trade Item Number) du produit.

creationTime

string (Timestamp format)

Heure à laquelle le marchand a créé le produit en secondes.

expirationDate

object (Date)

Date d'expiration du produit, spécifiée lors de l'insertion.

itemIssues[]

object (ItemIssue)

Liste des problèmes liés aux articles du produit.

Ce champ ne peut pas être utilisé pour trier les résultats.

Seuls les attributs sélectionnés de ce champ (par exemple, itemIssues.severity.aggregated_severity) peuvent être utilisés pour filtrer les résultats.

clickPotential

enum (ClickPotential)

Estimation des performances potentielles par rapport aux produits les plus performants du marchand.

id

string

Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Les méthodes de l'API Merchant qui agissent sur les produits le prennent comme paramètre name.

Obligatoire dans la clause SELECT.

channel

enum (ChannelEnum)

Canal du produit. Il peut s'agir de ONLINE ou LOCAL.

languageCode

string

Code de langue du produit au format BCP 47.

feedLabel

string

Libellé du flux du produit.

offerId

string

Identifiant du produit fourni par le marchand.

title

string

Titre du produit.

brand

string

Marque du produit.

categoryL1

string

Catégorie de produits (1er niveau) dans la classification des produits Google.

categoryL2

string

Catégorie de produits (2e niveau) dans la classification des produits Google.

categoryL3

string

Catégorie de produits (3e niveau) dans la classification des produits Google.

categoryL4

string

Catégorie de produits (4e niveau) dans la classification des produits Google.

categoryL5

string

Catégorie de produits (5e niveau) dans la classification des produits Google.

productTypeL1

string

Type de produit (1er niveau) dans la classification des produits du marchand.

productTypeL2

string

Type de produit (2e niveau) dans la classification des produits du marchand.

productTypeL3

string

Type de produit (3e niveau) dans la classification des produits du marchand.

productTypeL4

string

Type de produit (4e niveau) dans la classification des produits du marchand.

productTypeL5

string

Type de produit (5e niveau) dans la classification des produits du marchand.

condition

string

État du produit.

availability

string

La disponibilité du produit.

shippingLabel

string

Étiquette de livraison normalisée spécifiée dans la source de données.

itemGroupId

string

Identifiant de groupe d'articles fourni par le marchand pour regrouper les variantes.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

État agrégé.

clickPotentialRank

string (int64 format)

Classement du produit en fonction de son potentiel de clics. Un produit avec une valeur de clickPotentialRank 1 présente le potentiel de clics le plus élevé parmi les produits du marchand qui remplissent les conditions de la requête de recherche.

AggregatedReportingContextStatus

État du produit agrégé pour tous les contextes de création de rapports.

Voici un exemple de calcul de l'état agrégé:

Fiches gratuites Annonces Shopping État
Approuvé Approuvé ELIGIBLE
Approuvé En attente ELIGIBLE
Approuvé Refusé ELIGIBLE_LIMITED
En attente En attente EN ATTENTE
Refusé Refusé NOT_ELIGIBLE_OR_DISAPPROVED
Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Non spécifié.
NOT_ELIGIBLE_OR_DISAPPROVED Le produit n'est pas éligible ou a été refusé pour tous les contextes de création de rapports.
PENDING L'état du produit est en attente dans tous les contextes de reporting.
ELIGIBLE_LIMITED Le produit est éligible pour certains contextes de création de rapports (mais pas tous).
ELIGIBLE Le produit est éligible pour tous les contextes de création de rapports.

ItemIssue

Problème lié à l'article associé au produit.

Représentation JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Champs
type

object (ItemIssueType)

Type de problème lié à l'article.

severity

object (ItemIssueSeverity)

Niveau de gravité du problème lié aux articles.

resolution

enum (ItemIssueResolution)

Résolution du problème lié aux articles.

ItemIssueType

Type de problème

Représentation JSON
{
  "code": string,
  "canonicalAttribute": string
}
Champs
code

string

Code d'erreur du problème, équivalent au code de Problèmes liés aux produits.

canonicalAttribute

string

Nom d'attribut canonique pour les problèmes spécifiques aux attributs.

ItemIssueSeverity

l'impact du problème sur la diffusion du produit ;

Représentation JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Champs
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Niveau de gravité du problème en fonction du contexte de reporting.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Gravité agrégée du problème pour tous les contextes des rapports concernés.

Ce champ peut être utilisé pour filtrer les résultats.

IssueSeverityPerReportingContext

Niveau de gravité du problème en fonction du contexte de reporting.

Représentation JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Champs
disapprovedCountries[]

string

Liste des pays refusés dans le contexte du reporting, au format ISO 3166.

demotedCountries[]

string

Liste des pays rétrogradés dans le contexte de reporting, au format ISO 3166.

reportingContext

enum (ReportingContextEnum)

Contexte de reporting auquel le problème s'applique.

AggregatedIssueSeverity

Niveau de gravité du problème agrégé pour tous les contextes de reporting.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Non spécifié.
DISAPPROVED Le problème entraîne le refus du produit dans au moins un contexte de reporting.
DEMOTED Le problème rétrograde le produit dans tous les contextes de reporting qu'il concerne.
PENDING Résolution du problème : PENDING_PROCESSING.

ItemIssueResolution

Comment résoudre le problème ?

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Non spécifié.
MERCHANT_ACTION Le marchand doit résoudre le problème.
PENDING_PROCESSING Le problème sera résolu automatiquement (exploration des images, par exemple) ou via un examen Google. Aucune action n'est requise de la part du marchand pour le moment. La résolution peut entraîner un autre problème (par exemple, en cas d'échec de l'exploration).

ClickPotential

Le potentiel de clics d'un produit est une estimation de ses performances potentielles par rapport aux produits les plus performants du marchand. Le potentiel de clics d'un produit aide les marchands à hiérarchiser les produits à corriger et à comprendre leurs performances comparées à leur potentiel.

Enums
CLICK_POTENTIAL_UNSPECIFIED Impact sur les clics prévu inconnu.
LOW Potentiel de recevoir un faible nombre de clics par rapport aux produits les plus performants du marchand.
MEDIUM Potentiel de recevoir un nombre modéré de clics par rapport aux produits les plus performants du marchand.
HIGH Potentiel de recevoir un nombre similaire de clics par rapport aux produits les plus performants du marchand.

PriceCompetitivenessProductView

Champs disponibles pour la requête dans la table priceCompetitivenessProductView.

dans le rapport Compétitivité tarifaire.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Champs
price

object (Price)

Prix actuel du produit.

benchmarkPrice

object (Price)

Dernier benchmark de prix disponible pour le catalogue du produit dans le pays de référence.

reportCountryCode

string

Pays du benchmark de prix. La valeur est représentée au format ISO 3166.

Obligatoire dans la clause SELECT.

id

string

Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Permet de joindre des données à la table productView.

Obligatoire dans la clause SELECT.

offerId

string

Identifiant du produit fourni par le marchand.

title

string

Titre du produit.

brand

string

Marque du produit.

categoryL1

string

Catégorie de produits (1er niveau) dans la classification des produits Google.

categoryL2

string

Catégorie de produits (2e niveau) dans la classification des produits Google.

categoryL3

string

Catégorie de produits (3e niveau) dans la classification des produits Google.

categoryL4

string

Catégorie de produits (4e niveau) dans la classification des produits Google.

categoryL5

string

Catégorie de produits (5e niveau) dans la classification des produits Google.

productTypeL1

string

Type de produit (1er niveau) dans la classification des produits du marchand.

productTypeL2

string

Type de produit (2e niveau) dans la classification des produits du marchand.

productTypeL3

string

Type de produit (3e niveau) dans la classification des produits du marchand.

productTypeL4

string

Type de produit (4e niveau) dans la classification des produits du marchand.

productTypeL5

string

Type de produit (5e niveau) dans la classification des produits du marchand.

PriceInsightsProductView

Champs disponibles pour la requête dans la table priceInsightsProductView.

Le rapport Tendances des prix.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Champs
price

object (Price)

Prix actuel du produit.

suggestedPrice

object (Price)

Dernier prix suggéré du produit.

effectiveness

enum (Effectiveness)

Efficacité prévue de l'application de la suggestion de prix, regroupées dans des ensembles.

id

string

Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Permet de joindre des données à la table productView.

Obligatoire dans la clause SELECT.

offerId

string

Identifiant du produit fourni par le marchand.

title

string

Titre du produit.

brand

string

Marque du produit.

categoryL1

string

Catégorie de produits (1er niveau) dans la classification des produits Google.

categoryL2

string

Catégorie de produits (2e niveau) dans la classification des produits Google.

categoryL3

string

Catégorie de produits (3e niveau) dans la classification des produits Google.

categoryL4

string

Catégorie de produits (4e niveau) dans la classification des produits Google.

categoryL5

string

Catégorie de produits (5e niveau) dans la classification des produits Google.

productTypeL1

string

Type de produit (1er niveau) dans la classification des produits du marchand.

productTypeL2

string

Type de produit (2e niveau) dans la classification des produits du marchand.

productTypeL3

string

Type de produit (3e niveau) dans la classification des produits du marchand.

productTypeL4

string

Type de produit (4e niveau) dans la classification des produits du marchand.

productTypeL5

string

Type de produit (5e niveau) dans la classification des produits du marchand.

predictedImpressionsChangeFraction

number

Variation prévue du nombre d'impressions sous forme de fraction après l'introduction du prix suggéré par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre d'impressions de 5 %.

predictedClicksChangeFraction

number

Estimation de la variation du nombre de clics sous forme de fraction après l'introduction du prix suggéré par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre de clics de 5 %.

predictedConversionsChangeFraction

number

Estimation de la variation du nombre de conversions après l'introduction du prix suggéré par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre de conversions de 5 %.

Efficacité

Ensemble de données d'efficacité prédite.

L'efficacité indique quels produits bénéficieraient le plus d'un changement de prix. Cette note tient compte de l'amélioration des performances prévue en ajustant le prix soldé, ainsi que de la différence entre votre prix actuel et le prix suggéré. Les suggestions de prix avec une efficacité de HIGH sont susceptibles d'entraîner la plus forte amélioration des performances.

Enums
EFFECTIVENESS_UNSPECIFIED L'efficacité est inconnue.
LOW L'efficacité est faible.
MEDIUM L’efficacité est moyenne.
HIGH L'efficacité est élevée.

BestSellersProductClusterView

Champs disponibles pour la requête dans la table bestSellersProductClusterView.

Le rapport Meilleures ventes avec les clusters de produits les plus populaires. Un cluster de produits est un groupe de différentes offres et variantes représentant le même produit (par exemple, le Google Pixel 7).

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Champs
reportDate

object (Date)

Date du rapport. La valeur de ce champ ne peut être que l'une des suivantes:

  • Premier jour de la semaine (lundi) pour les rapports hebdomadaires
  • Premier jour du mois pour les rapports mensuels.

Obligatoire dans la clause SELECT. Si une condition WHERE sur reportDate n'est pas spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.

variantGtins[]

string

Codes GTIN des exemples de variantes du groupe de produits.

reportGranularity

enum (ReportGranularityEnum)

Précision du rapport. Le classement peut s'effectuer sur une période d'une semaine ou d'un mois.

Obligatoire dans la clause SELECT. La condition sur reportGranularity est obligatoire dans la clause WHERE.

reportCountryCode

string

Pays dans lequel le classement est calculé. La valeur est représentée au format ISO 3166.

Obligatoire dans la clause SELECT. La condition sur reportCountryCode est obligatoire dans la clause WHERE.

reportCategoryId

string (int64 format)

ID de catégorie de produits Google pour lequel calculer le classement, représenté dans la classification des produits Google.

Obligatoire dans la clause SELECT. Si aucune condition WHERE sur reportCategoryId n'est spécifiée dans la requête, les classements de toutes les catégories de niveau supérieur sont renvoyés.

title

string

Titre du cluster de produits.

brand

string

Marque du cluster de produits.

categoryL1

string

Catégorie de produit (1er niveau) du cluster de produits, représentée dans la classification des produits Google.

categoryL2

string

Catégorie de produit (2e niveau) du cluster de produits, représentée dans la classification des produits Google.

categoryL3

string

Catégorie de produit (3e niveau) du cluster de produits, représentée dans la classification des produits Google.

categoryL4

string

Catégorie de produit (4e niveau) du cluster de produits, représentée dans la classification des produits Google.

categoryL5

string

Catégorie de produit (5e niveau) du cluster de produits, représentée dans la classification des produits Google.

inventoryStatus

enum (InventoryStatus)

Indique si le cluster de produits est IN_STOCK dans votre source de données produit dans au moins un des pays, OUT_OF_STOCK dans votre source de données produit pour tous les pays ou NOT_IN_INVENTORY du tout.

Le champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".

brandInventoryStatus

enum (InventoryStatus)

Qu'il y ait actuellement au moins un produit de la marque IN_STOCK dans votre source de données produit dans au moins un des pays, tous les produits sont OUT_OF_STOCK dans votre source de données produit pour tous les pays, ou NOT_IN_INVENTORY.

Le champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".

rank

string (int64 format)

Popularité du cluster de produits dans Ads et sur les surfaces naturelles, dans la catégorie et le pays sélectionnés, en fonction de l'estimation du nombre d'unités vendues.

previousRank

string (int64 format)

Classement par popularité au cours de la semaine ou du mois précédents.

relativeDemand

enum (RelativeDemandEnum)

Demande estimée par rapport au cluster de produits le plus populaire dans la même catégorie et le même pays.

previousRelativeDemand

enum (RelativeDemandEnum)

Demande estimée par rapport au cluster de produits le plus populaire dans la même catégorie et le même pays au cours de la semaine ou du mois précédents.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Variation de la demande estimée. Qu'il s'agisse de monter, de couler ou de rester plats.

ReportGranularityEnum

Valeurs de précision des rapports.

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED Non spécifié.
WEEKLY Le rapport est calculé sur une période d'une semaine.
MONTHLY Le rapport est calculé sur une période d'un mois.

InventoryStatus

État du cluster de produits ou de la marque dans votre inventaire.

Enums
INVENTORY_STATUS_UNSPECIFIED Non spécifié.
IN_STOCK Un produit de ce cluster de produits ou de cette marque est en stock.
OUT_OF_STOCK Un produit de ce groupe de produits ou de cette marque est disponible dans l'inventaire, mais il n'est pas disponible actuellement.
NOT_IN_INVENTORY L'inventaire ne contient aucun produit pour ce cluster de produits ou cette marque.

RelativeDemandEnum

Valeurs de demande relative.

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED Non spécifié.
VERY_LOW La demande représente 0 à 5% de celle pour le groupe de produits ou la marque le plus populaire.
LOW La demande représente 6 à 10% de la demande pour le groupe de produits ou la marque les mieux classés.
MEDIUM La demande représente 11 à 20% de la demande pour le groupe de produits ou la marque les mieux classés.
HIGH La demande représente 21 à 50% de la demande pour le groupe de produits ou la marque les mieux classés.
VERY_HIGH La demande représente 51 à 100% de la demande pour le groupe de produits ou la marque les mieux classés.

RelativeDemandChangeTypeEnum

Valeurs du type de variation de la demande relative.

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Non spécifié.
SINKER La demande relative est inférieure à celle de la période précédente.
FLAT La demande relative est égale à la période précédente.
RISER La demande relative est plus élevée que lors de la période précédente.

BestSellersBrandView

Champs disponibles pour la requête dans la table bestSellersBrandView.

Rapport Meilleures ventes avec des marques populaires.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Champs
reportDate

object (Date)

Date du rapport. La valeur de ce champ ne peut être que l'une des suivantes:

  • Premier jour de la semaine (lundi) pour les rapports hebdomadaires
  • Premier jour du mois pour les rapports mensuels.

Obligatoire dans la clause SELECT. Si une condition WHERE sur reportDate n'est pas spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.

reportGranularity

enum (ReportGranularityEnum)

Précision du rapport. Le classement peut s'effectuer sur une période d'une semaine ou d'un mois.

Obligatoire dans la clause SELECT. La condition sur reportGranularity est obligatoire dans la clause WHERE.

reportCountryCode

string

Pays dans lequel le classement est calculé. La valeur est représentée au format ISO 3166.

Obligatoire dans la clause SELECT. La condition sur reportCountryCode est obligatoire dans la clause WHERE.

reportCategoryId

string (int64 format)

ID de catégorie de produits Google pour lequel calculer le classement, représenté dans la classification des produits Google.

Obligatoire dans la clause SELECT. Si aucune condition WHERE sur reportCategoryId n'est spécifiée dans la requête, les classements de toutes les catégories de niveau supérieur sont renvoyés.

brand

string

Nom de la marque.

rank

string (int64 format)

Popularité de la marque dans Ads et sur les surfaces naturelles, dans la catégorie et le pays sélectionnés, en fonction de l'estimation du nombre d'unités vendues.

previousRank

string (int64 format)

Classement par popularité au cours de la semaine ou du mois précédents.

relativeDemand

enum (RelativeDemandEnum)

Demande estimée par rapport à la marque la plus populaire dans la même catégorie et le même pays.

previousRelativeDemand

enum (RelativeDemandEnum)

Demande estimée par rapport à la marque la plus populaire dans la même catégorie et le même pays au cours de la semaine ou du mois précédents.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Variation de la demande estimée. Qu'il s'agisse de monter, de couler ou de rester plats.

CompetitiveVisibilityCompetitorView

Champs disponibles pour la requête dans la table competitiveVisibilityCompetitorView.

Visibilité par rapport aux concurrents avec les entreprises ayant une visibilité similaire.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Champs
date

object (Date)

Date de cette ligne.

Une condition sur date est obligatoire dans la clause WHERE.

domain

string

Domaine de votre concurrent ou de votre domaine, si "isYourDomain" vrai.

Obligatoire dans la clause SELECT. Ne peut pas être filtré dans "WHERE" .

isYourDomain

boolean

"True" si cette ligne contient des données pour votre domaine.

Ne peut pas être filtré dans "WHERE" .

reportCountryCode

string

Pays dans lequel les impressions ont été générées.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est obligatoire dans la clause WHERE.

reportCategoryId

string (int64 format)

ID de la catégorie de produits Google pour laquelle calculer le rapport, représenté dans la classification des produits Google.

Obligatoire dans la clause SELECT. Une condition sur reportCategoryId est obligatoire dans la clause WHERE.

trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.

rank

string (int64 format)

Position du domaine dans le classement des entreprises similaires pour les clés sélectionnées (date, reportCategoryId, reportCountryCode, trafficSource) en fonction du nombre d'impressions. 1 correspond à la valeur la plus élevée.

Ne peut pas être filtré dans "WHERE" .

adsOrganicRatio

number

Le Ratio annonces / résultats naturels indique la fréquence à laquelle le domaine enregistre des impressions provenant d'annonces Shopping par rapport au trafic généré par les résultats naturels. Le nombre est arrondi et segmenté.

Ne peut pas être filtré dans "WHERE" .

pageOverlapRate

number

Le taux de superposition de la page indique la fréquence à laquelle les offres de marchands concurrents sont diffusées avec vos offres sur la même page.

Ne peut pas être filtré dans "WHERE" .

higherPositionRate

number

Le taux de position plus élevée indique la fréquence à laquelle l'offre d'un concurrent a été positionnée à une position supérieure à la vôtre sur la page.

Ne peut pas être filtré dans "WHERE" .

relativeVisibility

number

La visibilité relative indique la fréquence à laquelle les offres de vos concurrents sont diffusées par rapport aux vôtres. En d'autres termes, il s'agit du nombre d'impressions enregistrées d'un marchand concurrent divisé par le nombre d'impressions enregistrées pendant une période donnée, pour une catégorie de produits et un pays donnés.

Ne peut pas être filtré dans "WHERE" .

TrafficSourceEnum

Valeurs des sources de trafic.

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Non spécifié.
ORGANIC Trafic généré par les résultats naturels.
ADS Trafic généré par les annonces.
ALL Trafic généré par les résultats naturels et publicitaire.

CompetitiveVisibilityTopMerchantView

Champs disponibles pour la requête dans la table competitiveVisibilityTopMerchantView.

Rapport Visibilité par rapport aux concurrents avec l'entreprise la plus visible.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Champs
date

object (Date)

Date de cette ligne.

Cette option ne peut pas être sélectionnée dans la clause SELECT. Une condition sur date est obligatoire dans la clause WHERE.

domain

string

Domaine de votre concurrent ou de votre domaine, si "isYourDomain" vrai.

Obligatoire dans la clause SELECT. Ne peut pas être filtré dans "WHERE" .

isYourDomain

boolean

"True" si cette ligne contient des données pour votre domaine.

Ne peut pas être filtré dans "WHERE" .

reportCountryCode

string

Pays dans lequel les impressions ont été générées.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est obligatoire dans la clause WHERE.

reportCategoryId

string (int64 format)

ID de la catégorie de produits Google pour laquelle calculer le rapport, représenté dans la classification des produits Google.

Obligatoire dans la clause SELECT. Une condition sur reportCategoryId est obligatoire dans la clause WHERE.

trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.

rank

string (int64 format)

Position du domaine dans le classement des meilleurs marchands pour les clés sélectionnées (date, reportCategoryId, reportCountryCode, trafficSource) en fonction du nombre d'impressions. 1 correspond à la valeur la plus élevée.

Ne peut pas être filtré dans "WHERE" .

adsOrganicRatio

number

Le Ratio annonces / résultats naturels indique la fréquence à laquelle le domaine enregistre des impressions provenant d'annonces Shopping par rapport au trafic généré par les résultats naturels. Le nombre est arrondi et segmenté.

Ne peut pas être filtré dans "WHERE" .

pageOverlapRate

number

Le taux de superposition de la page indique la fréquence à laquelle les offres de marchands concurrents sont diffusées avec vos offres sur la même page.

Ne peut pas être filtré dans "WHERE" .

higherPositionRate

number

Le taux de position plus élevée indique la fréquence à laquelle l'offre d'un concurrent a été positionnée à une position supérieure à la vôtre sur la page.

Ne peut pas être filtré dans "WHERE" .

CompetitiveVisibilityBenchmarkView

Champs disponibles pour la requête dans la table competitiveVisibilityBenchmarkView.

Visibilité par rapport aux concurrents avec le benchmark par catégorie.

Les valeurs ne sont définies que pour les champs explicitement demandés dans la requête de recherche.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Champs
date

object (Date)

Date de cette ligne.

Obligatoire dans la clause SELECT. Une condition sur date est obligatoire dans la clause WHERE.

reportCountryCode

string

Pays dans lequel les impressions ont été générées.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est obligatoire dans la clause WHERE.

reportCategoryId

string (int64 format)

ID de la catégorie de produits Google pour laquelle calculer le rapport, représenté dans la classification des produits Google.

Obligatoire dans la clause SELECT. Une condition sur reportCategoryId est obligatoire dans la clause WHERE.

trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.

yourDomainVisibilityTrend

number

Modification de la visibilité en fonction des impressions enregistrées sur votre domaine par rapport au début de la période sélectionnée (ou du premier jour où le nombre d'impressions est supérieur à zéro).

Ne peut pas être filtré dans "WHERE" .

categoryBenchmarkVisibilityTrend

number

Variation de la visibilité en fonction des impressions par rapport au début de la période sélectionnée (ou au premier jour avec une impression non nulle) pour un ensemble combiné de marchands dont la visibilité est la plus élevée à peu près au niveau du marché.

Ne peut pas être filtré dans "WHERE" .