Endpoints
Restrictions de ciblage
Les groupes d’annonces ne peuvent pas cibler les pays répertoriés dans le guide publicitaire. Les requêtes de création d’un groupe d’annonces ou de mise à jour de ses pays ciblés sont rejetées si elles incluent un pays bloqué dansregions.include.countries.
Attributs
Valeur en USD attribuée aux événements d’ajout au panier. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
La manière dont les enchères de diffusion sont définies dans l’enchère publicitaire. Les stratégies basées sur une cible utilisent
desired_cost_per_result.Options disponibles : minimum_cost, average_target, maximum_targetLe budget de ce groupe d’annonces en USD, devise dans laquelle il est stocké et facturé.
null lorsque le budget est défini sur la campagne à la place.Le même budget exprimé en
budget_currency au taux de change du jour, pour l’affichage dans la devise de reporting publicitaire du compte. null lorsque budget_amount l’est.Le code ISO 4217 dans lequel est exprimé
budget_amount_local : la préférence ads_reporting_currency du compte. usd sauf si le compte l’a modifiée.Indique si
budget_amount est dépensé par jour (daily) ou sur toute la durée du groupe d’annonces (lifetime). Un groupe d’annonces lifetime nécessite également ends_at, au moins 24 heures après son démarrage.Options disponibles : daily, lifetimeValeur en USD attribuée aux événements d’inscription terminée. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
Valeur en USD attribuée aux événements de contact. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
L’événement du pixel pour lequel l’optimisation est effectuée. Un événement standard, ou n’importe quel nom d’événement de pixel personnalisé.
Dépenses divisées par les événements d’ajout au panier attribués ; null lorsqu’ils ne sont pas l’objectif et qu’aucun n’est attribué.
Dépenses divisées par les événements d’inscription terminée attribués ; null lorsqu’ils ne sont pas l’objectif et qu’aucun n’est attribué.
Dépenses divisées par les événements de contact attribués ; null lorsque les contacts ne sont pas l’objectif et qu’aucun n’est attribué.
Dépenses divisées par les leads attribués ; null lorsque les leads ne sont pas un objectif et qu’aucun n’est attribué.
Dépenses divisées par les achats attribués ; null lorsque les achats ne sont pas un objectif et qu’aucun n’est attribué.
Dépenses divisées par les résultats attribués par le pixel Whop ; null lorsque rien d’attribuable par Whop n’est optimisé.
Dépenses divisées par les événements de prise de rendez-vous attribués ; null lorsque les rendez-vous ne sont pas l’objectif et qu’aucun n’est attribué.
Dépenses divisées par les événements de soumission de candidature attribués ; null lorsqu’ils ne sont pas l’objectif et qu’aucun n’est attribué.
Dépenses divisées par les événements de consultation de contenu attribués ; null lorsqu’ils ne sont pas l’objectif et qu’aucun n’est attribué.
Événements de conversion personnalisés (définis par le marchand) attribués par le pixel Whop, au dernier clic, tous noms d’événements personnalisés confondus.
Conversions personnalisées attribuées par le pixel Whop, indexées par le nom de votre événement, avec leur nombre au dernier clic comme valeur. Vide lorsqu’aucun événement personnalisé nommé n’est attribué. Les événements personnalisés déclenchés sans nom sont comptés dans custom_conversions mais omis ici, de sorte que la somme de ces valeurs est au plus égale à custom_conversions.
Valeur de conversion attribuée à chaque événement personnalisé, indexée par nom d’événement comme custom_event_counts. Additionne la valeur transmise à whop.track, normalisée en USD ; les événements déclenchés sans valeur comptent pour 0.
Heures de diffusion du groupe d’annonces chaque semaine, indexées par jour. Les jours sans diffusion sont omis.
null lorsqu’il diffuse à toute heure. Certaines plateformes exigent un budget_type lifetime pour un calendrier, sur le groupe d’annonces ou sur sa campagne lorsque c’est la campagne qui détient le budget.Propriétés
Propriétés
Plages de diffusion du groupe d’annonces le vendredi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le lundi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le samedi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le dimanche, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le jeudi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le mardi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Plages de diffusion du groupe d’annonces le mercredi, par ordre chronologique. Omis lorsqu’il ne diffuse pas ce jour-là.
Indique si les annonces de ce groupe d’annonces sont actuellement diffusées et, sinon, pourquoi. Lorsque plusieurs états s’appliquent simultanément, celui ayant la priorité la plus élevée est renvoyé.Options disponibles :
all_ads_rejected, rejected, draft, campaign_paused, paused, in_review, processing, revise_content, issues, scheduled, completed, learning, activeCiblage par âge, genre et audience automatique.
Propriétés
Propriétés
Indique si le ciblage d’audience automatique est activé. Lorsque
true, la diffusion peut aller au-delà des âges et genres que vous définissez, en les traitant comme des suggestions.Coût par résultat à viser (
average_target) ou à ne jamais dépasser (maximum_target). null pour les enchères minimum_cost.Plateformes d’appareils et systèmes d’exploitation ciblés.
Propriétés
Propriétés
Date à laquelle le groupe d’annonces cesse d’être diffusé, sous forme d’horodatage ISO 8601.
null lorsqu’il est diffusé jusqu’à sa mise en pause.Problèmes ouverts affectant ce groupe d’annonces et ses annonces. Vide lorsqu’il n’y en a aucun.
Propriétés
Propriétés
Le type de problème : une information sur la diffusion, un avertissement ou une erreur nécessitant une action.Options disponibles :
information, warning, errorL’ID de la campagne, du groupe d’annonces ou de l’annonce auquel le problème est rattaché.
Le type de ressource auquel le problème est rattaché.Options disponibles :
ad_campaign, ad_group, adTermes de recherche pour lesquels les annonces de ce groupe peuvent s’afficher, et termes pour lesquels elles ne s’affichent jamais. Campagnes de recherche uniquement, où chaque groupe d’annonces en nécessite au moins un avant le lancement.
Propriétés
Propriétés
Degré de correspondance requis pour une recherche :
broad atteint aussi les recherches associées, phrase exige le sens de l’expression, et exact exige le même sens que le terme. Valeur par défaut : broad.Options disponibles : broad, phrase, exactIndique si ce terme empêche l’affichage des annonces au lieu de les rendre éligibles. Valeur par défaut :
false.Langues ciblées, sous forme de codes ISO 639 comme
en ou es. Une locale propre à une région sans code ISO apparaît sous forme de clé de locale numérique. Une liste vide cible toutes les langues.Valeur en USD attribuée aux événements de lead. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
Progression vers le nombre de conversions requis par la phase d’apprentissage de ce groupe d’annonces. Null sauf s’il est en apprentissage ou en apprentissage limité et que des décomptes valides sont disponibles. L’atteinte du seuil ne détermine pas le statut de diffusion.
Propriétés
Propriétés
Les conversions requises par la phase d’apprentissage de ce groupe d’annonces. Ce nombre peut changer pendant la diffusion.
Conversions comptabilisées depuis la dernière modification importante pendant la phase d’apprentissage de ce groupe d’annonces.
Pages vues sur votre destination par les personnes ayant cliqué sur l’annonce, enregistrées par le pixel Whop. Comptabilisées de la même manière sur toutes les plateformes publicitaires.
Lieux ciblés et exclus.
Propriétés
Propriétés
Lieux exclus du ciblage. Les groupes de pays ne peuvent pas être exclus.
Propriétés
Propriétés
Zones circulaires, chacune définie par des coordonnées et un rayon.
Propriétés
Propriétés
Pays ISO 3166-1 alpha-2 dans lequel se trouve le point. Envoyez-le dans le cadre d’une catégorie publicitaire spéciale, où la campagne doit déclarer les pays atteints par ses ensembles de publicités.
Libellé du lieu, par exemple une ville ou une adresse. Absent lorsque le lieu n’a pas de libellé.
États américains et DC, sous forme de codes ISO 3166-2 comme
US-CA. Les territoires américains (PR, GU, VI, AS, MP) et tous les lieux hors des États-Unis sont ciblés via countries.Lieux ciblés par le groupe d’annonces.
Propriétés
Propriétés
Zones circulaires, chacune définie par des coordonnées et un rayon.
Propriétés
Propriétés
Pays ISO 3166-1 alpha-2 dans lequel se trouve le point. Envoyez-le dans le cadre d’une catégorie publicitaire spéciale, où la campagne doit déclarer les pays atteints par ses ensembles de publicités.
Libellé du lieu, par exemple une ville ou une adresse. Absent lorsque le lieu n’a pas de libellé.
États américains et DC, sous forme de codes ISO 3166-2 comme
US-CA. Les territoires américains (PR, GU, VI, AS, MP) et tous les lieux hors des États-Unis sont ciblés via countries.L’événement de conversion du pixel Whop dont le nombre attribué représente les résultats : l’objectif d’optimisation, ou l’événement attribué au volume le plus élevé pour les campagnes budgétées par groupe d’annonces. Null lorsque l’objectif n’est pas un événement attribué par Whop.Options disponibles :
purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom, messaging_conversationLe nom d’événement défini par le marchand lorsque result_event vaut custom ; null pour les événements standard.
Le nombre attribué par le pixel Whop derrière result_event. Lorsque les groupes d’annonces d’une campagne optimisent des objectifs différents, il n’y a pas de result_event unique (il vaut null), et cette valeur correspond alors à la somme des résultats attribués propres à chaque groupe d’annonces. Null lorsque rien d’attribuable par Whop n’est optimisé.
Valeur des achats divisée par les dépenses, toutes deux en USD (un ratio indépendant de la devise) ; 0 en l’absence de dépenses.
Valeur en USD attribuée aux événements de prise de rendez-vous. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
Date à laquelle le groupe d’annonces commence à être diffusé, sous forme d’horodatage ISO 8601.
null lorsqu’il démarre dès qu’il est actif.Indique si le groupe d’annonces est activé.
active et paused sont définis par vous ; rejected signifie qu’il a échoué à la vérification publicitaire ; duplicating est une copie encore en cours de remplissage.Options disponibles : active, paused, rejected, duplicatingValeur en USD attribuée aux événements de soumission de candidature. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
Personnes ayant cliqué, signalées par le pixel Whop, comptées une seule fois par personne.
Valeur en USD attribuée aux événements de consultation de contenu. Additionne la valeur envoyée avec chaque événement, normalisée en USD ; les événements sans valeur comptent pour 0.
AdGroup

