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
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
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é.
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.
Mis à jour
Ce contenu vous a-t-il été utile ?