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"
]
}
]
}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:impressionsEngagement
Le nombre total d'engagements sur vos épingles, y compris les clics et les épingles enregistrées.
pinterest:engagementTaux 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_rateClics
Le nombre de clics sur vos épingles pendant la période d'analyse.
pinterest:clicksTaux 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_rateTotal 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:savedTotal 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_pinsTotal 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_formatImpressions par plateforme
Le nombre de fois que vos pins ont été vus par plateforme.
pinterest:impressions_by_platformEngagement 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:pinsTableaux 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.
