> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Ad Groups

> Un Ad Group se trouve dans une campagne publicitaire et contrôle la diffusion des annonces. Il définit l'audience, le calendrier et le budget de ses annonces.

Un Ad Group se trouve dans une [campagne publicitaire](https://docs.whop.com/fr/api-reference/ad-campaigns/ad-campaign) et contrôle la diffusion des [annonces](https://docs.whop.com/fr/api-reference/ads/ad). Il définit l'audience, le calendrier et le budget de ses annonces.

Utilisez l'API Ad Groups pour créer des groupes d'annonces dans des campagnes, lister ou récupérer les paramètres de ciblage et de diffusion, mettre à jour les budgets ou le ciblage, supprimer les groupes qui doivent cesser d'être diffusés, et mettre en pause ou reprendre la diffusion.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Ad Groups](https://docs.whop.com/fr/api-reference/ad-groups/list-ad-groups.md) | GET `/ad_groups` |
| [Retrieve an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/retrieve-an-ad-group.md) | GET `/ad_groups/{id}` |
| [Create an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/create-an-ad-group.md) | POST `/ad_groups` |
| [Duplicate an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/duplicate-an-ad-group.md) | POST `/ad_groups/{id}/duplicate` |
| [Pause an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/pause-an-ad-group.md) | POST `/ad_groups/{id}/pause` |
| [Unpause an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/unpause-an-ad-group.md) | POST `/ad_groups/{id}/unpause` |
| [Update an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/update-an-ad-group.md) | PATCH `/ad_groups/{id}` |
| [Delete an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/delete-an-ad-group.md) | DELETE `/ad_groups/{id}` |

## Restrictions de ciblage

Les groupes d'annonces ne peuvent pas cibler les [pays répertoriés dans le guide publicitaire](https://docs.whop.com/fr/developer/ads/overview.md#countries-you-cannot-target). 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é dans `regions.include.countries`.

## Attributs

**id** `string` *required*

Identifiant unique du groupe d'annonces, préfixé par `adgrp_`.

**ad\_campaign** `object` *required*

La campagne publicitaire à laquelle appartient ce groupe d'annonces.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'id de l'entité référencée.

**added\_to\_cart\_value** `number` *required*

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.

**added\_to\_carts** `number` *required*

Événements d'ajout au panier attribués par le pixel Whop, au dernier clic.

**audiences** `object` *required*

Audiences enregistrées vers lesquelles ce groupe d'annonces diffuse ou qu'il exclut.

> [accordion] Propriétés
>
> **exclude** `string[]` *required*
>
> ID des audiences enregistrées exclues de la diffusion, préfixés par `adaud_`.
>
> **include** `string[]` *required*
>
> ID des audiences enregistrées vers lesquelles le groupe d'annonces diffuse, préfixés par `adaud_`.

**bid\_type** `string | null` *required*

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_target`

**budget\_amount** `number | null` *required*

Le 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.

**budget\_amount\_local** `number | null` *required*

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.

**budget\_currency** `string` *required*

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.

**budget\_type** `string | null` *required*

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`, `lifetime`

**click\_through\_rate** `number` *required*

Clics divisés par les impressions, entre 0 et 1.

**clicks** `number` *required*

Le nombre de clics.

**completed\_registration\_value** `number` *required*

Valeur 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.

**completed\_registrations** `number` *required*

Événements d'inscription terminée attribués par le pixel Whop, au dernier clic.

**contact\_value** `number` *required*

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.

**contacts** `number` *required*

Événements de contact attribués par le pixel Whop, au dernier clic.

**conversion\_event** `string | null` *required*

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é.

**cost\_per\_added\_to\_cart** `number | null` *required*

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é.

**cost\_per\_click** `number` *required*

Dépenses divisées par les clics ; 0 en l'absence de clics.

**cost\_per\_completed\_registration** `number | null` *required*

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é.

**cost\_per\_contact** `number | null` *required*

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é.

**cost\_per\_lead** `number | null` *required*

Dépenses divisées par les leads attribués ; null lorsque les leads ne sont pas un objectif et qu'aucun n'est attribué.

**cost\_per\_mille** `number` *required*

Dépenses pour 1 000 impressions ; 0 en l'absence d'impressions.

**cost\_per\_purchase** `number | null` *required*

Dépenses divisées par les achats attribués ; null lorsque les achats ne sont pas un objectif et qu'aucun n'est attribué.

**cost\_per\_result** `number | null` *required*

Dépenses divisées par les résultats attribués par le pixel Whop ; null lorsque rien d'attribuable par Whop n'est optimisé.

**cost\_per\_schedule** `number | null` *required*

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é.

**cost\_per\_submitted\_application** `number | null` *required*

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é.

**cost\_per\_unique\_click** `number | null` *required*

Dépenses divisées par les clics uniques ; null en l'absence de clics uniques.

**cost\_per\_viewed\_content** `number | null` *required*

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é.

**created\_at** `string` *required*

Date de création du groupe d'annonces, sous forme d'horodatage ISO 8601.

**custom\_conversions** `number` *required*

É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.

**custom\_event\_counts** `object` *required*

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.

**custom\_event\_values** `object` *required*

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.

**delivery\_schedule** `object | null` *required*

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.

> [accordion] Propriétés
>
> **friday** `object[]`
>
> Plages de diffusion du groupe d'annonces le vendredi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **monday** `object[]`
>
> Plages de diffusion du groupe d'annonces le lundi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **saturday** `object[]`
>
> Plages de diffusion du groupe d'annonces le samedi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **sunday** `object[]`
>
> Plages de diffusion du groupe d'annonces le dimanche, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **thursday** `object[]`
>
> Plages de diffusion du groupe d'annonces le jeudi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **tuesday** `object[]`
>
> Plages de diffusion du groupe d'annonces le mardi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.
>
> **wednesday** `object[]`
>
> Plages de diffusion du groupe d'annonces le mercredi, par ordre chronologique. Omis lorsqu'il ne diffuse pas ce jour-là.
>
> > [accordion] Propriétés
> >
> > **end** `string` *required*
> >
> > Heure de fin de la diffusion, au format 24 heures `HH:00`, jusqu'à `24:00` pour minuit. Postérieure à `start` ; une plage dépassant minuit est répartie sur deux jours.
> >
> > **start** `string` *required*
> >
> > Heure de début de la diffusion, au format 24 heures `HH:00`, de `00:00` à `23:00`.

**delivery\_status** `string` *required*

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`, `active`

**demographics** `object` *required*

Ciblage par âge, genre et audience automatique.

> [accordion] Propriétés
>
> **automatic** `boolean` *required*
>
> 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.
>
> **gender** `string` *required*
>
> Genre ciblé.
>
> Options disponibles : `all`, `male`, `female`
>
> **maximum\_age** `number | null` *required*
>
> Âge maximum ciblé. `null` lorsqu'aucun maximum n'est défini.
>
> **minimum\_age** `number | null` *required*
>
> Âge minimum ciblé. `null` lorsqu'aucun minimum n'est défini.

**desired\_cost\_per\_result** `number | null` *required*

Coût par résultat à viser (`average_target`) ou à ne jamais dépasser (`maximum_target`). `null` pour les enchères `minimum_cost`.

**devices** `object` *required*

Plateformes d'appareils et systèmes d'exploitation ciblés.

> [accordion] Propriétés
>
> **operating\_systems** `object[]` *required*
>
> Systèmes d'exploitation ciblés. Une liste vide cible tous les systèmes d'exploitation.
>
> > [accordion] Propriétés
> >
> > **minimum\_version** `string`
> >
> > Version minimale du système d'exploitation ciblée, par exemple `18.0`. Absent lorsque toutes les versions sont éligibles.
> >
> > **os** `string` *required*
> >
> > Système d'exploitation ciblé.
> >
> > Options disponibles : `ios`, `android`
>
> **platforms** `string[]` *required*
>
> Types d'appareils ciblés. Une liste vide cible tous les appareils.
>
> Options disponibles : `mobile`, `desktop`

**ends\_at** `string | null` *required*

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.

**frequency** `number | null` *required*

Impressions divisées par la couverture.

**impressions** `number` *required*

Le nombre d'impressions.

**issues** `object[]` *required*

Problèmes ouverts affectant ce groupe d'annonces et ses annonces. Vide lorsqu'il n'y en a aucun.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> Identifiant unique du problème.
>
> **category** `string` *required*
>
> Le type de problème : une information sur la diffusion, un avertissement ou une erreur nécessitant une action.
>
> Options disponibles : `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Une description du problème et de la manière de le résoudre.
>
> **resource\_id** `string | null` *required*
>
> L'ID de la campagne, du groupe d'annonces ou de l'annonce auquel le problème est rattaché.
>
> **resource\_type** `string` *required*
>
> Le type de ressource auquel le problème est rattaché.
>
> Options disponibles : `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Un titre court du problème, destiné au créateur : la règle citée par un rejet lors de la vérification du contenu, ou un libellé générique.

**keywords** `object[]`

Termes 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.

> [accordion] Propriétés
>
> **match\_type** `string` *required*
>
> 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`, `exact`
>
> **negative** `boolean` *required*
>
> Indique si ce terme empêche l'affichage des annonces au lieu de les rendre éligibles. Valeur par défaut : `false`.
>
> **text** `string` *required*
>
> Le terme de recherche, jusqu'à 80 caractères et 10 mots.

**languages** `string[]` *required*

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.

**lead\_value** `number` *required*

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.

**leads** `number` *required*

Leads attribués par le pixel Whop, au dernier clic.

**learning\_progress** `object | null` *required*

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.

> [accordion] Propriétés
>
> **conversion\_threshold** `integer` *required*
>
> Les conversions requises par la phase d'apprentissage de ce groupe d'annonces. Ce nombre peut changer pendant la diffusion.
>
> **conversions** `integer` *required*
>
> Conversions comptabilisées depuis la dernière modification importante pendant la phase d'apprentissage de ce groupe d'annonces.
>
> **progress\_percent** `number` *required*
>
> Conversions divisées par le seuil, sous forme de pourcentage borné entre 0 et 100. Le `delivery_status` du groupe d'annonces reste la référence.

**link\_clicks** `number` *required*

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.

**purchase\_value** `number` *required*

Valeur en USD des achats attribués par le pixel.

**purchases** `number` *required*

Achats attribués par le pixel Whop, au dernier clic.

**reach** `number` *required*

Le nombre de personnes uniques ayant vu ceci.

**regions** `object` *required*

Lieux ciblés et exclus.

> [accordion] Propriétés
>
> **exclude** `object` *required*
>
> Lieux exclus du ciblage. Les groupes de pays ne peuvent pas être exclus.
>
> > [accordion] Propriétés
> >
> > **cities** `object[]` *required*
> >
> > Villes, indexées selon la taxonomie des lieux.
> >
> > > [accordion] Propriétés
> > >
> > > **key** `string` *required*
> > >
> > > La clé de la ville dans la taxonomie des lieux.
> > >
> > > **name** `string`
> > >
> > > Nom de la ville, par exemple `Austin`. Absent lorsque la taxonomie des lieux n'en contient pas.
> >
> > **countries** `string[]` *required*
> >
> > Pays, sous forme de codes ISO 3166-1 alpha-2 comme `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Groupes multi-pays comme `worldwide` ou `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Zones circulaires, chacune définie par des coordonnées et un rayon.
> >
> > > [accordion] Propriétés
> > >
> > > **country\_code** `string`
> > >
> > > 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.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Unité de `radius`.
> > >
> > > Options disponibles : `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Latitude du point central.
> > >
> > > **longitude** `number` *required*
> > >
> > > Longitude du point central.
> > >
> > > **name** `string`
> > >
> > > Libellé du lieu, par exemple une ville ou une adresse. Absent lorsque le lieu n'a pas de libellé.
> > >
> > > **radius** `number` *required*
> > >
> > > Rayon autour du point central, en `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > É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`.
> >
> > **zips** `string[]` *required*
> >
> > Codes ZIP et codes postaux, indexés sous la forme `COUNTRY:CODE`, par exemple `US:78756`.
>
> **include** `object` *required*
>
> Lieux ciblés par le groupe d'annonces.
>
> > [accordion] Propriétés
> >
> > **cities** `object[]` *required*
> >
> > Villes, indexées selon la taxonomie des lieux.
> >
> > > [accordion] Propriétés
> > >
> > > **key** `string` *required*
> > >
> > > La clé de la ville dans la taxonomie des lieux.
> > >
> > > **name** `string`
> > >
> > > Nom de la ville, par exemple `Austin`. Absent lorsque la taxonomie des lieux n'en contient pas.
> >
> > **countries** `string[]` *required*
> >
> > Pays, sous forme de codes ISO 3166-1 alpha-2 comme `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Groupes multi-pays comme `worldwide` ou `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Zones circulaires, chacune définie par des coordonnées et un rayon.
> >
> > > [accordion] Propriétés
> > >
> > > **country\_code** `string`
> > >
> > > 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.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Unité de `radius`.
> > >
> > > Options disponibles : `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Latitude du point central.
> > >
> > > **longitude** `number` *required*
> > >
> > > Longitude du point central.
> > >
> > > **name** `string`
> > >
> > > Libellé du lieu, par exemple une ville ou une adresse. Absent lorsque le lieu n'a pas de libellé.
> > >
> > > **radius** `number` *required*
> > >
> > > Rayon autour du point central, en `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > É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`.
> >
> > **zips** `string[]` *required*
> >
> > Codes ZIP et codes postaux, indexés sous la forme `COUNTRY:CODE`, par exemple `US:78756`.

**result\_event** `string | null` *required*

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_conversation`

**result\_event\_name** `string | null` *required*

Le nom d'événement défini par le marchand lorsque result\_event vaut custom ; null pour les événements standard.

**results** `number | null` *required*

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é.

**return\_on\_ad\_spend** `number` *required*

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.

**schedule\_value** `number` *required*

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.

**schedules** `number` *required*

Événements de prise de rendez-vous attribués par le pixel Whop, au dernier clic.

**spend** `number` *required*

Le montant facturé, en spend\_currency.

**spend\_currency** `string | null` *required*

Le code de devise ISO 4217 de toutes les métriques monétaires.

**starts\_at** `string | null` *required*

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.

**status** `string` *required*

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`, `duplicating`

**submitted\_application\_value** `number` *required*

Valeur 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.

**submitted\_applications** `number` *required*

Événements de soumission de candidature attribués par le pixel Whop, au dernier clic.

**title** `string | null` *required*

Nom d'affichage du groupe d'annonces.

**unique\_click\_through\_rate** `number | null` *required*

Clics uniques divisés par les impressions, entre 0 et 1.

**unique\_clicks** `number` *required*

Personnes ayant cliqué, signalées par le pixel Whop, comptées une seule fois par personne.

**updated\_at** `string` *required*

Date de dernière mise à jour du groupe d'annonces, sous forme d'horodatage ISO 8601.

**viewed\_content\_value** `number` *required*

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.

**viewed\_contents** `number` *required*

Événements de consultation de contenu attribués par le pixel Whop, au dernier clic.

```json AdGroup theme={null}
{
	"id": "adgrp_xxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"added_to_cart_value": 1050,
	"added_to_carts": 24,
	"audiences": {
		"exclude": [],
		"include": ["adaud_xxxxxxxxxxx"]
	},
	"bid_type": "minimum_cost",
	"budget_amount": 100,
	"budget_amount_local": 100,
	"budget_currency": "usd",
	"budget_type": "daily",
	"click_through_rate": 0.036,
	"clicks": 720,
	"completed_registration_value": 0,
	"completed_registrations": 16,
	"contact_value": 0,
	"contacts": 10,
	"conversion_event": "purchase",
	"cost_per_added_to_cart": 8.33,
	"cost_per_click": 0.28,
	"cost_per_completed_registration": 12.5,
	"cost_per_contact": 20,
	"cost_per_lead": 13.33,
	"cost_per_mille": 10,
	"cost_per_purchase": 25,
	"cost_per_result": 25,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.33,
	"cost_per_viewed_content": 0.67,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 5,
	"custom_event_counts": {
		"QualifiedCall": 4,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 2000,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"learning_progress": null,
	"demographics": {
		"automatic": false,
		"minimum_age": 21,
		"maximum_age": 45,
		"gender": "all"
	},
	"delivery_schedule": {
		"monday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"tuesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"wednesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"thursday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"friday": [
			{
				"start": "09:00",
				"end": "12:00"
			},
			{
				"start": "16:00",
				"end": "20:00"
			}
		],
		"saturday": [
			{
				"start": "10:00",
				"end": "14:00"
			}
		],
		"sunday": [
			{
				"start": "12:00",
				"end": "16:00"
			}
		]
	},
	"desired_cost_per_result": 30,
	"devices": {
		"platforms": ["mobile", "desktop"],
		"operating_systems": [
			{
				"os": "ios",
				"minimum_version": "18.0"
			}
		]
	},
	"ends_at": "2026-07-01T12:00:00Z",
	"frequency": 1.6,
	"impressions": 20000,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The audience is too narrow to deliver. Broaden the targeting to reach more people.",
			"resource_id": "adgrp_xxxxxxxxxxx",
			"resource_type": "ad_group"
		}
	],
	"languages": ["en"],
	"lead_value": 750,
	"leads": 15,
	"link_clicks": 576,
	"purchase_value": 5200,
	"purchases": 8,
	"reach": 12500,
	"regions": {
		"include": {
			"countries": ["US"],
			"country_groups": [],
			"regions": ["US-CA"],
			"cities": [
				{
					"key": "2418779",
					"name": "Miami"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 30.2672,
					"longitude": -97.7431,
					"radius": 10,
					"distance_unit": "mile",
					"name": "Austin, TX"
				}
			]
		},
		"exclude": {
			"countries": [],
			"country_groups": [],
			"regions": [],
			"cities": [
				{
					"key": "2421215",
					"name": "Anchorage"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 40.758,
					"longitude": -73.9855,
					"radius": 2,
					"distance_unit": "mile",
					"name": "Times Square"
				}
			]
		}
	},
	"result_event": "purchase",
	"result_event_name": null,
	"results": 8,
	"return_on_ad_spend": 26,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 200,
	"spend_currency": "usd",
	"starts_at": "2026-06-01T12:00:00Z",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "US founders",
	"unique_click_through_rate": 0.03,
	"unique_clicks": 600,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 300
}
```


## Related topics

- [Delete an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/delete-an-ad-group.md)
- [Create an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/create-an-ad-group.md)
- [Duplicate an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/duplicate-an-ad-group.md)
