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

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

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

Campagnes 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ètreTypeDescription
account_idFacultatifstringid du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion
daysFacultatifinteger (1–31)N derniers jours entiers, se terminant hier ; 7 par défaut
statusFacultatifactive | paused—

snapchat_performance_report

Lecture1 crédits

Performances 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ètreTypeDescription
account_idFacultatifstringid du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion
daysFacultatifinteger (1–31)N derniers jours entiers, se terminant hier ; 7 par défaut
campaign_idFacultatifstringlimite le rapport à une campagne
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD ; hier au plus tard
granularityFacultatiftotal | daytotal par défaut

diagnose_snapchat_delivery

Lecture1 crédits

Diagnostic 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ètreTypeDescription
account_idFacultatifstringid du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestringid de campagne Snapchat (list_snapchat_campaigns)

Outils d'écriture3 outils

update_snapchat_campaign_status

Écriture2 crédits

Met 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ètreTypeDescription
account_idFacultatifstringid du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestring—
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_snapchat_campaign_budget

Écriture2 crédits

Dé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ètreTypeDescription
account_idFacultatifstringid du compte publicitaire Snapchat ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestring—
daily_budgetObligatoirenumbernouveau 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édits

Cré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ètreTypeDescription
account_idFacultatifstringSnapchat ad account id; defaults to the connection's selected account
nameObligatoirestring—
daily_budgetObligatoirenumberdans la devise du compte, au moins 5 (le minimum de Snapchat est de 5 000 000 micro)
objectiveFacultatifBRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES—
optimization_goalFacultatifIMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS—
bid_strategyFacultatifAUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST—
bidFacultatifnumber—
pixel_idFacultatifstring—
ad_squad_nameFacultatifstring—
start_timeFacultatifstringISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z
audienceFacultatifobjectcountries, 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.