L'ancienne API Search Ads 360 Reporting va disparaître et sera mise hors service le 30 juin 2024. Notez que l'API Search Ads 360 Conversion n'est pas affectée et continuera d'être disponible. Tout nouveau développement de rapports doit utiliser la nouvelle API Search Ads 360 Reporting.

À partir d'avril 2024, une erreur "supportedApiVersion" s'affichera lorsque vous demanderez un rapport. En savoir plus

Par ailleurs, nous vous recommandons vivement de migrer toutes les implémentations Search Ads 360 existantes vers la nouvelle API. Pour en savoir plus, consultez le guide de démarrage et le guide de migration de la nouvelle API Search Ads 360 Reporting.

Cette page a été traduite par l'API Cloud Translation.

Type de rapport: productLeadAndCrossSell

Métriques de performances, attributs de configuration et attributs d'inventaire pour les produits définis dans un flux d'inventaire et vendus à la suite de liens commerciaux.

Ce rapport ne peut être renvoyé que par une demande asynchrone (c'est-à-dire, via la méthode Reports.request()).

Étant donné que les événements se produisent à des dates spécifiques, une demande de ce rapport doit spécifier un timeRange. Vous pouvez spécifier l'un des éléments suivants:

startDate et endDate.
changedMetricsSinceTimestamp (changedAttributesSinceTimestamp n'est pas valide pour les événements).

Demander un extrait

Envoyer un Reports.request() corps de la requête, mais spécifiez "reportType": "productLeadAndCrossSell".

{
...
  "reportType": "productLeadAndCrossSell",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Pour chaque colonne que vous souhaitez afficher ou filtrer dans le rapport, spécifiez la valeur columnName indiquée dans le tableau ci-dessous. Vous pouvez également spécifier headerText, startDate, et endDate. Notez que certaines colonnes ne peuvent pas être filtrées. reportez-vous à "Filtrable" dans le tableau ci-dessous.

`columnName`	Description	Comportement	Type	Filtrable
`agency`	Nom de l'agence.	attribut	`String`	Oui
`agencyId`	ID d'agence DS.	attribut	`ID`	Oui
`advertiser`	Nom de l'annonceur.	attribut	`String`	Oui
`advertiserId`	référence annonceur DS.	attribut	`ID`	Oui
`productId`	L'ID de l'article du produit.	attribut	`String`	Oui
`productCountry`	Pays enregistré pour le flux d'inventaire du produit.	attribut	`String`	Oui
`productLanguage`	Langue enregistrée pour le flux d'inventaire du produit.	attribut	`String`	Oui
`productMpn`	Attribut MPN (référence fabricant) d'un article.	attribut	`String`	Oui
`productColor`	Attribut color [couleur] d'un article.	attribut	`String`	Oui
`productSize`	Attribut size [taille] d'un article.	attribut	`String`	Oui
`productMaterial`	Attribut material [matière] d'un article.	attribut	`String`	Oui
`productPattern`	Attribut pattern d'un article.	attribut	`String`	Oui
`productAvailability`	Attribut availability [disponibilité] d'un article.	attribut	`Product availability`	Oui
`productGender`	Attribut gender d'un article.	attribut	`String`	Oui
`productAgeGroup`	Attribut age group [tranche d'âge] d'un article.	attribut	`String`	Oui
`productLandingPageUrl`	Attribut page de destination d'un article.	attribut	`String`	Oui
`productCategory`	Attribut google_product_category [catégorie_de_produits_google] d'un article.	attribut	`String`	Oui
`productCategoryLevel1`	Attribut catégorie de produits google niveau 1 d'un article.	attribut	`String`	Oui
`productCategoryLevel2`	Attribut catégorie de produits google niveau 2 d'un article.	attribut	`String`	Oui
`productCategoryLevel3`	Attribut catégorie de produits google niveau 3 d'un article.	attribut	`String`	Oui
`productCategoryLevel4`	Attribut catégorie de produits google niveau 4 d'un article.	attribut	`String`	Oui
`productCategoryLevel5`	Attribut catégorie de produits google niveau 5 d'un article.	attribut	`String`	Oui
`productBrand`	Attribut brand [marque] d'un article.	attribut	`String`	Oui
`productGtin`	Attribut GTIN (Global Trading Item Number) d'un article.	attribut	`String`	Oui
`productPrice`	Attribut price d'un article.	attribut	`Money`	Oui
`productSalePrice`	Attribut price d'un article.	attribut	`Money`	Oui
`productTypeLevel1`	Attribut product type leve 1 d'un article.	attribut	`String`	Oui
`productTypeLevel2`	Attribut product type leve 2 d'un article.	attribut	`String`	Oui
`productTypeLevel3`	Attribut product type leve 3 d'un article.	attribut	`String`	Oui
`productTypeLevel4`	Attribut product type leve 4 d'un article.	attribut	`String`	Oui
`productTypeLevel5`	Attribut product type leve 5 d'un article.	attribut	`String`	Oui
`productCondition`	Attribut condition d'un article.	attribut	`String`	Oui
`productCustomLabel0`	Attribut custom label 0 [étiquette personnalisée 0] d'un article.	attribut	`String`	Oui
`productCustomLabel1`	Attribut étiquette personnalisée 1 d'un article.	attribut	`String`	Oui
`productCustomLabel2`	Attribut étiquette personnalisée 2 d'un article.	attribut	`String`	Oui
`productCustomLabel3`	Attribut étiquette personnalisée 3 d'un article.	attribut	`String`	Oui
`productCustomLabel4`	Attribut étiquette personnalisée 4 d'un article.	attribut	`String`	Oui
`productCostOfGoodsSold`	Coût total de la vente d'un produit spécifié dans le flux d'inventaire.	attribut	`Money`	Oui
`productStoreId`	Magasin pour lequel un produit a fait l'objet d'une annonce produit en magasin. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.	attribut	`String`	Oui
`productChannel`	Attribut de canal de ventes d'un article produit: `Online` ou `Local`.	attribut	`Product channel`	Oui
`productChannelExclusivity`	Attribut de canal exclusif d'un article.	attribut	`Product channel exclusivity`	Oui
`productItemGroupId`	Attribut d'identifiant de groupe d'articles d'un article.	attribut	`String`	Oui
`productTitle`	Attribut "title" d'un article.	attribut	`String`	Oui
`dfaActions`	Nombre total d'actions Campaign Manager.	métrique	`Integer`	Oui
`dfaRevenue`	Revenus cumulés générés par les transactions Campaign Manager.	métrique	`Money`	Oui
`dfaTransactions`	Nombre total de transactions Campaign Manager.	métrique	`Integer`	Oui
`dfaWeightedActions`	Somme pondérée des actions Campaign Manager.	métrique	`Number`	Oui
`dfaActionsCrossEnv`	Nombre total d'actions Campaign Manager multi-environnements.	métrique	`Number`	Oui
`dfaRevenueCrossEnv`	Revenus cumulés générés par les transactions Campaign Manager multi-environnements.	métrique	`Money`	Oui
`dfaTransactionsCrossEnv`	Nombre total de transactions Campaign Manager multi-environnements.	métrique	`Number`	Oui
`dfaWeightedActionsCrossEnv`	Somme pondérée des actions multi-environnements Campaign Manager.	métrique	`Number`	Oui
`crossSellAverageUnitPrice`	Prix moyen enregistré pour la vente d'un produit à la suite de la promotion d'un autre produit	métrique	`Money`	Oui
`crossSellCostOfGoodsSold`	Coût total de la vente d'un produit à la suite de la promotion d'un autre produit.	métrique	`Money`	Oui
`crossSellGrossFromUnitsSold`	Total des revenus générés par les ventes d'un produit à la suite de la promotion d'un autre produit.	métrique	`Money`	Oui
`crossSellGrossProfitMargin`	Marge bénéficiaire brute d'un produit spécifique vendu à la suite de la promotion d'un autre produit.	métrique	`Number`	Oui
`crossSellRevenueFromUnitsSold`	Revenu total généré par les ventes croisées (revenus générés à la suite de la promotion d'un autre produit).	métrique	`Money`	Oui
`crossSellUnitsSold`	Nombre d'unités vendues à la suite de ventes croisées. Il s'agit du nombre d'unités vendues suite à la promotion d'un autre produit.	métrique	`Number`	Oui
`leadAverageUnitPrice`	Prix moyen enregistré pour la vente d'un produit à la suite de sa promotion.	métrique	`Money`	Oui
`leadCostOfGoodsSold`	Coût total de la vente d'un produit à la suite de sa promotion.	métrique	`Money`	Oui
`leadGrossProfitFromUnitsSold`	Total des revenus générés par les ventes d'un produit à la suite de sa promotion.	métrique	`Money`	Oui
`leadGrossProfitMargin`	Marge bénéficiaire brute d'un produit spécifique directement due à sa promotion.	métrique	`Number`	Oui
`leadRevenueFromUnitsSold`	Total des revenus générés par un produit à la suite de sa promotion.	métrique	`Money`	Oui
`leadUnitsSold`	Nombre d'unités vendues à la suite de la promotion du produit.	métrique	`Number`	Oui
`productUnitsSold`	Nombre total d'unités vendues pour un produit donné.	métrique	`Number`	Oui
`productRevenueFromUnitsSold`	Revenu total généré par un produit (en utilisant le prix indiqué pour chaque produit).	métrique	`Money`	Oui
`productAverageUnitPrice`	Prix moyen enregistré pour la vente d'un produit (en utilisant le prix indiqué pour chaque produit).	métrique	`Money`	Oui
`date`	Segmente le rapport par jour. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque jour. Cette colonne affiche la date de chaque ligne.	segmenter	`Date`	Oui
`monthStart`	Segmente le rapport par mois. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque mois. Cette colonne affiche le premier jour du mois de chaque ligne.	segmenter	`Date`	Oui
`monthEnd`	Segmente le rapport par mois. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque mois. Cette colonne affiche le dernier jour du mois pour chaque ligne.	segmenter	`Date`	Oui
`quarterStart`	Segmente le rapport par trimestre. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque trimestre. Cette colonne affiche le premier jour de chaque trimestre.	segmenter	`Date`	Oui
`quarterEnd`	Segmente le rapport par trimestre. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque trimestre. Cette colonne affiche le dernier jour de chaque trimestre de chaque ligne.	segmenter	`Date`	Oui
`weekStart`	Segmente le rapport par semaine (du dimanche au samedi) chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne renvoie le premier jour (dimanche) de chaque ligne.	segmenter	`Date`	Oui
`weekEnd`	Segmente le rapport par semaine (du dimanche au samedi) chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne renvoie le dernier jour (samedi) de chaque ligne.	segmenter	`Date`	Oui
`yearStart`	Segmente le rapport par année. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le premier jour de l'année pour chaque ligne.	segmenter	`Date`	Oui
`yearEnd`	Segmente le rapport par année. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le dernier jour de l'année pour chaque ligne.	segmenter	`Date`	Oui
`deviceSegment`	Segmente le rapport par appareil. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une ligne pour chaque segment d'appareil. Cette colonne affiche le segment d'appareil pour chaque ligne.	segmenter	`Device segment`	Oui
`floodlightGroup`	Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche le nom du groupe Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`String`	Oui
`floodlightGroupId`	Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche l'ID de groupe Floodlight DS de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`ID`	Oui
`floodlightGroupTag`	Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche le tag de groupe Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`String`	Oui
`floodlightActivity`	Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche le nom de l'activité Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`String`	Oui
`floodlightActivityId`	Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche l'ID d'activité Floodlight DS de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`ID`	Oui
`floodlightActivityTag`	Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche le tag d'activité Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight.	segmenter	`String`	Oui
`accountId`	ID de compte de moteur DS.	segmenter	`ID`	Oui
`campaignId`	Segmente le rapport par campagne. Cette ligne affiche l'ID de campagne DS qui lui est associé.	segmenter	`ID`	Oui
`adGroupId`	Segmente le rapport par groupe d'annonces. Cette ligne affiche l'ID du groupe d'annonces qui lui est associé.	segmenter	`ID`	Oui