OpenAI Conversions API

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

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 couvre les événements OpenAI, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

• Correspondances préconstruites: la mise en correspondance des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

• Hachage automatique: les informations sont automatiquement hachées conformément aux spécifications du partenaire.

• Correspondance intelligente: la mise en correspondance des données peut être réajustée à l'aide des champs définis dans votre datalayer.

• Mappage des événements: modifiez la correspondance 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 dans 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 Mappage des champs) et le Pixel ID (Voir Configuration).

Configuration

Paramètres	Description
clé API	Requis Votre clé API. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.
Pixel ID	Requis Votre identifiant de pixel. Vous pouvez contacter l'équipe de compte OpenAI pour obtenir cette valeur.
Mappage des événements	Modifiez la correspondance 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

Commanders Act Events	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.

Mappage des champs

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

Champs de correspondance intelligente	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 de l'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]
Adresse IP de l'appareil	context.device.ip	ip_address [6]
Agent utilisateur de l'appareil	context.device.user_agent	user_agent [6]
Opt-out	partners.openai.opt_out	opt_out
Valeur	value	amount [8]
Devise	currency	currency
Identifiant du plan	partners.openai.plan_id	plan_id [9]
Liste des éléments	items	contents [10]
ID de l'élément	items.X.id	contents.X.id [10]
Nom de l'élément	items.X.product.name	contents.X.name [10]
Type de contenu de l'élément Type de contenu	items.X.content_type content_type	contents.X.content_type [10][11]
Prix de l'élément	items.X.product.price	contents.X.amount [10]
Quantité de l'élément	items.X.quantity	contents.X.quantity [10]
Devise de l'élément	items.X.currency	contents.X.currency [10][12]

* Propriété obligatoire. 1. Voir Référence rapide pour plus de détails. 2. Si elle n'est pas transmise, l'horodatage actuel est utilisé. 3. Définir si type est custom . Valeur par défaut : valeur dans event_name . 4. Valeurs acceptées : web , mobile_app , offline , physical_store , phone_call et email . Valeur 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 texte clair. 8. 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. Défini dans data lorsque data.type n'est pas customer_action . 11. Priorité à gauche. Valeur par défaut : product . 12. Requis si amount est défini et currency (niveau supérieur) n'est pas défini.