Metrics
Métriques Kwai Ads via l'API
Votre client connecte son compte Kwai Ads et votre produit interroge 31 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "kwai_ads:charge",
"component": "number_v1",
"metrics": [
"cost"
]
}
]
}Plus d'exemples d'appels Kwai Ads
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Dépenses au fil du temps
Le montant total investi au fil du temps.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kwai_ads:spend_by_day",
"component": "chart_v1",
"metrics": [
"cost"
],
"dimensions": [
"stat_date"
]
}
]
}Tableau
Campagnes en Vedette
Campagnes avec des données de performance pour la période sélectionnée.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kwai_ads:campaigns_table",
"component": "datatable_v1",
"metrics": [
"cost",
"exposure",
"click",
"ctr",
"action",
"cpa"
],
"dimensions": [
"campaign_name"
]
}
]
}Chiffre
Impressions
Le nombre de fois que vos annonces ont été affichées.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "kwai_ads:show",
"component": "number_v1",
"metrics": [
"exposure"
]
}
]
}Chiffres
23 métriques
Valeur investie
Le montant total investi dans les Kwai Ads pendant la période sélectionnée.
kwai_ads:chargeImpressions
Le nombre de fois que vos annonces ont été affichées.
kwai_ads:showClics
Le nombre de fois que les utilisateurs ont cliqué sur la couverture ou le créatif de votre annonce.
kwai_ads:photo_clickTDC
Le taux de clics de vos annonces.
kwai_ads:photo_click_ratioImpressions de l'Actif
Le nombre d'impressions générées par l'actif promu.
kwai_ads:aclickActions
Le nombre d'actions générées par vos annonces.
kwai_ads:bclickTaux d'Action
Le pourcentage d'impressions d'annonce qui ont généré une action.
kwai_ads:action_ratioCoût par action
Le coût moyen de chaque action générée par vos annonces.
kwai_ads:action_costCPM
The average cost per thousand impressions.
kwai_ads:impression_1k_costReproductions de Vidéo 3s
Le nombre de reproductions de vidéo qui ont atteint au moins 3 secondes.
kwai_ads:played_three_secondsTaux de Reproduction 3s
Le pourcentage d'impressions qui ont généré une reproduction de vidéo de 3 secondes.
kwai_ads:play_3s_ratioTaux de Reproduction 5s
Le pourcentage d'impressions qui ont généré une reproduction de vidéo de 5 secondes.
kwai_ads:play_5s_ratioTaux de Complétion
Le pourcentage de reproductions de vidéo qui sont allées jusqu'à la fin.
kwai_ads:play_end_ratioLikes
Le nombre de likes générés par vos annonces.
kwai_ads:likeCommentaires
Le nombre de commentaires générés par vos annonces.
kwai_ads:commentPartages
Le nombre de partages générés par vos annonces.
kwai_ads:shareSuiveurs
Le nombre de nouveaux abonnés générés par vos annonces.
kwai_ads:followConversions
Le nombre de conversions attribuées à vos annonces.
kwai_ads:conversion_numCoût par conversion
Le coût moyen de chaque conversion.
kwai_ads:conversion_costTaux de Conversion
Le pourcentage d'actions qui ont généré une conversion.
kwai_ads:conversion_ratioConversions Profondes
Le nombre de conversions profondes attribuées à vos annonces.
kwai_ads:deep_conversion_numCoût par Conversion Profonde
Le coût moyen de chaque conversion profonde.
kwai_ads:deep_conversion_costTaux de Conversion Profonde
Le pourcentage de conversions qui ont généré une conversion profonde.
kwai_ads:deep_conversion_ratio
Graphiques
3 métriques
Dépenses au fil du temps
Le montant total investi au fil du temps.
kwai_ads:spend_by_dayImpressions et Clics au fil du temps
Le nombre d'impressions et de clics au fil du temps.
kwai_ads:impressions_clicks_by_dayConversions au fil du temps
Le nombre de conversions et de conversions profondes au fil du temps.
kwai_ads:conversions_by_day
Tableaux
5 métriques
Campagnes en Vedette
Campagnes avec des données de performance pour la période sélectionnée.
kwai_ads:campaigns_tableGroupes d'Annonces en Vedette
Groupes d'annonces avec des données de performance pour la période sélectionnée.
kwai_ads:ad_groups_tableCréatifs en Vedette
Créatifs avec des données de performance pour la période sélectionnée.
kwai_ads:creatives_tablePublic par Âge
Performance regroupée par tranche d'âge.
kwai_ads:audience_by_agePublic par Genre
Performance regroupée par genre.
kwai_ads:audience_by_gender
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
