Outils Snapchat
Comptes publicitaires, campagnes et rapports de performance Snapchat ; les changements de statut et de budget quotidien passent par l'aperçu et l'approbation et peuvent être annulés.
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 lecture4 outils
list_snapchat_ad_accounts
Lecture1 créditsComptes Snapchat Ads accessibles via la connexion liée, dans toutes ses organisations : account_id, nom, devise, fuseau horaire, statut, organisation et compte sélectionné. Lecture seule ; connected=false si Snapchat n'est pas connecté.
Cet outil ne prend aucun paramètre.
list_snapchat_campaigns
Lecture1 créditsCampagnes Snapchat Ads du compte : id, nom, statut, objectif, budget quotidien et plafond de dépenses total (devise du compte), calendrier, statut de diffusion, ainsi que dépenses, impressions, swipes et conversions d'achat des N derniers jours entiers. Lecture seule ; n'invente jamais de chiffres (stats=null si Snapchat n'en a renvoyé aucun).
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion |
daysFacultatif | integer (1–31) | N derniers jours entiers, se terminant hier ; 7 par défaut |
statusFacultatif | active | paused | — |
snapchat_performance_report
Lecture1 créditsPerformances Snapchat Ads sur 31 jours entiers au maximum dans le fuseau horaire du compte : totaux, ventilation par campagne et lignes quotidiennes facultatives avec dépenses, impressions, swipes, achats, valeur d'achat et ajouts au panier. Aujourd'hui n'est pas inclus. Lecture seule ; n'invente jamais de chiffres.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion |
daysFacultatif | integer (1–31) | N derniers jours entiers, se terminant hier ; 7 par défaut |
campaign_idFacultatif | string | limite le rapport à une campagne |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD ; hier au plus tard |
granularityFacultatif | total | day | total par défaut |
diagnose_snapchat_delivery
Lecture1 créditsDiagnostic de diffusion EN DIRECT d'une campagne Snapchat Ads. À appeler en premier lorsque l'utilisateur signale que la campagne n'est pas diffusée, est en pause, en attente, limitée ou refusée. Lit le compte publicitaire, la campagne, ses ensembles de publicités (codes d'état de diffusion, budget, stratégie d'enchères, enchère, valeur de ROAS, rythme) et ses publicités (statut d'examen et motifs de refus), ainsi que le journal des modifications de la campagne et l'estimation d'enchère de Snap ; renvoie une liste de constats (niveau, code Snap, catégorie, preuve) et cannot_read pour ce qui n'a pas été lu. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion |
campaign_idObligatoire | string | id de campagne Snapchat (list_snapchat_campaigns) |
Outils d'écriture3 outils
update_snapchat_campaign_status
Écriture2 créditsMet en pause ou active une campagne Snapchat Ads. Appliqué à la demande de l'utilisateur, consigné dans le journal d'audit et annulable avec undo_action.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion |
campaign_idObligatoire | string | — |
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_snapchat_campaign_budget
Écriture2 créditsDéfinit le budget quotidien d'une campagne Snapchat Ads (devise du compte, minimum 20). Les hausses de plus de 50 % par modification ou 2× en 24 heures sont bloquées ; annulable avec undo_action si la campagne avait déjà un budget quotidien.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | id du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion |
campaign_idObligatoire | string | — |
daily_budgetObligatoire | number | nouveau budget quotidien dans la devise du compte, minimum 20 |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_snapchat_campaign
Écriture5 créditsCrée une campagne Snapchat avec son groupe d'annonces (ciblage, budget, objectif d'optimisation, stratégie d'enchères) ; les deux sont créés en pause. Une annonce nécessite d'abord un visuel importé dans Snapchat et n'est donc pas créée ici. Appliqué à la demande ; pour diffuser, update_snapchat_campaign_status.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | Snapchat ad account id; defaults to the connection's selected account |
nameObligatoire | string | — |
daily_budgetObligatoire | number | dans la devise du compte, au moins 5 (le minimum de Snapchat est de 5 000 000 micro) |
objectiveFacultatif | BRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES | — |
optimization_goalFacultatif | IMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS | — |
bid_strategyFacultatif | AUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST | — |
bidFacultatif | number | — |
pixel_idFacultatif | string | — |
ad_squad_nameFacultatif | string | — |
start_timeFacultatif | string | ISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z |
audienceFacultatif | object | countries, age_min, age_max, genders |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.