Sommaire
Réponse directe
Sur une cohorte created_at, COD Delivery Insights calcule total_orders, delivered_orders, refused_returned_orders (refus + retours groupés), delivery_rate_pct, refused_rate_pct, COD livré et quantités livrées, avec classements ville et top produits/variantes livrés. Les « pires villes » exigent WORST_CITY_MIN_ORDERS = 10. Pour les agents : Team Performance expose sent_to_delivery_by (qui a envoyé au transporteur), pas un KPI Insights « refus par agent de confirmation ». Le champ source existe sur la commande mais COD Insights ne publie pas de taux refus par source ads.
Métriques COD Insights (définitions produit)
refused_returned_orders mélange refus à la porte et retours en transit pour le KPI — utile en tendance, pas équivalent à « refus pur » isolé. Documentez votre lecture interne avant de comparer deux périodes.
La résolution de ville combine override livraison, ville client et nom ville fournisseur, avec normalisation d’affichage pour le rapport.
| Métrique | Définition dans CodDeliveryAnalyticsService |
|---|---|
| total_orders | Commandes créées dans la période (cohorte created_at) |
| delivered_orders | delivery_status = delivered |
| refused_returned_orders | Regroupement refus + retour (libellés refusé/refused/retourné/returned/etc.) |
| delivery_rate_pct | livrés ÷ total × 100 |
| refused_rate_pct | refused_returned_orders ÷ total × 100 |
| delivered_cod_amount | Somme total_amount des livrés |
| delivered_quantity | Somme quantités des lignes des commandes livrées |
Monitorer par ville
Top villes par volume (getTopCitiesByOrders), par livrés (getTopCitiesByDelivered) et « pires villes » par taux refus/retour (getWorstCitiesByRefusedRate).
Pour les classements « pires villes », CodDeliveryAnalyticsService impose WORST_CITY_MIN_ORDERS = 10 : une ville à 4 commandes et 100 % de refus n’apparaît pas — c’est voulu pour éviter des conclusions sur micro-échantillons.
- Choisir une plage de dates (ex. 30 jours calendaires).
- Lire delivery_rate_pct global et refused_rate_pct (regroupement refus/retour).
- Identifier les villes à volume suffisant dans les tops et le widget pires villes (≥ 10 commandes).
- Croiser avec les libellés transporteur si vous voulez isoler le refus à la porte.
- Comparer deux cohortes comparables — pas des périodes avec définitions différentes.
Monitorer par produit et variante
COD Insights expose getTopProducts et getTopVariantsByDeliveredQuantity : ce sont des classements par quantités livrées sur la cohorte, pas un widget « pire taux refus par SKU » garanti.
Pour repérer une variante génératrice de retours, croisez refused_returned groupé, notes agents et le guide dédié produits/retours — exigez volume suffisant par variante avant action drastique.
| Vue Insights | Ce qu’elle mesure | Ce qu’elle ne garantit pas |
|---|---|---|
| Top produits livrés | Quantités livrées par product_name | Taux refus isolé par produit |
| Top variantes livrées | Quantités livrées par product + variant | Causalité « mauvais produit » sur 3 commandes |
| Taux global refused_rate_pct | Refus + retours groupés sur toute la cohorte | Segment SKU refus pur |
Agents : COD Insights vs Team Performance (lecture honnête)
Ne cherchez pas dans COD Insights un classement « refus par agent de confirmation » — ce KPI n’y est pas.
Team Performance (livraison) agrège notamment sent_to_delivery_by : quel utilisateur a passé la commande au transporteur, avec volumes livrés et refused_returned associés à ces flux. Cela mesure l’activité d’envoi logistique, pas la qualité d’appel de confirmation.
Pour piloter la confirmation : files, statuts d’appel, notes, leaderboards confirmation (volumes confirmés/annulés) — audit manager sur échantillons si besoin.
| Dimension agent | Où la lire | Limite |
|---|---|---|
| Agent confirmation (appels) | File confirmation, notes, Team Performance confirmation | Pas de refused_rate_pct par agent dans Insights |
| Agent envoi livraison | Team Performance : sent_to_delivery_by | Mesure l’envoi, pas le script d’appel |
| Livraison réussie / échec | COD Insights global + par ville | Pas segmenté par agent confirmation |
Ce que COD Insights ne couvre pas (acquisition)
Le champ source sur la commande (boutique, Sheets, etc.) existe pour filtres et exports ops.
COD Delivery Insights ne publie pas de taux refus ou livraison par source d’acquisition, campagne ads ou UTM. Ne communiquez pas un « KPI Meta vs Google » depuis ce module sans calcul externe documenté.
Pourquoi les petits échantillons trompent
3 commandes dont 2 refusées donnent 66 % de refus — statistiquement fragile. WORST_CITY_MIN_ORDERS = 10 filtre les pires villes ; appliquez la même prudence mentale aux variantes avant de retirer un SKU.
Ne fixez pas d’objectif de taux « standard industrie » inventé : comparez vos cohortes entre elles à volume comparable.
Exemple fictif
Exemple de lecture
Cohorte 30 jours : 800 commandes, 520 livrées → delivery_rate_pct ~65 %. refused_returned_orders = 180 (refused_rate_pct ~22,5 %) — mélange refus porte et retours transit. Ville V1 : 14 commandes, taux refus élevé → apparaît dans « pires villes » (≥ 10). Ville V2 : 4 commandes, 100 % refus → ignorée (sous seuil). Top variante = quantités livrées, pas refus. Team Performance : agent L = 72 % des sent_to_delivery_by — lecture logistique, pas « meilleur confirmeur ». Action : script confirmation renforcé sur V1 ; pas de blacklist V2.
Limites et points d’attention
- refused_returned_orders regroupe refus et retours — nuancez en interne.
- Pas de KPI Insights refus par agent de confirmation ni par source acquisition.
- Top produits/variantes = quantités livrées, pas classement refus pur par SKU.
- Pas de benchmarks externes ni d’objectifs de taux inventés.
- Les libellés transporteur influencent le regroupement refus/retour.