Outils ChatGPT Ads
Comptes publicitaires ChatGPT connectés via l'OpenAI Ads API : liste des campagnes, rapport de performances, modifications de budget et d'état.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture11 outils
list_openai_ads_accounts
Lecture1 créditsComptes ChatGPT Ads (OpenAI Ads) connectés : ad_account_id, nom, devise, fuseau horaire, statut du compte et de la revue. Chaque compte est connecté dans le panneau avec sa propre clé Ads API. Lecture seule ; connected=false s'il n'y en a aucun.
Cet outil ne prend aucun paramètre.
list_openai_ads_campaigns
Lecture1 créditsCampagnes ChatGPT Ads issues de l'OpenAI Ads API : id (cmpn_…), nom, statut, budget quotidien ou total (devise du compte), type d'enchère, calendrier. Lecture seule ; renvoie connected=false si aucun compte n'est lié.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
statusFacultatif | active | paused | archived | — |
nameFacultatif | string | filtrer par nom de campagne (3 caractères min.) |
openai_ads_performance_report
Lecture2 créditsRapport de diffusion ChatGPT Ads (OpenAI Ads insights) : impressions, clics, dépenses, CTR, CPC, CPM par compte, campagne, groupe d'annonces ou annonce sur une plage de dates dans le fuseau du compte, éventuellement par jour. Lecture seule ; n'invente jamais de chiffres.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
levelFacultatif | ad_account | campaign | ad_group | ad | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
dailyFacultatif | boolean | — |
campaign_idsFacultatif | array<string> | — |
chatgpt_ads_details
Lecture1 créditsTous les détails d'une campagne ChatGPT Ads (avec ses groupes d'annonces), d'un groupe d'annonces (enchères, indices de contexte, annonces) ou d'une annonce (création, examen), y compris les problèmes de diffusion signalés par OpenAI. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
idObligatoire | string | cmpn_…, adgrp_… ou ad_… |
hints_limitFacultatif | integer (1–2000) | — |
hints_offsetFacultatif | integer (0–…) | — |
chatgpt_ads_geo_lookup
Lecture1 créditsRecherche par nom les id de lieux ChatGPT Ads (pays, régions, marchés, codes postaux) pour le ciblage géographique des campagnes. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
queryObligatoire | string | — |
limitFacultatif | integer (1–100) | — |
chatgpt_ads_insights
Lecture2 créditsRapport de diffusion ChatGPT Ads avec les options d'OpenAI : tranches horaires/quotidiennes/mensuelles, ventilations par pays/appareil/plateforme/produit, lignes sans impression et métriques de conversion, pour le compte ou une campagne, un groupe d'annonces ou une annonce. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
scope_idFacultatif | string | id cmpn_/adgrp_/ad_ facultatif pour restreindre le rapport |
levelFacultatif | ad_account | campaign | ad_group | ad | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
granularityFacultatif | none | hourly | daily | monthly | — |
segmentFacultatif | none | country | device | platform | product | — |
include_zeroFacultatif | boolean | ajoute les lignes sans impression (sans segment) |
conversionsFacultatif | boolean | ajoute conversions, CPA, CVR, ventes attribuées et ROAS |
limitFacultatif | integer (1–2000) | — |
offsetFacultatif | integer (0–…) | — |
chatgpt_ads_spend_limits
Lecture1 créditsPlafonds de dépenses du compte ChatGPT Ads : fenêtres par plage de dates et plafonds quotidiens récurrents, avec les dépenses à ce jour et ce qui peut être modifié. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
chatgpt_ads_conversion_setup
Lecture1 créditsSuivi des conversions ChatGPT Ads : pixels (sources), paramètres des événements de conversion et campagnes qui les utilisent, ainsi que les événements reçus pendant environ les 15 dernières minutes. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
check_recent_eventsFacultatif | boolean | — |
chatgpt_ads_ad_preview
Lecture1 créditsAffiche le rendu d'une annonce ChatGPT Ads existante (aperçu temporaire de 24 heures) avec son statut d'examen et les blocages de diffusion signalés par OpenAI. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
ad_idObligatoire | string | — |
list_chatgpt_ads_custom_audiences
Lecture1 créditsListe les audiences personnalisées ChatGPT Ads du compte : ID, nom, statut et révision. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
diagnose_chatgpt_ads_delivery
Lecture2 créditsExplique pourquoi les annonces ChatGPT Ads n'obtiennent pas d'impressions : vérifie le statut du compte et les examens, les plafonds de dépenses et chaque campagne, groupe d'annonces et annonce à la recherche de problèmes de diffusion OpenAI (éventuellement avec exploration des pages de destination), et renvoie des constats classés avec preuve, correctif et outil qui l'applique. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
campaign_idFacultatif | string | — |
check_landing_pagesFacultatif | boolean | — |
Outils d'écriture14 outils
update_openai_ads_campaign_status
Écriture2 créditsMet en pause ou active une campagne ChatGPT Ads. Renvoie un aperçu et un élément de validation ; appliqué chez OpenAI uniquement après validation, et annulable. L'activation ne lance la diffusion que si les autres exigences d'OpenAI (revues, budget) sont remplies.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
campaign_idObligatoire | string | cmpn_… |
statusObligatoire | pause | activate | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_openai_ads_campaign_budget
Écriture2 créditsDéfinit le budget quotidien d'une campagne ChatGPT Ads. Passe par l'aperçu et la validation ; les hausses de plus de 50 % par modification ou 2× en 24 heures sont bloquées ; l'annulation restaure le budget précédent. Les campagnes à budget total ne sont pas modifiées.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
campaign_idObligatoire | string | cmpn_… |
daily_budgetObligatoire | number | nouveau budget quotidien dans la devise du compte (pas en micros) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
connect_chatgpt_ads
Écriture0 créditsConnecte un compte publicitaire ChatGPT Ads (OpenAI Ads) : sans clé, explique la marche à suivre dans le panneau ; avec api_key et confirm=true, la clé est vérifiée auprès d'OpenAI et stockée chiffrée (propriétaire/administrateur uniquement). La clé n'est jamais réaffichée.
| Paramètre | Type | Description |
|---|---|---|
api_keyFacultatif | string | clé API OpenAI Ads d'un compte publicitaire |
confirmFacultatif | boolean | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_chatgpt_ads_accounts
Écriture0 créditsListe les comptes ChatGPT Ads connectés, revérifie l'un d'eux auprès d'OpenAI (statut, examen, devise), le déconnecte ou en fait le compte par défaut utilisé lorsque ad_account_id est omis. La déconnexion et le choix par défaut nécessitent confirm=true.
| Paramètre | Type | Description |
|---|---|---|
actionFacultatif | list | recheck | disconnect | set_default | — |
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
confirmFacultatif | boolean | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_chatgpt_ads_campaign
Écriture8 créditsCrée une campagne ChatGPT Ads (toujours en pause) avec un budget quotidien ou global dans la devise du compte, un objectif, des lieux, des plateformes, des audiences, un calendrier et un objectif de conversion. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
nameObligatoire | string | — |
daily_budgetFacultatif | number | — |
lifetime_budgetFacultatif | number | — |
objectiveFacultatif | impressions | clicks | conversions | — |
descriptionFacultatif | string | — |
include_locationsFacultatif | array<string> | id de lieux issus de chatgpt_ads_geo_lookup |
exclude_locationsFacultatif | array<string> | id de lieux issus de chatgpt_ads_geo_lookup |
platformsFacultatif | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
custom_audience_idsFacultatif | array<string> | — |
excluded_custom_audience_idsFacultatif | array<string> | — |
startFacultatif | string | date-heure ISO 8601 (UTC sans décalage) |
endFacultatif | string | date-heure ISO 8601 (UTC sans décalage) |
conversion_event_setting_idsFacultatif | array<string> | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_chatgpt_ads_campaign
Écriture5 créditsModifie une campagne ChatGPT Ads : nom, budget, lieux (remplacer / ajouter / retirer), plateformes, calendrier, événements de conversion ou statut. Les hausses de budget de plus de 50 % sont bloquées. Aperçu et approbation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
campaign_idObligatoire | string | — |
nameFacultatif | string | — |
daily_budgetFacultatif | number | — |
lifetime_budgetFacultatif | number | — |
statusFacultatif | active | paused | — |
include_locationsFacultatif | array<string> | id de lieux issus de chatgpt_ads_geo_lookup |
exclude_locationsFacultatif | array<string> | id de lieux issus de chatgpt_ads_geo_lookup |
locations_modeFacultatif | replace | add | remove | — |
platformsFacultatif | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
startFacultatif | string | date-heure ISO 8601 (UTC sans décalage) |
endFacultatif | string | date-heure ISO 8601 (UTC sans décalage) |
conversion_event_setting_idsFacultatif | array<string> | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_chatgpt_ads_ad_group
Écriture5 créditsCrée en pause un groupe d'annonces sous une campagne ChatGPT Ads avec sa stratégie d'enchères, son enchère maximale et ses indices de contexte (quand l'annonce serait utile). Les enchères anormalement élevées nécessitent allow_high_bid. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
campaign_idObligatoire | string | — |
nameObligatoire | string | — |
max_bidFacultatif | number | devise du compte : CPM pour la facturation à l'impression, CPC au clic, CPA pour les campagnes de conversion |
billing_eventFacultatif | impression | click | — |
strategyFacultatif | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidFacultatif | boolean | — |
context_hintsFacultatif | array<string> | — |
descriptionFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_chatgpt_ads_ad_group
Écriture5 créditsModifie le nom, l'enchère maximale, la stratégie d'enchères ou les indices de contexte (remplacer / ajouter / retirer) d'un groupe d'annonces ChatGPT Ads. Les hausses d'enchère de plus de 50 % nécessitent allow_high_bid. Aperçu et approbation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
ad_group_idObligatoire | string | — |
nameFacultatif | string | — |
max_bidFacultatif | number | — |
strategyFacultatif | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidFacultatif | boolean | — |
context_hintsFacultatif | array<string> | — |
hints_modeFacultatif | replace | add | remove | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_chatgpt_ads_ad
Écriture8 créditsCrée dans un groupe d'annonces une annonce carte de chat ChatGPT Ads en pause (titre, texte, destination, image) ; OpenAI l'examine. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
ad_group_idObligatoire | string | — |
nameObligatoire | string | — |
titleObligatoire | string | 3 à 50 caractères |
bodyObligatoire | string | 100 caractères max. |
target_urlObligatoire | string | — |
image_urlFacultatif | string | image https publique ; OpenAI la récupère |
file_idFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_chatgpt_ads_ad
Écriture5 créditsModifie le texte, la destination ou l'image d'une annonce ChatGPT Ads (le reste de la création est conservé) ; une création modifiée est réexaminée. Aperçu et approbation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
ad_idObligatoire | string | — |
nameFacultatif | string | — |
titleFacultatif | string | — |
bodyFacultatif | string | — |
target_urlFacultatif | string | — |
image_urlFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
chatgpt_ads_status
ÉcritureIrréversible5 créditsMet en pause, active ou archive une campagne, un groupe d'annonces ou une annonce ChatGPT Ads. L'archivage est irréversible et attend toujours une validation explicite. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
kindFacultatif | campaign | ad_group | ad | — |
idObligatoire | string | — |
actionObligatoire | pause | activate | archive | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_chatgpt_ads_event_setting
Écriture5 créditsCrée sur une source de pixel un paramètre d'événement de conversion ChatGPT Ads (quel événement suivi compte comme conversion), utilisable comme objectif de campagne. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés |
nameObligatoire | string | — |
event_typeObligatoire | page_viewed | contents_viewed | items_added | checkout_started | order_created | lead_created | registration_completed | subscription_created | trial_started | appointment_scheduled | plan_enrollment | app_installed | app_opened | custom | — |
source_idObligatoire | string | id de la source de pixel (clidsrc_…) |
custom_event_nameFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_chatgpt_ads_custom_audience
ÉcritureIrréversible5 créditsCrée une audience personnalisée vide ChatGPT Ads, ajoute ou retire des membres, l'archive. Uniquement des données propres avec droit d'usage ; e-mail et téléphone sont hachés avant l'envoi. Indisponible pour les campagnes EEE et Suisse.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
actionObligatoire | create | add | remove | archive | — |
audience_idFacultatif | string | caud_… (not for create) |
nameFacultatif | string | — |
descriptionFacultatif | string | — |
emailsFacultatif | array<string> | hashed before sending |
phonesFacultatif | array<string> | +country code; hashed before sending |
gaidsFacultatif | array<string> | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
manage_chatgpt_ads_spend_limit
ÉcritureIrréversible5 créditsCrée, modifie ou supprime un plafond de dépenses d'un compte ChatGPT Ads (fenêtre de dates ou plafond quotidien récurrent). Les hausses de plus de 50 % sont bloquées ; les suppressions attendent toujours une approbation explicite. Aperçu et approbation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés |
actionObligatoire | create | update | delete | set_daily | delete_daily | — |
window_idFacultatif | string | — |
start_dateFacultatif | string | YYYY-MM-DD, inclus |
end_dateFacultatif | string | YYYY-MM-DD, exclu |
amountFacultatif | number | devise du compte |
nameFacultatif | string | — |
io_idFacultatif | string | — |
no_end_dateFacultatif | boolean | plafond quotidien sans date de fin |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.