La segmentation, disponible dans les rapports personnalisés de Merchant Center, peut être implémentée dans l'API Reporting en ajoutant le champ approprié à une requête. Par exemple, l'interrogation de segments.program
génère un rapport comportant une ligne pour chaque programme (annonces Shopping, fiches produit gratuites, etc.). Celle-ci inclut les métriques (impressions, clics, etc.) pour ce programme, comme spécifié dans la clause SELECT
.
Comme pour les rapports personnalisés de Merchant Center, vous pouvez spécifier plusieurs segments dans la même requête avec l'API Reporting.
L'exemple de requête suivant récupère les clics de tous les produits de votre compte sur une période de 30 jours, segmentés par program
et offer_id
:
SELECT
segments.program,
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'
L'envoi de cette requête à reports.search
génère une ligne spécifiant les clics pour chaque combinaison de offer_id
et program
, comme dans cet exemple de chaîne JSON :
{
"results": [
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12345"
},
"metrics": {
"clicks": "38"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12346"
},
"metrics": {
"clicks": "125"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12346"
},
"metrics": {
"clicks": "23"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12347"
},
"metrics": {
"clicks": "8"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12347"
},
"metrics": {
"clicks": "3"
}
}
]
}
Catégories et types de produit
Le langage de requête Merchant Center accepte la segmentation des métriques en deux groupes d'attributs que vous pouvez définir pour organiser votre inventaire :
- Niveaux de catégorie (
segments.category_l1
,segments.category_l2
, etc.) - Catégories issues de la classification des produits Google. Google peut attribuer automatiquement une catégorie à votre produit si vous n'en fournissez pas, ou affiner davantage la catégorie fournie.
- Niveaux de type de produit (
segments.product_type_l1
,segments.product_type_l2
, etc.) - Types de produits que vous attribuez en fonction de votre propre catégorisation. Contrairement aux niveaux de catégorie, il n'existe aucun ensemble prédéfini de valeurs acceptées.
Les attributs de catégorie et de type de produit sont organisés selon une hiérarchie à plusieurs niveaux séparés par le caractère >
, conformément aux spécifications des données produit. Mais, dans les rapports, vous sélectionnez chaque niveau de la hiérarchie séparément.
Prenons l'exemple d'un produit avec les niveaux de type de produit suivants :
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Les rapports renverront chaque niveau dans son propre champ, comme ceci :
Segment | Valeur |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
Métriques de devises et de prix
Le champ segments.currency_code
d'une ligne de rapport ReportRow
indique la devise dans laquelle les métriques de prix telles que metrics.order_item_sales_micros
sont renvoyées.
La ReportRow
renvoyée inclut automatiquement segments.currency_code
lorsque vous sélectionnez l'une des métriques de prix ci-dessous, car c'est important pour les interpréter correctement.
metrics.aov_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Métriques Acheter sur Google
Le langage de requête Merchant Center accepte deux catégories de métriques pour les commandes Acheter sur Google : les métriques au niveau des articles et les métriques au niveau des commandes.
- Métriques au niveau des articles
Métriques calculées sur la base des articles inclus dans les commandes et associées aux variables des articles de chaque commande.
metrics.item_days_to_ship
metrics.item_fill_rate
metrics.ordered_items
metrics.ordered_item_sales_micros
metrics.rejected_items
metrics.returned_items
metrics.return_rate
metrics.returns_micros
metrics.shipped_items
metrics.shipped_item_sales_micros
metrics.unshipped_items
- Métriques au niveau des commandes
Métriques calculées sur la base des commandes.
metrics.aos
metrics.aov_micros
metrics.days_to_ship
metrics.orders
metrics.shipped_orders
metrics.unshipped_orders
Les métriques au niveau des commandes ne sont pas associées aux variables des articles de chaque commande.
Vous pouvez sélectionner des métriques au niveau des articles en combinaison avec n'importe quel segment disponible. Toutefois, vous ne pouvez pas sélectionner des métriques au niveau des commandes en combinaison avec les segments de variables de produit suivants :
segments.brand
segments.category_l1
,segments.category_l2
,segments.category_l3
,segments.category_l4
etsegments.category_l5
segments.custom_label1
,segments.custom_label2
,segments.custom_label3
,segments.custom_label4
etsegments.custom_label5
segments.offer_id
segments.product_type_l1
,segments.product_type_l2
,segments.product_type_l3
,segments.product_type_l4
etsegments.product_type_l5
segments.title
En savoir plus
Pour obtenir la liste complète des segments, consultez la documentation.