Analyser les performances de l'agent UCP (alpha)

L'API Merchant Reports vous permet de récupérer de manière programmatique les métriques de performances de paiement et de conversion du protocole Universal Commerce Protocol (UCP) sur les surfaces Google, y compris le Mode IA dans la recherche et Gemini. Ces rapports fournissent les mêmes insights sur les performances que ceux disponibles dans le tableau de bord des données analytiques UCP de Merchant Center. Ils vous aident à surveiller les entonnoirs de conversion, les commandes finalisées, les transferts de panier et l'engagement au niveau des produits.

La sous-API Reporting propose deux vues pour analyser les performances d'UCP :

  • UcpAgenticPerformanceView (ucp_agentic_performance_view) : fournit des métriques sur l'entonnoir de conversion, les commandes, les annulations et les transferts de panier au niveau du compte, segmentées par date et par pays du client.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view) : fournit des métriques sur les clics sur le bouton d'achat (offer_id) au niveau du produit, segmentées par date et par pays du client.

Avant de commencer

Avant d'interroger les vues sur les performances de l'UCP, assurez-vous de respecter les exigences suivantes :

  • Utilisez le point de terminaison v1alpha : envoyez vos requêtes MCQL à la méthode accounts.reports.search du point de terminaison v1alpha. Pour savoir comment exécuter des demandes de rapports, consultez Premiers pas avec l'API Merchant Reports.
  • Comptes finaux uniquement : ucp_agentic_performance_view et ucp_agentic_product_performance_view ne sont disponibles que pour les types de comptes finaux (comptes individuels et sous-comptes individuels). Le service de création de rapports n'est pas compatible avec les comptes avancés (multicomptes). Pour récupérer les performances UCP dans un compte avancé, interrogez chaque sous-compte individuellement.
  • Filtre de date obligatoire : vous devez spécifier une condition sur date dans la clause WHERE de chaque requête pour les deux vues.

Analyser les performances du CPV au niveau du compte

Utilisez ucp_agentic_performance_view pour suivre l'ensemble de votre entonnoir de conversion UCP, des clics sur le bouton d'achat et de l'association de compte aux achats effectués et aux transferts de panier.

Métriques de devises et de prix

ucp_agentic_performance_view gère les devises et les métriques Price de la même manière que les rapports sur les performances :

  • Métriques Price : les métriques suivantes renvoient un objet Price contenant à la fois une valeur amount_micros et une valeur currency_code :
    • purchase_value
    • average_order_value
    • average_purchase_product_value
    • average_cart_value
    • average_cart_product_value
  • Métriques sans prix : les métriques suivantes n'ont pas de devise associée :
    • buy_button_clicks
    • accounts_linked
    • account_linking_rate
    • purchase_count
    • cancellations
    • average_purchase_product_count
    • cart_transfers
    • average_cart_product_count
  1. Métriques globales sur l'entonnoir et le nombre (indépendantes de la devise) : sélectionnez uniquement les métriques non liées au prix pour obtenir des nombres agrégés indépendants de la devise.
  2. Métriques sur la valeur des achats et des paniers (par devise) : sélectionnez les métriques Price ainsi que le nombre de commandes et de paniers correspondants pour analyser les revenus et la valeur par devise.

Requête 1 : Récupérer les métriques globales de l'entonnoir (indépendantes de la devise)

Utilisez la requête suivante pour récupérer les métriques globales sur l'entonnoir de conversion, le nombre de commandes et le transfert de panier, indépendamment de la devise (sans inclure les métriques de valeur Price) :

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations,
  average_purchase_product_count,
  cart_transfers,
  average_cart_product_count
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

La réponse renvoie des métriques agrégées sur l'entonnoir pour chaque pays client :

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3",
        "averagePurchaseProductCount": 1.75,
        "cartTransfers": "52",
        "averageCartProductCount": 2.1
      }
    }
  ]
}

Requête 2 : Récupérer les métriques sur les achats et la valeur du panier (par devise)

Utilisez la requête suivante pour récupérer les valeurs d'achat, les valeurs moyennes des commandes et les valeurs de transfert de panier segmentées par devise :

SELECT
  date,
  account_id,
  customer_country_code,
  purchase_count,
  purchase_value,
  average_order_value,
  average_purchase_product_count,
  average_purchase_product_value,
  average_cart_value,
  average_cart_product_value
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20' AND purchase_count > 0

La réponse renvoie une ligne distincte pour chaque devise présente dans les métriques sur la valeur des achats ou du panier :

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "purchaseCount": "64",
        "purchaseValue": {
          "amountMicros": "5120000000",
          "currencyCode": "USD"
        },
        "averageOrderValue": {
          "amountMicros": "80000000",
          "currencyCode": "USD"
        },
        "averagePurchaseProductCount": 1.75,
        "averagePurchaseProductValue": {
          "amountMicros": "45714285",
          "currencyCode": "USD"
        },
        "cartTransfers": "52",
        "averageCartValue": {
          "amountMicros": "94500000",
          "currencyCode": "USD"
        },
        "averageCartProductCount": 2.1,
        "averageCartProductValue": {
          "amountMicros": "45000000",
          "currencyCode": "USD"
        }
      }
    }
  ]
}

Analyser les performances des UCP au niveau du produit

Utilisez ucp_agentic_product_performance_view pour identifier les produits individuels qui reçoivent des clics sur le bouton d'achat directement depuis les surfaces Google.

Récupérer les clics sur le bouton "Acheter" par produit

Utilisez la requête suivante pour récupérer les clics sur le bouton d'achat au niveau du produit pour une date spécifique :

SELECT
  date,
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date = '2026-09-20'

Vous pouvez également omettre date de la clause SELECT pour agréger les clics sur une période à l'aide de BETWEEN :

SELECT
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date BETWEEN '2026-09-01' AND '2026-09-20'
ORDER BY buy_button_clicks DESC

La réponse renvoie le nombre total de clics sur le bouton d'achat pour chaque offre correspondante :

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}
Précédent
Analyze YouTube Affiliate Performance (Alpha)
Suivant
Use Merchant Center Query Language