OpenAI Conversions API

Cette destination est actuellement en cours de validation finale et sera bientôt disponible.

OpenAI est une organisation de recherche en intelligence artificielle. En utilisant cette destination, vous pouvez tirer parti de OpenAI Conversions API pour envoyer directement des événements de conversion à OpenAI pour l'attribution et le reporting en aval.

À l'heure actuelle, OpenAI/ChatGPT Ads en est à un stade précoce, et sa disponibilité pour les entreprises est limitée. De plus, l'Union européenne n'est pas encore autorisée à exploiter OpenAI Ads.

Fonctionnalités clés

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

• Structure des événements: notre Référence des événements modèle couvre les événements OpenAI, 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 automatiquement hachées conformément aux spécifications du partenaire.

• Mappage intelligent: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.

• Mappage des événements: modifier le mappage standard entre les événements OpenAI et les vôtres.

• Prise en charge des données multi-item: les informations incluses dans le item array sont envoyées à OpenAI.

• Prise en charge du mode batch: envoyez plusieurs événements en une seule requête.

Configuration de la destination

Assurez-vous d'avoir accès à OpenAI Ads.

La déduplication des événements est effectuée à l'aide de ID et type (voir Mappages des champs) et le Pixel ID (voir Configuration).

Configuration

Paramètres	Description
API Key	Obligatoire Votre clé API. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.
Pixel ID	Obligatoire Votre identifiant Pixel. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.
Mappage des événements	Modifiez le mappage standard entre les types d'événements OpenAI et vos événements. Valeurs acceptées pour type d'événement OpenAI : appointment_scheduled , checkout_started , contents_viewed , custom , items_added , lead_created , order_created , page_viewed , registration_completed , subscription_created et trial_started .

Référence rapide

Événements Commanders Act	Types d'événements OpenAI
appointment_scheduled	appointment_scheduled
checkout_started begin_checkout	checkout_started
contents_viewed	contents_viewed
custom	custom
items_added	items_added
lead_created generate_lead	lead_created
order_created purchase	order_created
page_view page_viewed	page_viewed
registration_completed sign_up	registration_completed
subscription_created	subscription_created
trial_started	trial_started
[Tout événement]	[Tout type d'événement OpenAI] [1]

1. Voir Mappage des événements dans Configuration.

Mappages des champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping fonctionnalité.

Champs Smart Mapping	Propriétés par défaut de Commanders Act	Propriétés OpenAI
ID de l'événement	context.event_id	ID [*]
-	(event_name)	type [1]
Horodatage de l'événement	context.event_timestamp	timestamp_ms [2]
Nom d'événement personnalisé	partners.openai.custom_event_name event_name	custom_event_name [3]
Identifiant de confidentialité OpenAI	partners.openai.oppref	oppref
Source d'action	type	action_source [4]
URL de la page	context.page.url	source_url [5]
E-mail de l'utilisateur	user.email	email_sha256 [6][7]
Téléphone de l'utilisateur	user.phone	phone_number_sha256 [6][7]
ID utilisateur	user.id	external_id_sha256 [6][7] external_id [6]
Pays de l'utilisateur	user.country	country_sha256 [6][7]
Ville de l'utilisateur	user.city	city_sha256 [6][7]
Code postal de l'utilisateur	user.zipcode	zip_code_sha256 [6]
IP de l'appareil	context.device.ip	ip_address [6]
User Agent de l'appareil	context.device.user_agent	user_agent [6]
Opt-out	partners.openai.opt_out	opt_out
-	(event_name)	type [8]
Valeur	value	amount [8]
Devise	currency	currency [8]
Identifiant du plan	partners.openai.plan_id	plan_id [8][9]
Liste d'items	items	contents [8]
ID de l'item	items.X.id	contents.X.id [8]
Nom de l'item	items.X.product.name	contents.X.name [8]
Type de contenu de l'item Type de contenu	items.X.content_type content_type	contents.X.content_type [8][10]
Prix de l'item	items.X.product.price	contents.X.amount [8]
Quantité de l'item	items.X.quantity	contents.X.quantity [8]
Devise de l'item	items.X.currency	contents.X.currency [8][11]

* Propriété obligatoire. 1. Voir Référence rapide pour plus de détails. 2. S'il n'est pas transmis, l'horodatage actuel est utilisé. 3. À définir si type est custom . Par défaut : valeur dans event_name . 4. Valeurs acceptées : web , mobile_app , offline , physical_store , phone_call et email . Par défaut : valeur dans type . 5. Requis si action_source est web . 6. Défini dans user . 7. Normalisé et haché automatiquement s'il est transmis en clair. 8. Défini dans données lorsque data.type est customer_action . La valeur est automatiquement multipliée par 100 et arrondie à l'entier le plus proche. 9. À définir si data.type est custom ou plan_enrollment . 10. Priorité à gauche. Valeur par défaut : produit . 11. Requis si amount est défini et currency (niveau supérieur) n'est pas défini.