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"
      ]
    }
  ]
}
Exemple : « Valeur investie » en octobre, comparé à septembre.

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:charge
  • Impressions

    Le nombre de fois que vos annonces ont été affichées.

    kwai_ads:show
  • Clics

    Le nombre de fois que les utilisateurs ont cliqué sur la couverture ou le créatif de votre annonce.

    kwai_ads:photo_click
  • TDC

    Le taux de clics de vos annonces.

    kwai_ads:photo_click_ratio
  • Impressions de l'Actif

    Le nombre d'impressions générées par l'actif promu.

    kwai_ads:aclick
  • Actions

    Le nombre d'actions générées par vos annonces.

    kwai_ads:bclick
  • Taux d'Action

    Le pourcentage d'impressions d'annonce qui ont généré une action.

    kwai_ads:action_ratio
  • Coût par action

    Le coût moyen de chaque action générée par vos annonces.

    kwai_ads:action_cost
  • CPM

    The average cost per thousand impressions.

    kwai_ads:impression_1k_cost
  • Reproductions de Vidéo 3s

    Le nombre de reproductions de vidéo qui ont atteint au moins 3 secondes.

    kwai_ads:played_three_seconds
  • Taux de Reproduction 3s

    Le pourcentage d'impressions qui ont généré une reproduction de vidéo de 3 secondes.

    kwai_ads:play_3s_ratio
  • Taux de Reproduction 5s

    Le pourcentage d'impressions qui ont généré une reproduction de vidéo de 5 secondes.

    kwai_ads:play_5s_ratio
  • Taux de Complétion

    Le pourcentage de reproductions de vidéo qui sont allées jusqu'à la fin.

    kwai_ads:play_end_ratio
  • Likes

    Le nombre de likes générés par vos annonces.

    kwai_ads:like
  • Commentaires

    Le nombre de commentaires générés par vos annonces.

    kwai_ads:comment
  • Partages

    Le nombre de partages générés par vos annonces.

    kwai_ads:share
  • Suiveurs

    Le nombre de nouveaux abonnés générés par vos annonces.

    kwai_ads:follow
  • Conversions

    Le nombre de conversions attribuées à vos annonces.

    kwai_ads:conversion_num
  • Coût par conversion

    Le coût moyen de chaque conversion.

    kwai_ads:conversion_cost
  • Taux de Conversion

    Le pourcentage d'actions qui ont généré une conversion.

    kwai_ads:conversion_ratio
  • Conversions Profondes

    Le nombre de conversions profondes attribuées à vos annonces.

    kwai_ads:deep_conversion_num
  • Coût par Conversion Profonde

    Le coût moyen de chaque conversion profonde.

    kwai_ads:deep_conversion_cost
  • Taux 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_day
  • Impressions et Clics au fil du temps

    Le nombre d'impressions et de clics au fil du temps.

    kwai_ads:impressions_clicks_by_day
  • Conversions 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_table
  • Groupes d'Annonces en Vedette

    Groupes d'annonces avec des données de performance pour la période sélectionnée.

    kwai_ads:ad_groups_table
  • Créatifs en Vedette

    Créatifs avec des données de performance pour la période sélectionnée.

    kwai_ads:creatives_table
  • Public par Âge

    Performance regroupée par tranche d'âge.

    kwai_ads:audience_by_age
  • Public 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.