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

Outils Meta

Campagnes Facebook et Instagram, ensembles de publicités, audiences, créations, résultats de formulaires de prospects et estimations de couverture.

En cours de validation — bientôt

L’intégration de ce canal est prête ; la connexion ouvrira dès que la plateforme aura validé notre application développeur. D’ici là, aucun compte ne peut être connecté et les actions décrites sur cette page ne sont pas disponibles.

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 lecture32 outils

list_meta_ad_accounts

Lecture1 crédits

Comptes publicitaires Meta accessibles avec le jeton Meta connecté : id (act_…), nom, devise, statut, fuseau horaire, dépenses cumulées, entreprise, et lequel est sélectionné. Lecture seule ; connected=false si Meta n'est pas lié.

Cet outil ne prend aucun paramètre.

meta_insights_report

Lecture2 crédits

Performances Facebook + Instagram (Meta Insights) au niveau campagne, ensemble de publicités ou publicité sur une plage de dates, avec ventilation facultative par âge, genre, placement ou appareil : dépenses, impressions, couverture, répétition, clics, CTR, CPM, CPC, conversions, revenus, ROAS (purchase_roas) et CPA (cost_per_action_type). Tri par n'importe quelle métrique et filtres à seuils (p. ex. roas_below=3 trié par dépenses, cpa_above=40). Données réelles uniquement.

ParamètreTypeDescription
levelFacultatifcampaign | adset | ad—
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
date_presetFacultatiftoday | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_monthinstead of days/start_date/end_date
breakdownFacultatifnone | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | regionplacement = publisher_platform + platform_position ; device = impression_device
conversion_eventFacultatifpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktype de résultat utilisé pour les conversions et le CPA (purchase par défaut)
campaign_idsFacultatifarray<string>—
adset_idsFacultatifarray<string>—
ad_idsFacultatifarray<string>—
sort_byFacultatifspend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc—
sort_orderFacultatifdesc | asc—
min_spendFacultatifnumber—
roas_belowFacultatifnumber—
roas_aboveFacultatifnumber—
cpa_aboveFacultatifnumber—
cpa_belowFacultatifnumber—
frequency_aboveFacultatifnumber—
limitFacultatifinteger (1–500)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_top_creatives

Lecture2 crédits

Publicités Meta (créations) les plus performantes dans un placement comme Instagram Reels, classées par ROAS, CPA, conversions ou CTR, avec les détails de la création (miniature, vidéo, permalien Instagram) et les ids de leurs ensembles de publicités pour duplication.

ParamètreTypeDescription
placementFacultatifstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (comparé à publisher_platform:platform_position)
metricFacultatifroas | cpa | conversions | ctr | spend | revenue—
conversion_eventFacultatifpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktype de résultat utilisé pour les conversions et le CPA (purchase par défaut)
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
limitFacultatifinteger (1–25)—
min_spendFacultatifnumber—
campaign_idsFacultatifarray<string>—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_audiences

Lecture1 crédits

Audiences personnalisées et similaires du compte publicitaire Meta : id, nom, sous-type, fourchette de taille approximative, rétention, statut de diffusion.

ParamètreTypeDescription
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

search_meta_interests

Lecture1 crédits

Recherche par mot-clé dans la taxonomie des centres d'intérêt Meta (recherche de ciblage) : id de l'intérêt, nom, chemin et fourchette de taille d'audience. Utilisez les ids dans targeting.interest_ids.

ParamètreTypeDescription
queryFacultatifstring—
limitFacultatifinteger (1–100)—
localeFacultatifstringp. ex. tr_TR, en_US
kindFacultatifinterest | behavior | life_event | industry | family_status | income | demographicinterest (default) or a detailed-targeting category
category_classFacultatifstringraw adTargetingCategory class, overrides kind
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_reach_estimate

Lecture2 crédits

Taille d'audience estimée pour un ciblage avant de dépenser (estimation de diffusion Meta, avec repli sur l'estimation de couverture) : fourchette d'utilisateurs actifs mensuels et utilisateurs quotidiens.

ParamètreTypeDescription
targetingObligatoireobject—
optimization_goalFacultatifstringREACH (par défaut), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idFacultatifstring—
custom_event_typeFacultatifstringp. ex. PURCHASE (avec pixel_id)
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_ad_sets

Lecture1 crédits

Ensembles de publicités Meta avec statut, budget quotidien/global (devise du compte), enchère, objectif d'optimisation, ciblage et calendrier.

ParamètreTypeDescription
campaign_idFacultatifstring—
adset_idsFacultatifarray<string>—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_instagram_posts

Lecture1 crédits

Publications Instagram récentes du compte professionnel Instagram connecté avec mentions J'aime, commentaires et engagement, triées par engagement — pour choisir une publication à booster.

ParamètreTypeDescription
instagram_user_idFacultatifstring—
limitFacultatifinteger (1–100)—
sort_byFacultatifengagement | recent—

list_meta_conversations

Lecture1 crédits

Messenger or Instagram Direct conversations of the Facebook Page (and its linked Instagram account): participants, unread count, last message preview. Read only; reply with reply_customer.

La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.

ParamètreTypeDescription
page_idFacultatifstring—
platformFacultatifmessenger | instagram—
limitFacultatifinteger (1–50)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_lead_forms

Lecture1 crédits

Formulaires de prospects (instantanés) de la Page Facebook avec statut et nombre de prospects. La création de nouveaux formulaires n'est pas prise en charge.

ParamètreTypeDescription
page_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_lead_form_summary

Lecture2 crédits

Nombre de prospects d'un formulaire sur les N derniers jours, par jour, par publicité et par plateforme. Décomptes uniquement ; les réponses personnelles ne sont jamais renvoyées.

ParamètreTypeDescription
form_idObligatoirestring—
page_idFacultatifstring—
daysFacultatifinteger (1–90)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_catalogs

Lecture1 crédits

Catalogues de produits des entreprises Meta de l'utilisateur (Commerce Manager) : id, nom, nombre de produits, secteur, entreprise. Nécessite catalog_management ; connected=false si Meta n'est pas lié.

ParamètreTypeDescription
business_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_catalog_products

Lecture1 crédits

Produits d'un catalogue Meta avec id revendeur, prix, disponibilité, état, URL, image, statut de vérification et motifs de refus ; filtre par statut de vérification ou filtre Graph. Lecture seule.

ParamètreTypeDescription
catalog_idObligatoirestringid du catalogue de produits Meta (list_meta_catalogs)
queryFacultatifstringle nom contient
review_statusFacultatifapproved | rejected | pending | outdated—
filterFacultatifobjectfiltre de produits Graph, p. ex. {"retailer_id": {"eq": "SKU1"}}
limitFacultatifinteger (1–1000)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_product_sets

Lecture1 crédits

Ensembles de produits d'un catalogue Meta (id, nom, nombre de produits, filtre) pour les ensembles de publicités de ventes catalogue, plus les flux de produits du catalogue avec le résultat de leur dernier envoi. Lecture seule.

ParamètreTypeDescription
catalog_idObligatoirestringid du catalogue de produits Meta (list_meta_catalogs)
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_pages

Lecture1 crédits

Pages Facebook gérées par l'utilisateur Meta connecté (id, nom, catégorie, tâches, compte Instagram lié) ou, avec promotable_only, les Pages pour lesquelles le compte publicitaire peut faire de la publicité. Lecture seule.

ParamètreTypeDescription
promotable_onlyFacultatifbooleanuniquement les Pages que le compte publicitaire sélectionné peut promouvoir

list_meta_campaigns

Lecture1 crédits

Campagnes présentes dans le compte publicitaire Meta (y compris celles créées hors de cette application) : id, nom, statut, objectif, budget quotidien/global dans la devise du compte, stratégie d'enchères, calendrier. Lecture seule.

ParamètreTypeDescription
effective_statusFacultatifarray<string>p. ex. ACTIVE, PAUSED
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_ads

Lecture1 crédits

Publicités Meta du compte, d'un ensemble de publicités ou d'une campagne : id, nom, statut, statut effectif, ensemble de publicités, id de création et miniature. Lecture seule.

ParamètreTypeDescription
adset_idFacultatifstring—
campaign_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_page_posts

Lecture1 crédits

Publications récentes d'une Page Facebook avec texte, image et lien permanent, pour réutiliser une publication organique comme publicité (object_story_id). Lecture seule.

ParamètreTypeDescription
page_idFacultatifstring—
limitFacultatifinteger (1–100)—

list_meta_pixels

Lecture1 crédits

Pixels Meta (jeux de données) du compte publicitaire avec nom et heure du dernier déclenchement. Lecture seule.

ParamètreTypeDescription
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_insights_query

Lecture2 crédits

Lecture libre de l'API Meta Insights pour tout ce que les rapports prêts à l'emploi ne couvrent pas : tout champ, ventilation, ventilation d'actions, filtre et incrément temporel pris en charge par Meta. Renvoie des lignes brutes. Lecture seule.

ParamètreTypeDescription
fieldsObligatoirearray<string>champs Insights, p. ex. spend, reach, actions, video_p75_watched_actions
levelFacultatifaccount | campaign | adset | ad—
breakdownsFacultatifarray<string>p. ex. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone
action_breakdownsFacultatifarray<string>p. ex. action_type, action_device
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
time_incrementFacultatifstring1 = quotidien, 7 = hebdomadaire, monthly, all_days
filteringFacultatifarray<object>filtres Graph [{field, operator, value}]
limitFacultatifinteger (1–5000)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_instagram_accounts

Lecture1 crédits

Comptes Instagram utilisables pour les publicités : ceux associés au compte publicitaire et ceux liés aux Pages Facebook de l'utilisateur (id, nom d'utilisateur, page). Lecture seule.

Cet outil ne prend aucun paramètre.

list_meta_saved_audiences

Lecture1 crédits

Audiences enregistrées (préréglages de ciblage réutilisables du Gestionnaire de publicités) avec ciblage et taille approximative. Lecture seule.

ParamètreTypeDescription
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

list_meta_custom_conversions

Lecture1 crédits

Conversions personnalisées du compte publicitaire : id, nom, règle (URL / événement), type d'événement, pixel, dernier déclenchement, valeur par défaut. Lecture seule.

ParamètreTypeDescription
include_archivedFacultatifboolean—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

diagnose_meta_delivery

Lecture2 crédits

Diagnostic de diffusion EN DIRECT d'une campagne Meta. À appeler en premier lorsque l'utilisateur signale un état ou un avertissement (non diffusée, avec problèmes, en apprentissage, limitée, refusée). Renvoie la campagne, ses ensembles de publicités et ses publicités avec leur état effectif, les problèmes que Meta signale comme bloquant la diffusion (issues_info : niveau, code d'erreur, résumé, message), la phase d'apprentissage de chaque ensemble, la stratégie d'enchères, le montant de l'enchère, le budget et le budget restant, le résultat de l'examen de chaque publicité et une liste de constats. Lecture seule.

ParamètreTypeDescription
campaign_idObligatoirestringid de campagne Meta (list_meta_campaigns) ou id de campagne Tecrübe
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_change_history

Lecture2 crédits

Historique d'activité du compte publicitaire Meta : qui a modifié quoi et quand (budget, statut, ciblage, modifications de créations), avec les anciennes/nouvelles valeurs lorsque Meta les fournit. Lecture seule.

ParamètreTypeDescription
sinceFacultatifstringYYYY-MM-DD
untilFacultatifstringYYYY-MM-DD
daysFacultatifinteger (1–365)—
levelFacultatifstringfiltrer par type d'objet : campaign | adset | ad | account …
limitFacultatifinteger (1–1000)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_delivery_estimate

Lecture1 crédits

Estimation de diffusion de Meta pour le ciblage actuel d'un ensemble de publicités existant : utilisateurs mensuels atteignables, utilisateurs quotidiens et courbe des résultats attendus, sans dépenser. Lecture seule.

ParamètreTypeDescription
adset_idObligatoirestring—
optimization_goalFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

preview_meta_ad

Lecture1 crédits

Génère un aperçu d'une création ou d'une publicité Meta dans un format d'emplacement (feed, story, reels …) sans publier ; renvoie une URL d'aperçu temporaire. Lecture seule.

ParamètreTypeDescription
creative_idFacultatifstring—
ad_idFacultatifstring—
ad_formatFacultatifDESKTOP_FEED_STANDARD | MOBILE_FEED_STANDARD | INSTAGRAM_STANDARD | INSTAGRAM_STORY | INSTAGRAM_REELS | FACEBOOK_STORY_MOBILE | FACEBOOK_REELS_MOBILE | RIGHT_COLUMN_STANDARD | MARKETPLACE_MOBILE | AUDIENCE_NETWORK_OUTSTREAM_VIDEO | MESSENGER_MOBILE_INBOX_MEDIA | INSTAGRAM_EXPLORE_GRID_HOME—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

get_meta_ad_creative

Lecture1 crédits

Lit la création actuelle d'une publicité : titre, texte principal, description, image ou vidéo, bouton, lien de destination, identité Page / Instagram et fonctionnalités créatives Advantage+ activées. Lecture seule.

ParamètreTypeDescription
ad_idObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

find_instagram_media_id

Lecture1 crédits

Résout le lien d'une publication ou d'un Reel Instagram en son id de média (nécessaire pour boost_instagram_post) en parcourant les médias du compte professionnel Instagram sélectionné. Lecture seule.

ParamètreTypeDescription
urlObligatoirestring—
ig_user_idFacultatifstring—

instagram_follower_growth

Lecture1 crédits

Nouveaux abonnés quotidiens d'un compte professionnel Instagram sur les 30 derniers jours au maximum, plus le nombre actuel d'abonnés, pour mesurer les campagnes d'abonnés et de visites du profil. Lecture seule.

ParamètreTypeDescription
ig_user_idFacultatifstring—
daysFacultatifinteger (1–30)—

download_meta_leads

Lecture1 crédits

Télécharge les réponses envoyées via un formulaire instantané Meta (chaque question, plus la publicité, l'ensemble de publicités et la campagne de chaque prospect). Données personnelles : nécessite leads_retrieval ; à traiter dans le cadre du consentement du formulaire. Lecture seule.

ParamètreTypeDescription
form_idObligatoirestring—
page_idFacultatifstring—
limitFacultatifinteger (1–2000)—
sinceFacultatifstringYYYY-MM-DD
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

meta_targeting_helper

Lecture1 crédits

Trois aides pour construire le ciblage Meta : suggère des centres d'intérêt proches des vôtres, vérifie qu'un identifiant ou un nom d'intérêt est encore utilisable (un ensemble de publicités portant un intérêt invalide est refusé), ou lit les budgets quotidiens minimaux du compte. Lecture seule.

ParamètreTypeDescription
modeFacultatifsuggest | validate | minimum_budget—
interest_idsFacultatifarray<string>—
namesFacultatifarray<string>—
limit_typeFacultatifinterests | behaviors | income | life_events—
is_exclusionFacultatifboolean—
bid_amountFacultatifinteger—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outils d'écriture38 outils

select_meta_ad_account

Écriture1 crédits

Choisit le compte publicitaire Meta dans lequel travailleront tous les outils Meta suivants (agence / multi-comptes). Seuls les comptes accessibles à l'utilisateur sont acceptés.

ParamètreTypeDescription
account_idObligatoirestring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_website_audience

Écriture2 crédits

Crée une audience personnalisée de site web à partir du pixel Meta (p. ex. ajout au panier dans les 30 derniers jours sans achat). Aperçu et validation d'abord ; l'audience se remplit en quelques heures.

ParamètreTypeDescription
nameObligatoirestring—
eventObligatoirestringévénement du pixel : AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysFacultatifinteger (1–180)—
exclude_eventFacultatifstringp. ex. Purchase pour les abandons de panier
pixel_idFacultatifstring—
descriptionFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_lookalike_audience

Écriture2 crédits

Crée une audience similaire Meta (1–10 %) à partir d'une audience personnalisée dans un ou plusieurs pays. Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
source_audience_idObligatoirestring—
countriesObligatoirearray<string>codes ISO
ratio_percentFacultatifnumber (1–10)1 = le 1 % le plus proche
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_campaign

Écriture2 crédits

Crée une campagne Meta de bout en bout (campagne + ensemble de publicités + publicité lorsqu'une page et une création existent) en brouillon en pause avec objectif, budget quotidien et ciblage. Écrit un brouillon dans le registre et un élément de validation ; envoyé à Meta uniquement après validation.

ParamètreTypeDescription
nameObligatoirestring—
objectiveObligatoiresales | traffic | engagement | messages | awareness—
daily_budgetFacultatifnumberdevise du compte
goalFacultatifstring—
special_ad_categoriesFacultatifarray<string>CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES
audienceFacultatifobject—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_meta_campaign

Écriture2 crédits

Modifie le budget (quotidien/global), le statut, le nom, la stratégie d'enchères ou le plafond de dépenses d'une campagne Meta. Aperçu avant → après ; les hausses de budget de plus de +50 % par étape sont bloquées. Appliqué uniquement après validation.

ParamètreTypeDescription
campaign_idObligatoirestringid de campagne Meta ou id de campagne Tecrube
daily_budgetFacultatifnumberad account currency
lifetime_budgetFacultatifnumber—
currencyFacultatifstringoptional ISO check; must equal the ad account currency
statusFacultatifACTIVE | PAUSED | ARCHIVED—
nameFacultatifstring—
bid_strategyFacultatifstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capFacultatifnumber—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_meta_ad_set

Écriture2 crédits

Modifie le budget, le statut, le ciblage (lieux, âge, genre, intérêts, audiences, placements), l'enchère ou le calendrier d'un ensemble de publicités Meta. Aperçu et validation d'abord ; le garde-fou budgétaire s'applique.

ParamètreTypeDescription
adset_idObligatoirestring—
daily_budgetFacultatifnumberad account currency
lifetime_budgetFacultatifnumber—
currencyFacultatifstringoptional ISO check; must equal the ad account currency
statusFacultatifACTIVE | PAUSED | ARCHIVED—
nameFacultatifstring—
bid_strategyFacultatifstring—
bid_amountFacultatifnumber—
targetingFacultatifobject—
start_timeFacultatifstringISO 8601
end_timeFacultatifstringISO 8601
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

duplicate_meta_ad_set

Écriture2 crédits

Duplique un ensemble de publicités Meta gagnant (avec ses publicités) en copie en pause et lui donne une nouvelle audience d'intérêts, un nouveau ciblage ou budget pour un test. Aperçu et validation d'abord.

ParamètreTypeDescription
adset_idObligatoirestring—
interest_idsFacultatifarray<string>remplace les intérêts, conserve le reste du ciblage
targetingFacultatifobject—
daily_budgetFacultatifnumber—
nameFacultatifstring—
bid_amountFacultatifnumber—
start_timeFacultatifstring—
end_timeFacultatifstring—
deep_copyFacultatifboolean—
rename_suffixFacultatifstring—
target_campaign_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

pause_meta_ad_sets_above_cpa

Écriture2 crédits

Trouve les ensembles de publicités Meta actifs dont le CPA dépasse un seuil (ou qui ont dépensé au moins le seuil sans résultat), les met en pause en une seule action et transfère leur budget quotidien libéré à l'ensemble au meilleur CPA dans la limite du garde-fou +50 %. Affiche d'abord la liste ; appliqué uniquement après validation.

ParamètreTypeDescription
cpa_thresholdObligatoirenumberdevise du compte
conversion_eventFacultatifpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktype de résultat utilisé pour les conversions et le CPA (purchase par défaut)
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
min_spendFacultatifnumber—
campaign_idsFacultatifarray<string>—
reallocateFacultatifbooleantransférer le budget quotidien des ensembles mis en pause vers le meilleur ensemble (true par défaut)
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_video_ad

Écriture2 crédits

Crée une publicité vidéo Meta à partir d'un id de vidéo existant dans un ensemble de publicités (miniature tirée de la vidéo si non fournie). Créée en pause après validation.

ParamètreTypeDescription
adset_idObligatoirestring—
video_idFacultatifstringid de la vidéo dans le compte publicitaire Meta
video_urlFacultatifstringpublic https video URL; Meta fetches it (instead of video_id)
linkObligatoirestring—
nameFacultatifstring—
messageFacultatifstring—
titleFacultatifstring—
call_to_actionFacultatifLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW—
thumbnail_urlFacultatifstring—
page_idFacultatifstring—
instagram_user_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

boost_instagram_post

Écriture2 crédits

Transforme une publication Instagram existante (source_instagram_media_id) ou une publication de Page Facebook (object_story_id) en publicité dans un ensemble de publicités ; pick_best choisit la publication Instagram récente la plus engageante. Aperçu et validation d'abord ; créée en pause.

ParamètreTypeDescription
adset_idObligatoirestring—
instagram_media_idFacultatifstring—
pick_bestFacultatifbooleanutiliser la publication Instagram récente la plus engageante
lookback_postsFacultatifinteger (1–100)—
facebook_post_idFacultatifstring{page_id}_{post_id} pour booster une publication de Page à la place
linkFacultatifstring—
call_to_actionFacultatifLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW—
nameFacultatifstring—
instagram_user_idFacultatifstring—
page_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

upsert_meta_catalog_product

Écriture2 crédits

Ajoute un produit à un catalogue Meta (POST /{catalog_id}/products ; nécessite retailer_id, name, url, image_url, price, currency, availability) ou met à jour un produit existant (POST /{product_id}). Aperçu et validation d'abord ; appliqué uniquement après validation.

ParamètreTypeDescription
catalog_idFacultatifstringid du catalogue de produits Meta (list_meta_catalogs)
product_idFacultatifstringid du produit Meta existant à mettre à jour ; omettre pour créer
retailer_idFacultatifstring—
nameFacultatifstring—
descriptionFacultatifstring—
urlFacultatifstring—
image_urlFacultatifstring—
priceFacultatifnumber—
sale_priceFacultatifnumber—
currencyFacultatifstringISO ; par défaut : devise du compte publicitaire
availabilityFacultatifin stock | out of stock | preorder | available for order | discontinued—
conditionFacultatifnew | refurbished | used—
brandFacultatifstring—
categoryFacultatifstring—
gtinFacultatifstring—
colorFacultatifstring—
sizeFacultatifstring—
item_group_idFacultatifstring—
custom_label_0Facultatifstring—
visibilityFacultatifpublished | staging—
custom_label_1Facultatifstring—
custom_label_2Facultatifstring—
custom_label_3Facultatifstring—
custom_label_4Facultatifstring—
genderFacultatifstringfemale | male | unisex
materialFacultatifstring—
patternFacultatifstring—
product_typeFacultatifstringseller's own category path
additional_image_urlsFacultatifarray<string>extra product image URLs
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_catalog_sales_campaign

Écriture2 crédits

Crée une campagne de ventes catalogue Meta (objectif OUTCOME_SALES avec promoted_object.product_catalog_id) et un ensemble de publicités faisant la promotion d'un ensemble de produits (promoted_object.product_set_id, optimisation des achats) en brouillon en pause. Écrit un brouillon dans le registre et un élément de validation ; envoyé à Meta uniquement après validation.

ParamètreTypeDescription
nameObligatoirestring—
catalog_idObligatoirestringid du catalogue de produits Meta (list_meta_catalogs)
product_set_idObligatoirestring—
daily_budgetFacultatifnumberdevise du compte
countriesFacultatifarray<string>codes ISO, TR par défaut
pixel_idFacultatifstring—
goalFacultatifstring—
audienceFacultatifobject—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

meta_page_subscription

Écriture1 crédits

Indique si la Page Facebook est abonnée au webhook de Tecrübe et avec quels champs (les nouveaux messages Messenger / Instagram et les réponses aux formulaires n'arrivent qu'à cette condition) ; subscribe=true crée l'abonnement (peut être répété). Nécessite pages_manage_metadata.

ParamètreTypeDescription
page_idFacultatifstring—
subscribeFacultatifbooleantrue = subscribe the Page now
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

delete_meta_campaign

ÉcritureIrréversible5 crédits

Supprime DÉFINITIVEMENT une campagne Meta (les rapports restent consultables dans Meta). Attend toujours une validation explicite et ne peut pas être annulé. En cas de doute, mettez plutôt en pause.

ParamètreTypeDescription
campaign_idObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

delete_meta_adset

ÉcritureIrréversible5 crédits

Supprime DÉFINITIVEMENT un ensemble de publicités Meta. Attend toujours une validation explicite et ne peut pas être annulé.

ParamètreTypeDescription
adset_idObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

delete_meta_ad

ÉcritureIrréversible5 crédits

Supprime DÉFINITIVEMENT une publicité Meta. Attend toujours une validation explicite et ne peut pas être annulé.

ParamètreTypeDescription
ad_idObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

delete_meta_audience

ÉcritureIrréversible5 crédits

Supprime DÉFINITIVEMENT une audience personnalisée ou similaire Meta (doublons, erreurs, demandes liées à la vie privée). Attend toujours une validation explicite et ne peut pas être annulé.

ParamètreTypeDescription
audience_idObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_adset

Écriture5 crédits

Crée en pause un ensemble de publicités dans une campagne Meta existante avec objectif d'optimisation, budget, enchère, calendrier, objet promu et ciblage complet (lieux, données démographiques, ciblage détaillé, audiences, placements). Aperçu et validation d'abord.

ParamètreTypeDescription
campaign_idObligatoirestring—
nameObligatoirestring—
optimization_goalFacultatifLINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT—
billing_eventFacultatifIMPRESSIONS | LINK_CLICKS | THRUPLAY—
daily_budgetFacultatifnumberdevise du compte
lifetime_budgetFacultatifnumber—
bid_strategyFacultatifstring—
bid_amountFacultatifnumber—
targetingObligatoireobject—
start_timeFacultatifstringISO 8601
end_timeFacultatifstringISO 8601
pixel_idFacultatifstring—
custom_event_typeFacultatifstring—
page_idFacultatifstring—
destination_typeFacultatifstringp. ex. WEBSITE, MESSENGER, WHATSAPP, ON_AD
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

copy_meta_entity

Écriture5 crédits

Duplique une campagne, un ensemble de publicités ou une publicité Meta (« Dupliquer » dans le Gestionnaire de publicités), éventuellement avec ses éléments enfants et dans un autre parent ; la copie est toujours en pause. Aperçu et validation d'abord.

ParamètreTypeDescription
kindObligatoirecampaign | adset | ad—
entity_idObligatoirestring—
deep_copyFacultatifboolean—
rename_prefixFacultatifstring—
rename_suffixFacultatifstring—
target_parent_idFacultatifstringcampagne pour copier un ensemble de publicités, ensemble de publicités pour copier une publicité
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_dynamic_ad

Écriture8 crédits

Crée dans un ensemble de publicités de ventes catalogue une publicité dynamique de produits qui se remplit depuis un ensemble de produits du catalogue ({{product.name}}, {{product.price}}). Créée en pause après validation.

ParamètreTypeDescription
adset_idObligatoirestring—
nameFacultatifstring—
product_set_idObligatoirestring—
messageFacultatifstring—
descriptionFacultatifstringtexte modèle, par défaut {{product.price}}
call_to_actionFacultatifLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW—
fallback_linkFacultatifstring—
page_idFacultatifstring—
instagram_user_idFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_meta_ad

Écriture5 crédits

Met en pause, relance, archive ou renomme une publicité Meta. Aperçu avant → après ; appliqué uniquement après approbation.

ParamètreTypeDescription
ad_idObligatoirestring—
statusFacultatifACTIVE | PAUSED | ARCHIVED—
nameFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_meta_ad_creative

Écriture5 crédits

Remplace la création d'une publicité à lien (image, texte, lien, bouton) sans supprimer la publicité : une nouvelle création est construite à partir de l'actuelle plus vos modifications puis substituée, la publicité conserve ainsi son id et son historique. Aperçu et approbation d'abord.

ParamètreTypeDescription
ad_idObligatoirestring—
messageFacultatifstring—
headlineFacultatifstring—
descriptionFacultatifstring—
linkFacultatifstring—
image_urlFacultatifstringURL d'image https publique ou URL de média Studio
image_hashFacultatifstringissu de upload_meta_image
image_base64Facultatifstringimage en base64, 5 Mo au maximum
call_to_actionFacultatifLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW—
page_idFacultatifstring—
nameFacultatifstringnouveau nom de la création
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_ab_test

Écriture5 crédits

Crée un test A/B Meta qui diffuse deux campagnes existantes à 50/50 sur des audiences sans chevauchement pendant une période et désigne un gagnant équitable. Nécessite un Business Manager. Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
campaign_aObligatoirestring—
campaign_bObligatoirestring—
start_timeObligatoirestringISO 8601 (UTC sans décalage)
end_timeObligatoirestringISO 8601
control_nameFacultatifstring—
treatment_nameFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

manage_meta_account_controls

Écriture2 crédits

Sécurité de la marque au niveau du compte : lit ou définit les contraintes d'audience et d'emplacement qui s'appliquent à TOUTES les campagnes du compte publicitaire Meta (âge minimum, pays exclus, emplacements exclus comme Audience Network ou Marketplace). Aperçu et validation d'abord.

ParamètreTypeDescription
actionFacultatifget | set—
age_minFacultatifinteger (13–65)—
placement_exclusionsFacultatifarray<string>emplacements à exclure : AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN
countriesFacultatifarray<string>—
excluded_countriesFacultatifarray<string>—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_product_set

Écriture2 crédits

Crée dans un catalogue Meta un ensemble de produits défini par des règles (marque, type de produit, prix, disponibilité, libellés personnalisés…), à utiliser comme ensemble de produits d'un ensemble de publicités ventes catalogue. Aperçu et validation d'abord.

ParamètreTypeDescription
catalog_idObligatoirestring—
nameObligatoirestring—
filterFacultatifobjectrègle, p. ex. {"product_type": {"i_contains": "chemise"}} ; {} signifie tous les produits
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_customer_file_audience

Écriture5 crédits

Crée une audience personnalisée Meta à partir d'une liste de clients (customaudiences + users). Les valeurs sont normalisées et hachées en SHA-256 dans Tecrübe avant tout stockage ou envoi ; l'aperçu n'affiche que des nombres. Le compte publicitaire doit avoir accepté les Conditions des audiences personnalisées. Validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
id_typeFacultatifEMAIL | PHONE | EXTERN_ID—
identifiersObligatoirearray<string>e-mails, téléphones avec indicatif pays ou vos propres identifiants client ; les valeurs déjà hachées en SHA-256 sont également acceptées
descriptionFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_product_audience

Écriture5 crédits

Crée une audience de reciblage à partir d'un ensemble de produits du catalogue (p. ex. ont vu un produit ces 30 derniers jours sans acheter). Sert d'audience à un ensemble de publicités ventes catalogue. Validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
product_set_idObligatoirestring—
eventFacultatifstringViewContent | AddToCart | Purchase (par défaut ViewContent)
exclude_eventFacultatifstringpar défaut Purchase ; laissez vide pour n'exclure personne
retention_daysFacultatifinteger (1–180)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_pixel

Écriture2 crédits

Crée un nouveau pixel Meta (jeu de données) sur le compte publicitaire et renvoie le pixel_id à installer sur le site. Consultez d'abord list_meta_pixels : Meta limite le nombre de pixels par compte. Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_custom_conversion

Écriture2 crédits

Crée une conversion personnalisée sur un pixel Meta à partir d'une règle d'URL et/ou d'un événement (p. ex. l'URL contient /thank-you). Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
pixel_idFacultatifstring—
url_containsFacultatifstring—
eventFacultatifstringévénement du pixel, p. ex. PageView, Purchase
custom_event_typeFacultatifPURCHASE | LEAD | COMPLETE_REGISTRATION | ADD_TO_CART | INITIATED_CHECKOUT | ADD_PAYMENT_INFO | CONTENT_VIEW | SEARCH | ADD_TO_WISHLIST | CONTACT | SUBSCRIBE | START_TRIAL | SUBMIT_APPLICATION | SCHEDULE | OTHER—
default_conversion_valueFacultatifnumber—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_meta_custom_conversion

Écriture2 crédits

Renomme une conversion personnalisée Meta ou modifie sa description / sa valeur par défaut. Aperçu et approbation d'abord.

ParamètreTypeDescription
conversion_idObligatoirestring—
nameFacultatifstring—
descriptionFacultatifstring—
default_conversion_valueFacultatifnumber—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_engagement_audience

Écriture5 crédits

Crée une audience de reciblage Meta à partir des interactions avec une Page Facebook, un profil professionnel Instagram ou un formulaire pour prospects (p. ex. ouvert mais non envoyé). Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
sourceObligatoirepage | instagram | lead_form—
source_idFacultatifstring—
eventFacultatifstringp. ex. page_engaged, ig_business_profile_engaged, lead_generation_opened
retention_daysFacultatifinteger (1–730)—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_lead_form

Écriture5 crédits

Crée sur une Page Facebook un formulaire instantané (pour prospects) avec questions standard et personnalisées, introduction, politique de confidentialité et écran de remerciement ; renvoie l'id du formulaire pour une publicité à formulaire. Aperçu et validation d'abord.

ParamètreTypeDescription
page_idFacultatifstring—
nameObligatoirestring—
privacy_policy_urlObligatoirestring—
questionsObligatoirearray<object>—
follow_up_urlFacultatifstring—
intro_headlineFacultatifstring—
intro_descriptionFacultatifstring—
thank_you_textFacultatifstring—
localeFacultatifstringp. ex. tr_TR
higher_intentFacultatifbooleanajoute une étape de vérification (formulaire à intention plus forte)
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

upload_meta_image

Écriture1 crédits

Importe une image dans la bibliothèque d'images du compte publicitaire Meta et renvoie son image_hash pour la réutiliser dans les publicités. Les URL externes ne sont récupérées que depuis l'internet public. Aperçu et approbation d'abord.

ParamètreTypeDescription
image_urlFacultatifstringURL d'image https publique ou URL de média Studio
image_base64Facultatifstringimage en base64, 5 Mo au maximum
nameFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

upload_meta_video

Écriture3 crédits

Ajoute une vidéo au compte publicitaire Meta depuis une URL publique (Meta la récupère) et renvoie son video_id pour create_meta_video_ad. Aperçu et approbation d'abord.

ParamètreTypeDescription
video_urlObligatoirestringURL vidéo https publique ; Meta la récupère
nameFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

send_meta_conversion_event

Écriture1 crédits

Envoie à Meta un événement de conversion côté serveur (Conversions API), p. ex. une vente hors ligne ou issue du CRM. L'e-mail, le téléphone et l'id externe sont hachés en SHA-256 avant d'être stockés ou envoyés. Utilisez test_event_code pour vérifier d'abord dans Events Manager. Aperçu et approbation d'abord.

ParamètreTypeDescription
pixel_idFacultatifstring—
event_nameObligatoirestring—
emailFacultatifstring—
phoneFacultatifstring—
external_idFacultatifstring—
valueFacultatifnumber—
currencyFacultatifstring—
event_idFacultatifstringid de déduplication partagé avec le pixel
event_source_urlFacultatifstring—
action_sourceFacultatifwebsite | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other—
fbcFacultatifstring—
fbpFacultatifstring—
test_event_codeFacultatifstring—
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_meta_ad_account

ÉcritureIrréversible2 crédits

Create a new Meta ad account under the user's Business Manager (for the user who has no ad account after OAuth). Needs a Business Manager (returns an honest note if none; lists them when there are several). Only call it when the user explicitly asked for it; the account is created at once and the connection is linked to it. Currency and time zone are permanent; a payment method must still be added in Business Manager.

La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.

ParamètreTypeDescription
nameObligatoirestringaccount name, e.g. “Acme Ads”
currencyObligatoirestringpermanent; Meta-supported ISO code (TRY, USD, EUR…)
business_idFacultatifstringBusiness Manager id the account belongs to; required when the user has several
connection_idFacultatifstringoptional: which Meta identity (connection) opens the account
forceFacultatifbooleancreate even though this identity already has an ad account
account_idFacultatifstringoptional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.