> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/fr/api-de-placement-des-annonces/ad-plac-request.md). # Requête L’API de placement des publicités peut être appelée depuis l’un ou l’autre **client** côté ou **serveur** côté. Lors de l’utilisation **client** de l’implémentation côté, le navigateur peut effectuer une **requête de pré-vérification** . Si vous souhaitez éviter cela, dans l’en-tête de la requête, utilisez `Content-Type: text/plain`. Cela garantira que le navigateur considère la requête comme « simple » et ignore donc la requête de pré-vérification. Aussi, lors de l’appel de l’API côté **client** côté, **les adresses IP ne sont en réalité pas requises** car il peut être difficile de détecter l’IP à l’aide du front-end et de JavaScript. À la place, notre API détecte l’IP à partir de la connexion lorsque la requête est effectuée. Lors de l’utilisation **serveur** de l’implémentation côté, afin d’assurer un ciblage correct, **l’adresse IP correcte de l’utilisateur doit être transmise explicitement**. Sinon, les publicités seront ciblées en fonction de l’emplacement du serveur, et cela peut entraîner l’invalidation des impressions plus tard en raison d’une incompatibilité d’IP. Que le client ou le serveur soit utilisé, si une IP est transmise, elle sera prioritaire sur celle que nous détectons. Pour effectuer une requête à l’API de placement des publicités, vous devez transmettre deux objets : **utilisateur** et **zones**. La requête est effectuée en JSON à l’aide de HTTP POST. ## utilisateur | Paramètre | Requis ? | Description | | ------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Non | L’identifiant de l’utilisateur | | ip | Recommandé | L’adresse IP de l’utilisateur. | | ua | Oui | Agent utilisateur : une chaîne contenant le navigateur/l’application et l’appareil/le système d’exploitation de l’utilisateur. | | langue | Non | Définit la langue de la requête en utilisant le [code ISO standard à deux caractères](https://www.andiamo.co.uk/resources/iso-language-codes/) plus un code de région optionnel à 2 caractères. p. ex. `en-us` pour l’anglais des États-Unis. | | referer | Non | L’adresse du site où la publicité sera affichée. | | el | Non | L’adresse e-mail de l’utilisateur encodée en Base64. | | résolution de l’écran | Non | Résolution de l’écran de l’appareil utilisé par l’utilisateur | | orientation de la fenêtre | Non | Cela devrait être "portrait" si le site a une mise en page mobile et "landscape" s’il s’agit d’une version desktop. | | gdpr | Non | Extensions recommandées pour la confidentialité (objet). | ### user.gdpr | Paramètre | Description | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | Cela devrait être **0** si l’appelant estime que l’utilisateur n’est pas soumis au RGPD, et **1** si l’utilisateur est soumis au RGPD. | | consentement | Il s’agit de la chaîne de consentement requise par les normes IAB. | ## zones | Paramètre | Requis ? | Description | | -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Oui | L’identifiant de la zone publicitaire | | sub | Non | Le sous-identifiant de la zone publicitaire | | mots-clés | Non | Tout [mots-clés](/advertisers/campaigns/creating-a-campaign/create-campaign-step3.md#keywords) associés au trafic susceptibles de correspondre à un type spécifique de publicité. S’il n’y a aucun mot-clé, l’URL du site sera utilisée pour la mise en correspondance | | ciblage personnalisé | Non | Valeurs personnalisées de la zone (objet) | ### zones.custom\_targeting | Paramètre | Description | | --------- | ----------------------------------------------------------------------------------------------------- | | ex\_av | Cela devrait être **0** si non défini, **1** si l’âge est vérifié et **2** si l’âge n’est pas vérifié | ## Exemple Il est possible de demander plusieurs zones publicitaires dans une seule requête. Chaque zone aura un ID différent, comme vous pouvez le voir dans l’exemple ci-dessous. ```json { "user": { "id": "abdef8u9", "ip": "10.42.0.1", "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36", "language": "en-US", "referer": "https://blabla.com", "gdpr": { "gdpr": 1, "consent": "CPAoZRHPArq3hBcADBENBJCgAAAAAAAAAAqIHKQAAOUgAAAA" } }, "zones": [ { "id": 4031007, "sub": 111, "keywords": "humour, general" }, { "id": 4031015, "sub": 222 }, { "id": 4031019, "sub": 222 } ] } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/api/fr/api-de-placement-des-annonces/ad-plac-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.