Aller au contenu
Tecrübetecrube.com
Outils de l'assistant · Création et campagnes

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édits

Comptes 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édits

Campagnes 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
statusFacultatifactive | paused | archived—
nameFacultatifstringfiltrer par nom de campagne (3 caractères min.)

openai_ads_performance_report

Lecture2 crédits

Rapport 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
levelFacultatifad_account | campaign | ad_group | ad—
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
dailyFacultatifboolean—
campaign_idsFacultatifarray<string>—

chatgpt_ads_details

Lecture1 crédits

Tous 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
idObligatoirestringcmpn_…, adgrp_… ou ad_…
hints_limitFacultatifinteger (1–2000)—
hints_offsetFacultatifinteger (0–…)—

chatgpt_ads_geo_lookup

Lecture1 crédits

Recherche 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
queryObligatoirestring—
limitFacultatifinteger (1–100)—

chatgpt_ads_insights

Lecture2 crédits

Rapport 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
scope_idFacultatifstringid cmpn_/adgrp_/ad_ facultatif pour restreindre le rapport
levelFacultatifad_account | campaign | ad_group | ad—
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
granularityFacultatifnone | hourly | daily | monthly—
segmentFacultatifnone | country | device | platform | product—
include_zeroFacultatifbooleanajoute les lignes sans impression (sans segment)
conversionsFacultatifbooleanajoute conversions, CPA, CVR, ventes attribuées et ROAS
limitFacultatifinteger (1–2000)—
offsetFacultatifinteger (0–…)—

chatgpt_ads_spend_limits

Lecture1 crédits

Plafonds 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés

chatgpt_ads_conversion_setup

Lecture1 crédits

Suivi 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
check_recent_eventsFacultatifboolean—

chatgpt_ads_ad_preview

Lecture1 crédits

Affiche 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
ad_idObligatoirestring—

list_chatgpt_ads_custom_audiences

Lecture1 crédits

Liste les audiences personnalisées ChatGPT Ads du compte : ID, nom, statut et révision. Lecture seule.

ParamètreTypeDescription
ad_account_idFacultatifstringadacct_… — required only when several ChatGPT Ads accounts are connected

diagnose_chatgpt_ads_delivery

Lecture2 crédits

Explique 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
campaign_idFacultatifstring—
check_landing_pagesFacultatifboolean—

Outils d'écriture14 outils

update_openai_ads_campaign_status

Écriture2 crédits

Met 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
campaign_idObligatoirestringcmpn_…
statusObligatoirepause | 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édits

Dé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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
campaign_idObligatoirestringcmpn_…
daily_budgetObligatoirenumbernouveau 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édits

Connecte 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ètreTypeDescription
api_keyFacultatifstringclé API OpenAI Ads d'un compte publicitaire
confirmFacultatifboolean—

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édits

Liste 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ètreTypeDescription
actionFacultatiflist | recheck | disconnect | set_default—
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
confirmFacultatifboolean—

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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
nameObligatoirestring—
daily_budgetFacultatifnumber—
lifetime_budgetFacultatifnumber—
objectiveFacultatifimpressions | clicks | conversions—
descriptionFacultatifstring—
include_locationsFacultatifarray<string>id de lieux issus de chatgpt_ads_geo_lookup
exclude_locationsFacultatifarray<string>id de lieux issus de chatgpt_ads_geo_lookup
platformsFacultatifarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
custom_audience_idsFacultatifarray<string>—
excluded_custom_audience_idsFacultatifarray<string>—
startFacultatifstringdate-heure ISO 8601 (UTC sans décalage)
endFacultatifstringdate-heure ISO 8601 (UTC sans décalage)
conversion_event_setting_idsFacultatifarray<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édits

Modifie 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
campaign_idObligatoirestring—
nameFacultatifstring—
daily_budgetFacultatifnumber—
lifetime_budgetFacultatifnumber—
statusFacultatifactive | paused—
include_locationsFacultatifarray<string>id de lieux issus de chatgpt_ads_geo_lookup
exclude_locationsFacultatifarray<string>id de lieux issus de chatgpt_ads_geo_lookup
locations_modeFacultatifreplace | add | remove—
platformsFacultatifarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
startFacultatifstringdate-heure ISO 8601 (UTC sans décalage)
endFacultatifstringdate-heure ISO 8601 (UTC sans décalage)
conversion_event_setting_idsFacultatifarray<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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
campaign_idObligatoirestring—
nameObligatoirestring—
max_bidFacultatifnumberdevise du compte : CPM pour la facturation à l'impression, CPC au clic, CPA pour les campagnes de conversion
billing_eventFacultatifimpression | click—
strategyFacultatiffixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidFacultatifboolean—
context_hintsFacultatifarray<string>—
descriptionFacultatifstring—

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édits

Modifie 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
ad_group_idObligatoirestring—
nameFacultatifstring—
max_bidFacultatifnumber—
strategyFacultatiffixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidFacultatifboolean—
context_hintsFacultatifarray<string>—
hints_modeFacultatifreplace | 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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
ad_group_idObligatoirestring—
nameObligatoirestring—
titleObligatoirestring3 à 50 caractères
bodyObligatoirestring100 caractères max.
target_urlObligatoirestring—
image_urlFacultatifstringimage https publique ; OpenAI la récupère
file_idFacultatifstring—

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édits

Modifie 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
ad_idObligatoirestring—
nameFacultatifstring—
titleFacultatifstring—
bodyFacultatifstring—
target_urlFacultatifstring—
image_urlFacultatifstring—

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édits

Met 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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
kindFacultatifcampaign | ad_group | ad—
idObligatoirestring—
actionObligatoirepause | 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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement si plusieurs comptes ChatGPT Ads sont connectés
nameObligatoirestring—
event_typeObligatoirepage_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_idObligatoirestringid de la source de pixel (clidsrc_…)
custom_event_nameFacultatifstring—

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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — required only when several ChatGPT Ads accounts are connected
actionObligatoirecreate | add | remove | archive—
audience_idFacultatifstringcaud_… (not for create)
nameFacultatifstring—
descriptionFacultatifstring—
emailsFacultatifarray<string>hashed before sending
phonesFacultatifarray<string>+country code; hashed before sending
gaidsFacultatifarray<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édits

Cré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ètreTypeDescription
ad_account_idFacultatifstringadacct_… — requis uniquement lorsque plusieurs comptes ChatGPT Ads sont connectés
actionObligatoirecreate | update | delete | set_daily | delete_daily—
window_idFacultatifstring—
start_dateFacultatifstringYYYY-MM-DD, inclus
end_dateFacultatifstringYYYY-MM-DD, exclu
amountFacultatifnumberdevise du compte
nameFacultatifstring—
io_idFacultatifstring—
no_end_dateFacultatifbooleanplafond 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.