> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/openai-conversions-api.md).

# OpenAI Conversions API

{% hint style="info" %}
Cette destination est actuellement en phase de revue finale et sera bientôt disponible.
{% endhint %}

[OpenAI](https://openai.com/) est une organisation de recherche en intelligence artificielle. En utilisant cette destination, vous pouvez exploiter [OpenAI Conversions API](https://developers.openai.com/ads/conversions-api) pour envoyer des événements de conversion directement à OpenAI pour l'attribution et le reporting en aval.

{% hint style="warning" %}
À l'heure actuelle, [OpenAI/ChatGPT Ads](https://ads.openai.com/) en est à un stade précoce, et la disponibilité pour les entreprises est limitée.\
De plus, l'Union européenne n'est pas encore autorisée à exploiter OpenAI Ads.
{% endhint %}

## Fonctionnalités clés

La destination OpenAI Conversions API offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) Le modèle couvre [événements OpenAI](https://developers.openai.com/ads/supported-events), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Mappage d'événements**: modifiez le mappage standard entre les événements OpenAI et les vôtres.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) le tableau est envoyé à OpenAI.
* **Prise en charge du mode batch**: envoyez plusieurs événements dans une seule requête.

## Configuration de la destination

Assurez-vous d'avoir accès à [OpenAI Ads](https://ads.openai.com/).

{% hint style="info" %}
La déduplication des événements est effectuée à l'aide de <mark style="color:bleu;">`id`</mark> et <mark style="color:bleu;">`type`</mark> (voir [Correspondances des champs](#field-mappings)) et le <mark style="color:bleu;">`Pixel ID`</mark> (voir [Configuration](#configuration)).
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>API Key</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé API. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.</td></tr><tr><td><code>Pixel ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant de pixel. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez le mappage standard entre les types d'événements OpenAI et vos événements. Valeurs acceptées pour <code>type d'événement OpenAI</code> : <code>appointment_scheduled</code> , <code>checkout_started</code> , <code>contents_viewed</code> , <code>personnalisé</code> , <code>items_added</code> , <code>lead_created</code> , <code>order_created</code> , <code>page_viewed</code> , <code>registration_completed</code> , <code>subscription_created</code> et <code>trial_started</code> .</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events                                                 | Types d'événements OpenAI                 |
| --------------------------------------------------------------------- | ----------------------------------------- |
| `appointment_scheduled`                                               | `appointment_scheduled`                   |
| <p><code>checkout\_started</code><br><code>begin\_checkout</code></p> | `checkout_started`                        |
| `contents_viewed`                                                     | `contents_viewed`                         |
| `personnalisé`                                                        | `personnalisé`                            |
| `items_added`                                                         | `items_added`                             |
| <p><code>lead\_created</code><br><code>generate\_lead</code></p>      | `lead_created`                            |
| <p><code>order\_created</code><br><code>purchase</code></p>           | `order_created`                           |
| <p><code>page\_view</code><br><code>page\_viewed</code></p>           | `page_viewed`                             |
| <p><code>registration\_completed</code><br><code>sign\_up</code></p>  | `registration_completed`                  |
| `subscription_created`                                                | `subscription_created`                    |
| `trial_started`                                                       | `trial_started`                           |
| `[Tout événement]`                                                    | `[Tout type d'événement OpenAI]` **\[1]** |

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Correspondance des événements`</mark> dans [Configuration](#configuration).
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="246">Champs Smart Mapping</th><th width="323.6685580062746">Propriétés par défaut de Commanders Act</th><th width="330.3314419937253">Propriétés OpenAI</th></tr></thead><tbody><tr><td><code>ID de l'événement</code></td><td><code>context.event_id</code></td><td><code>id</code> <strong>[*]</strong></td></tr><tr><td>-</td><td><code>(event_name)</code></td><td><code>type</code> <strong>[1]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>timestamp_ms</code> <strong>[2]</strong></td></tr><tr><td><code>Nom de l'événement personnalisé</code></td><td><p><code>partners.openai.custom_event_name</code></p><p><code>event_name</code></p></td><td><code>custom_event_name</code> <strong>[3]</strong></td></tr><tr><td><code>Identifiant de confidentialité OpenAI</code></td><td><code>partners.openai.oppref</code></td><td><code>oppref</code></td></tr><tr><td><code>Source de l'action</code></td><td><code>type</code></td><td><code>action_source</code> <strong>[4]</strong></td></tr><tr><td><code>URL de la page</code></td><td><code>context.page.url</code></td><td><code>source_url</code> <strong>[5]</strong></td></tr><tr><td><code>e-mail utilisateur</code></td><td><code>user.email</code></td><td><code>email_sha256</code> <strong>[6][7]</strong></td></tr><tr><td><code>Téléphone de l'utilisateur</code></td><td><code>user.phone</code></td><td><code>phone_number_sha256</code> <strong>[6][7]</strong></td></tr><tr><td><code>ID utilisateur</code></td><td><code>user.id</code></td><td><code>external_id_sha256</code> <strong>[6][7]</strong><br><code>external_id</code> <strong>[6]</strong></td></tr><tr><td><code>Pays de l'utilisateur</code></td><td><code>user.country</code></td><td><code>country_sha256</code> <strong>[6][7]</strong></td></tr><tr><td><code>Ville de l'utilisateur</code></td><td><code>user.city</code></td><td><code>city_sha256</code> <strong>[6][7]</strong></td></tr><tr><td><code>Code postal de l'utilisateur</code></td><td><code>user.zipcode</code></td><td><code>zip_code_sha256</code> <strong>[6]</strong></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[6]</strong></td></tr><tr><td><code>Agent utilisateur de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code> <strong>[6]</strong></td></tr><tr><td><code>Opt-out</code></td><td><code>partners.openai.opt_out</code></td><td><code>opt_out</code></td></tr><tr><td>-</td><td><code>(event_name)</code></td><td><code>type</code> <strong>[8]</strong></td></tr><tr><td><code>Valeur</code></td><td><code>valeur</code></td><td><code>montant</code> <strong>[8]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[8]</strong></td></tr><tr><td><code>Identifiant du plan</code></td><td><code>partners.openai.plan_id</code></td><td><code>plan_id</code> <strong>[8][9]</strong></td></tr><tr><td><code>Liste des articles</code></td><td><code>items</code></td><td><code>contents</code> <strong>[8]</strong></td></tr><tr><td><code>ID de l'item</code></td><td><code>items.X.id</code></td><td><code>contents.X.id</code> <strong>[8]</strong></td></tr><tr><td><code>Nom de l'item</code></td><td><code>items.X.product.name</code></td><td><code>contents.X.name</code> <strong>[8]</strong></td></tr><tr><td><code>Type de contenu de l'élément</code><br><code>Type de contenu</code></td><td><code>items.X.content_type</code><br><code>content_type</code></td><td><code>contents.X.content_type</code> <strong>[8][10]</strong></td></tr><tr><td><code>Prix de l'article</code></td><td><code>items.X.product.price</code></td><td><code>contents.X.amount</code> <strong>[8]</strong></td></tr><tr><td><code>Quantité de l'élément</code></td><td><code>items.X.quantity</code></td><td><code>contents.X.quantity</code> <strong>[8]</strong></td></tr><tr><td><code>Devise de l'élément</code></td><td><code>items.X.currency</code></td><td><code>contents.X.currency</code> <strong>[8][11]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Voir [Référence rapide](#quick-reference) pour plus de détails.\
**2.** S'il n'est pas transmis, l'horodatage actuel est utilisé.\
**3.** Définir si <mark style="color:bleu;">`type`</mark> est <mark style="color:bleu;">`personnalisé`</mark> . Par défaut : valeur dans <mark style="color:bleu;">`event_name`</mark> .\
**4.** Valeurs acceptées : <mark style="color:bleu;">`web`</mark> , <mark style="color:bleu;">`mobile_app`</mark> , <mark style="color:bleu;">`offline`</mark> , <mark style="color:bleu;">`physical_store`</mark> , <mark style="color:bleu;">`phone_call`</mark> et <mark style="color:bleu;">`email`</mark> . Par défaut : valeur dans <mark style="color:bleu;">`type`</mark> .\
**5.** Requis si <mark style="color:bleu;">`action_source`</mark> est <mark style="color:bleu;">`web`</mark> .\
**6.** Défini dans <mark style="color:bleu;">`user`</mark> .\
**7.** Normalisé et haché automatiquement s'il est transmis en texte brut.\
**8.** Défini dans <mark style="color:bleu;">`data`</mark> quand <mark style="color:bleu;">`data.type`</mark> est <mark style="color:bleu;">`customer_action`</mark> . La valeur est automatiquement multipliée par 100 et arrondie à l'entier le plus proche.\
**9.** Définir si <mark style="color:bleu;">`data.type`</mark> est <mark style="color:bleu;">`personnalisé`</mark> ou <mark style="color:bleu;">`plan_enrollment`</mark> .\
**10.** Priorité à gauche. Valeur par défaut : <mark style="color:bleu;background-color:blue;">`product`</mark> .\
**11.** Requis si <mark style="color:bleu;">`montant`</mark> est défini et <mark style="color:bleu;">`currency`</mark> (niveau supérieur) n'est pas défini.
{% endhint %}


---

# 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://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/openai-conversions-api.md?ask=<question>&goal=<endgoal>
```

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