Skip to main content
Cette page documente @whop/elements@1.10.0 et @whop/elements-react@1.10.0.
Depuis v1.0.0. Se monte à l’intérieur de Ads. Créez-le pour obtenir un handle, puis montez ses éléments sur ce handle. Appelez destroy() pour supprimer le sous-contrôleur. Créez-le à nouveau pour obtenir un nouveau handle.

Aperçu

Une démo interactive en direct de la disposition par défaut de ce sous-contrôleur, avec des données d’exemple :

Options

Transmettez-les à ads.create('reporting', { … }), ou comme props sur <Reporting> avec React. Les props injectées par le parent n’apparaissent jamais ici.
string
La période couverte par chaque surface : today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time ou custom (à associer à customRange). Le graphique porte le sélecteur, qui modifie cette valeur — un hôte peut donc piloter la période et la relire via periodChanged. Par défaut : "last_14_days".L’une des valeurs "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" ou "custom".
object | null
La période explicite, sous forme d’instants ISO 8601, utilisée lorsque period vaut custom. Ignorée sinon. Par défaut : null.
"account" | "local"
Choix du fuseau horaire pour tous les chiffres rapportés. Utilisez account pour le preferences.ads_scheduling_timezone du compte ou local pour le fuseau horaire du navigateur du visiteur. Ce sont les seuls choix proposés par le graphique. Un fuseau IANA libre pourrait amener le sélecteur à étiqueter les données de manière incorrecte et serait perdu lorsque le visiteur modifie la sélection. Pour produire des rapports dans un autre fuseau horaire, modifiez le paramètre du compte. account revient au fuseau horaire du visiteur lorsque le compte n’a pas de paramètre. Par défaut : "account".
string
Code de devise ISO 4217 à trois lettres en minuscules pour les montants convertis, comme usd ou eur. S’il n’est pas défini, il prend la valeur preferences.ads_reporting_currency du compte. Par défaut : "".
"last_touch" | "first_touch"
Le point de contact du parcours d’un acheteur qui reçoit l’attribution : last_touch, la valeur par défaut, ou first_touch. Dans les deux cas, un point de contact Whop situé n’importe où dans le parcours remporte la catégorie Whop — le modèle ne choisit que les extrémités. Le tableau porte le sélecteur et modifie cette valeur : un hôte peut donc la piloter et la relire via attributionModelChanged. Par défaut : "last_touch".
string[]
Limite les rapports à ces campagnes publicitaires (adcamp_…). Vide, les rapports portent sur l’ensemble du compte. Remplacé par adGroupIds ou adIds lorsque l’un d’eux est défini. Transmettez un seul ID pour un chiffre exact : l’API de reporting filtre selon un seul chemin de source, donc lorsque plusieurs ID sont fournis, le graphique ne porte que sur le premier. Par défaut : [].
string[]
Limite les rapports à ces groupes d’annonces (adgrp_…). Prioritaire sur campaignIds. Même réserve concernant l’ID unique. Par défaut : [].
string[]
Limite les rapports à ces annonces (ad_…). Le filtre le plus restreint — prioritaire sur les deux autres. Même réserve concernant l’ID unique. Par défaut : [].
"ads" | "all" | "businesses" | "campaigns" | "ad-groups"
Le tableau sur lequel s’ouvre l’élément table : campaigns, ad-groups, ads, ou all pour la vue par source de trafic. all porte toujours sur l’ensemble du compte — la série par source n’existe qu’à ce niveau — de sorte qu’un filtre défini en parallèle restreint le tableau mais pas le graphique. Par défaut : "campaigns".
string[] | null
Le trafic sur lequel porte le graphique, sous forme de chemins de source — whop:* pour la publicité achetée via Whop, ext:* et ext:<platform>:* pour les annonces diffusées ailleurs, referrer:* pour l’organique, direct, other. null, la valeur par défaut, ne porte que sur la publicité Whop ; [] porte sur toutes les sources ; un tableau non vide porte sur celles-ci. Un axe DIFFÉRENT de campaignIds et consorts, qui filtrent au sein de la publicité Whop — les ratios dérivés des dépenses restent attribués à Whop quelle que soit cette valeur, car les dépenses n’ont jamais acheté que des annonces Whop. L’onglet All de l’élément table la modifie. Par défaut : null.

Événements

Transmettez les callbacks dans les options de création ou dans les props React.

onEditRequested

Le visiteur a demandé à modifier quelque chose — via un menu de ligne, une ligne de brouillon ou Edit ad dans l’overlay de détails. campaignId est toujours présent ; adGroupId et adId précisent l’élément cliqué. Émis uniquement lorsque useCampaignCreator est désactivé ; s’il est activé, le builder s’ouvre par-dessus la page et cet événement ne se déclenche pas.
AdsEditTarget

Méthodes

Appelez-les sur le sous-handle obtenu via ads.create('reporting', { … }).

update

Fusionne de nouvelles props et de nouveaux callbacks dans le sous-contrôleur. Paramètres
Partial<ReportingSubOptions>
requis

destroy

Détruit le sous-contrôleur et ses éléments, puis libère son emplacement exclusif. Un create("reporting") ultérieur repart de zéro.

Éléments

Les éléments montés par ce sous-contrôleur. Chacun a sa propre page :

ChartElement

Les performances d’un compte sur une période, avec un sélecteur de ce qu’il faut tracer — dépenses, impressions, clics ou toute conversion enregistrée par le compte. En lecture seule.

TableElement

Les campagnes, groupes d’annonces et annonces d’un compte publicitaire dans un seul tableau, avec les onglets permettant de passer de l’un à l’autre : sélectionnez des lignes pour filtrer le niveau inférieur, recherchez, triez, ventilez les chiffres, choisissez vos colonnes, et mettez en pause, reprenez, dupliquez ou supprimez directement depuis une ligne. La période couverte et les lignes filtrées sont conservées sur le handle, de sorte qu’un graphique monté à côté porte exactement sur les mêmes données.