Tecrübetecrube.com
Référence des outils — Publicité

Meta tools

Facebook and Instagram campaigns, ad sets, audiences, creatives, lead form results and reach estimates.

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.

Outils de lecture10 outils

list_meta_ad_accounts

Lecture1 crédits

Meta ad accounts reachable with the connected Meta token: id (act_…), name, currency, status, timezone, lifetime spend, business, and which one is selected. Read only; connected=false when Meta is not linked.

Cet outil ne prend aucun paramètre.

meta_insights_report

Lecture2 crédits

Facebook + Instagram performance (Meta Insights) at campaign, ad set or ad level for a date range, optionally broken down by age, gender, placement or device: spend, impressions, reach, frequency, clicks, CTR, CPM, CPC, conversions, revenue, ROAS (purchase_roas) and CPA (cost_per_action_type). Sort by any metric and filter with thresholds (e.g. roas_below=3 sorted by spend, cpa_above=40). Real data only.

ParamètreTypeDescription
levelFacultatifcampaign | adset | ad—
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
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 | link_clickresult type used for conversions and CPA (default purchase)
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)—

meta_top_creatives

Lecture2 crédits

Best-performing Meta ads (creatives) in a placement such as Instagram Reels, ranked by ROAS, CPA, conversions or CTR, with creative details (thumbnail, video, Instagram permalink) and their ad set ids for duplication.

ParamètreTypeDescription
placementFacultatifstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position)
metricFacultatifroas | cpa | conversions | ctr | spend | revenue—
conversion_eventFacultatifpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
limitFacultatifinteger (1–25)—
min_spendFacultatifnumber—
campaign_idsFacultatifarray<string>—

list_meta_audiences

Lecture1 crédits

Custom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.

Cet outil ne prend aucun paramètre.

search_meta_interests

Lecture1 crédits

Search Meta's interest taxonomy (targeting search) by keyword: interest id, name, path and audience size range. Use the ids in targeting.interest_ids.

ParamètreTypeDescription
queryObligatoirestring—
limitFacultatifinteger (1–100)—
localeFacultatifstringe.g. tr_TR, en_US

meta_reach_estimate

Lecture2 crédits

Estimated audience size for a targeting set before spending (Meta delivery estimate, falling back to reach estimate): monthly active users range and daily users.

ParamètreTypeDescription
targetingObligatoireobject—
optimization_goalFacultatifstringREACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idFacultatifstring—
custom_event_typeFacultatifstringe.g. PURCHASE (with pixel_id)

list_meta_ad_sets

Lecture1 crédits

Meta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.

ParamètreTypeDescription
campaign_idFacultatifstring—
adset_idsFacultatifarray<string>—

list_meta_instagram_posts

Lecture1 crédits

Recent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.

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

list_meta_lead_forms

Lecture1 crédits

Lead (instant) forms of the Facebook Page with status and lead counts. Creating new lead forms is not supported.

ParamètreTypeDescription
page_idFacultatifstring—

meta_lead_form_summary

Lecture2 crédits

Lead counts for one lead form over the last N days, by day, by ad and by platform. Counts only; personal answers are never returned.

ParamètreTypeDescription
form_idObligatoirestring—
page_idFacultatifstring—
daysFacultatifinteger (1–90)—

Outils d'écriture11 outils

select_meta_ad_account

Écriture1 crédits

Choose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.

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

Create a website custom audience from the Meta pixel (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience populates within hours.

ParamètreTypeDescription
nameObligatoirestring—
eventObligatoirestringpixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysFacultatifinteger (1–180)—
exclude_eventFacultatifstringe.g. Purchase for cart abandoners
pixel_idFacultatifstring—
descriptionFacultatifstring—

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

Create a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Preview and approval first.

ParamètreTypeDescription
nameObligatoirestring—
source_audience_idObligatoirestring—
countriesObligatoirearray<string>ISO codes
ratio_percentFacultatifnumber (1–10)1 = closest 1%

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

Create a Meta campaign end to end (campaign + ad set + ad when a page and creative exist) as a paused draft with objective, daily budget and targeting. Writes a ledger draft and an approval item; sent to Meta only after approval.

ParamètreTypeDescription
nameObligatoirestring—
objectiveObligatoiresales | traffic | engagement | messages | awareness—
daily_budgetFacultatifnumberaccount currency
goalFacultatifstring—
audienceFacultatifobject—

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

Change a Meta campaign's budget (daily/lifetime), status, name, bid strategy or spend cap. Preview with before → after; budget increases above +50% per step are blocked. Applied only after approval.

ParamètreTypeDescription
campaign_idObligatoirestringMeta campaign id or Tecrube campaign id
daily_budgetFacultatifnumber—
lifetime_budgetFacultatifnumber—
statusFacultatifACTIVE | PAUSED | ARCHIVED—
nameFacultatifstring—
bid_strategyFacultatifstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capFacultatifnumber—

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

Change a Meta ad set's budget, status, targeting (locations, age, gender, interests, audiences, placements), bid or schedule. Preview and approval first; the budget guardrail applies.

ParamètreTypeDescription
adset_idObligatoirestring—
daily_budgetFacultatifnumber—
lifetime_budgetFacultatifnumber—
statusFacultatifACTIVE | PAUSED | ARCHIVED—
nameFacultatifstring—
bid_strategyFacultatifstring—
bid_amountFacultatifnumber—
targetingFacultatifobject—
start_timeFacultatifstringISO 8601
end_timeFacultatifstringISO 8601

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

Duplicate a winning Meta ad set (with its ads) as a paused copy and give it a new interest audience, targeting or budget for a test. Preview and approval first.

ParamètreTypeDescription
adset_idObligatoirestring—
interest_idsFacultatifarray<string>replace interests, keep the rest of the targeting
targetingFacultatifobject—
daily_budgetFacultatifnumber—
nameFacultatifstring—
bid_amountFacultatifnumber—
start_timeFacultatifstring—
end_timeFacultatifstring—
deep_copyFacultatifboolean—
rename_suffixFacultatifstring—
target_campaign_idFacultatifstring—

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

Find active Meta ad sets whose CPA is above a threshold (or that spent at least the threshold with zero results), pause them in one action and move their freed daily budget to the best-CPA ad set within the +50% guardrail. Shows the list first; applied only after approval.

ParamètreTypeDescription
cpa_thresholdObligatoirenumberaccount currency
conversion_eventFacultatifpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysFacultatifinteger (1–1125)—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
min_spendFacultatifnumber—
campaign_idsFacultatifarray<string>—
reallocateFacultatifbooleanmove the paused sets' daily budget to the best ad set (default true)

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

Create a Meta video ad from an existing video id in an ad set (thumbnail taken from the video when not given). Created paused after approval.

ParamètreTypeDescription
adset_idObligatoirestring—
video_idObligatoirestringvideo id in the Meta ad account
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—

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

Turn an existing Instagram post (source_instagram_media_id) or Facebook Page post (object_story_id) into an ad in an ad set; pick_best chooses the most engaging recent Instagram post. Preview and approval first; created paused.

ParamètreTypeDescription
adset_idObligatoirestring—
instagram_media_idFacultatifstring—
pick_bestFacultatifbooleanuse the most engaging recent Instagram post
lookback_postsFacultatifinteger (1–100)—
facebook_post_idFacultatifstring{page_id}_{post_id} to boost a Page post instead
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—

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