Metrics

Métriques Pinterest via l'API

Votre client connecte son compte Pinterest et votre produit interroge 14 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": "pinterest:impressions",
      "component": "number_v1",
      "metrics": [
        "impression"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}
Exemple : « Impressions » en octobre, comparé à septembre.

Plus d'exemples d'appels Pinterest

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

Impressions par format

Le nombre de fois que vos pins ont été vus par format.

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": "pinterest:impressions_by_pin_format",
      "component": "chart_v1",
      "metrics": [
        "impression"
      ],
      "dimensions": [
        "pin_format"
      ]
    }
  ]
}

Tableau

Pins en vedette

Performance des épingles de votre compte pendant la période analysée, indépendamment de la date de publication. Ce tableau présente uniquement des données sur "vos épingles", n'inclut pas "d'autres épingles".

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": "pinterest:pins",
      "component": "datatable_v1",
      "metrics": [
        "description",
        "impression",
        "save",
        "created_at"
      ],
      "dimensions": [
        "board_pin"
      ]
    }
  ]
}

Chiffre

Engagement

Le nombre total d'engagements sur vos épingles, y compris les clics et les épingles enregistré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": "pinterest:engagement",
      "component": "number_v1",
      "metrics": [
        "engagement"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}

Chiffres

9 métriques

  • Impressions

    Le nombre de fois où vos épingles ont été vues pendant la période d'analyse.

    pinterest:impressions
  • Engagement

    Le nombre total d'engagements sur vos épingles, y compris les clics et les épingles enregistrées.

    pinterest:engagement
  • Taux d'engagement

    Le total des engagements avec vos Pins divisé par le nombre total de fois que vos Pins ont été vus. Les engagements incluent les Pins enregistrés, les clics sur le Pin et les clics sortants.

    pinterest:engagement_rate
  • Clics

    Le nombre de clics sur vos épingles pendant la période d'analyse.

    pinterest:clicks
  • Taux de Clics sur les Épingles

    Le nombre total de clics sur votre Pin pour accéder à du contenu à l'intérieur ou à l'extérieur de Pinterest, divisé par le nombre total de fois que vos Pins sont apparus à l'écran.

    pinterest:clicks_rate
  • Total des Épingles enregistrées

    Nombre total de fois que vos pins ont été enregistrés par d'autres utilisateurs (repins) pendant la période analysée.

    pinterest:saved
  • Total des Épingles

    Nombre total de pins postés sur le compte.

    pinterest:total_pins
  • Épingles publiées

    Nombre d'Épingles publiées pendant la période analysée, en ne tenant compte que des contenus visibles au public. Les Épingles protégées ou à visibilité restreinte ne sont pas incluses.

    pinterest:total_period_pins
  • Total des Planches

    Nombre total de tableaux créés pendant la période analysée.

    pinterest:total_boards

Graphiques

3 métriques

  • Impressions par format

    Le nombre de fois que vos pins ont été vus par format.

    pinterest:impressions_by_pin_format
  • Impressions par plateforme

    Le nombre de fois que vos pins ont été vus par plateforme.

    pinterest:impressions_by_platform
  • Engagement par format

    Le nombre total d'engagements sur vos Pins, par format, y compris les clics et les Pins enregistrés.

    pinterest:engagement_by_pin_format

Tableaux

2 métriques

  • Pins en vedette

    Performance des épingles de votre compte pendant la période analysée, indépendamment de la date de publication. Ce tableau présente uniquement des données sur "vos épingles", n'inclut pas "d'autres épingles".

    pinterest:pins
  • Tableaux en vedette

    Tableaux qui ont eu le plus grand impact sur votre audience.

    pinterest:boards

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.