Skip to main content
Créez des audiences personnalisées à partir de listes de clients ou de données Whop People, et créez des audiences similaires (lookalikes) pour atteindre des personnes proches d’une audience existante. Utilisez l’API Audiences pour créer des audiences, ajouter des personnes à une liste de clients téléversée, renommer ou refiltrer une audience, et suivre le traitement asynchrone. Les audiences Whop People peuvent s’actualiser automatiquement ou conserver un instantané.

Endpoints

Attributs

string
requis
ID de l’audience, préfixé par adaud_.
string
requis
Indique si l’audience cible un groupe de personnes défini ou des personnes similaires à une audience existante.Options disponibles : custom, lookalike
boolean
requis
Indique si Whop reconstruit les membres à partir des filtres People enregistrés deux fois par jour. Lorsque false, les audiences People conservent les membres identifiés lors de la création. Toujours false pour les listes téléversées, les lookalikes et les audiences d’engagement.
string
requis
Date de création de l’audience, sous forme d’horodatage ISO 8601.
string | null
requis
La raison pour laquelle une audience pending n’a pas démarré, ou pour laquelle une audience partial ou failed n’est pas entièrement construite. null lorsqu’il n’y a rien à signaler.
object | null
requis
Filtres Whop People enregistrés qui définissent les membres, avec les mêmes clés que GET /people. null pour les listes téléversées, les audiences d’engagement et les lookalikes.
string | null
requis
Date de la dernière reconstruction des membres de l’audience, sous forme d’horodatage ISO 8601. null jusqu’à la fin de la première construction.
number | null
requis
Pour les lookalikes : la borne supérieure de la tranche de similarité, sous forme de fraction (0.02 = les 2 % les plus proches). null pour les audiences personnalisées.
number | null
requis
Pour les lookalikes : la borne inférieure de la tranche de similarité, sous forme de fraction. null pour les audiences personnalisées et les lookalikes de premier niveau.
object[]
requis
Taux de correspondance estimés par réseau publicitaire. Vide pour les audiences d’engagement et les audiences non envoyées à un réseau pris en charge.

Propriétés

number | null
requis
Borne inférieure du pourcentage de correspondance estimé. null tant qu’il n’est pas disponible.
string
requis
La plateforme publicitaire qui a fourni l’estimation du taux de correspondance.Options disponibles : meta
string | null
requis
Disponibilité du taux de correspondance estimé.Options disponibles : calculating, available, unavailable
number | null
requis
Borne supérieure du pourcentage de correspondance estimé. null tant qu’il n’est pas disponible.
number
requis
Membres téléversés avec succès vers les comptes publicitaires connectés. Toujours 0 pour les lookalikes et les audiences d’engagement.
string
requis
Nom d’affichage de l’audience.
string[]
requis
ID de l’audience sur les réseaux publicitaires auxquels Whop envoie cette audience.
number
requis
Membres traités depuis la source jusqu’à présent. Toujours 0 pour les lookalikes et les audiences d’engagement.
number
requis
Progression du traitement, de 0 à 100.
string | null
requis
Pour les lookalikes : l’audience à partir de laquelle ce lookalike a été construit. null pour les audiences personnalisées.
string
requis
Source des membres : un CSV téléversé, des filtres Whop People ou l’engagement sur les réseaux sociaux. Les audiences d’engagement ne peuvent plus être créées.Options disponibles : csv_upload, people_filter, engagement
string
requis
État actuel de la création de l’audience. Lorsqu’une audience pending attend quelque chose, comme un compte publicitaire vers lequel téléverser, error_message indique quoi. Lorsque le statut est partial ou failed, error_message explique ce qui s’est mal passé.Options disponibles : pending, processing, ready, partial, failed
number
requis
Nombre total de membres détectés dans la source : lignes CSV pour les listes téléversées, personnes correspondantes pour les audiences automatiques. Toujours 0 pour les lookalikes et les audiences d’engagement.
string
requis
Date de dernière mise à jour de l’audience, sous forme d’horodatage ISO 8601.
Audience