Tecrübetecrube.com
Referencia de herramientas — Anuncios

Meta tools

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

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.

Herramientas de lectura10 herramientas

list_meta_ad_accounts

Lectura1 créditos

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.

Esta herramienta no recibe parámetros.

meta_insights_report

Lectura2 créditos

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.

ParámetroTipoDescripción
levelOpcionalcampaign | adset | ad—
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
breakdownOpcionalnone | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | regionplacement = publisher_platform + platform_position; device = impression_device
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
campaign_idsOpcionalarray<string>—
adset_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—
sort_byOpcionalspend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc—
sort_orderOpcionaldesc | asc—
min_spendOpcionalnumber—
roas_belowOpcionalnumber—
roas_aboveOpcionalnumber—
cpa_aboveOpcionalnumber—
cpa_belowOpcionalnumber—
frequency_aboveOpcionalnumber—
limitOpcionalinteger (1–500)—

meta_top_creatives

Lectura2 créditos

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.

ParámetroTipoDescripción
placementOpcionalstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position)
metricOpcionalroas | cpa | conversions | ctr | spend | revenue—
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
limitOpcionalinteger (1–25)—
min_spendOpcionalnumber—
campaign_idsOpcionalarray<string>—

list_meta_audiences

Lectura1 créditos

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

Esta herramienta no recibe parámetros.

search_meta_interests

Lectura1 créditos

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

ParámetroTipoDescripción
queryObligatoriostring—
limitOpcionalinteger (1–100)—
localeOpcionalstringe.g. tr_TR, en_US

meta_reach_estimate

Lectura2 créditos

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

ParámetroTipoDescripción
targetingObligatorioobject—
optimization_goalOpcionalstringREACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idOpcionalstring—
custom_event_typeOpcionalstringe.g. PURCHASE (with pixel_id)

list_meta_ad_sets

Lectura1 créditos

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

ParámetroTipoDescripción
campaign_idOpcionalstring—
adset_idsOpcionalarray<string>—

list_meta_instagram_posts

Lectura1 créditos

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

ParámetroTipoDescripción
instagram_user_idOpcionalstring—
limitOpcionalinteger (1–100)—
sort_byOpcionalengagement | recent—

list_meta_lead_forms

Lectura1 créditos

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

ParámetroTipoDescripción
page_idOpcionalstring—

meta_lead_form_summary

Lectura2 créditos

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.

ParámetroTipoDescripción
form_idObligatoriostring—
page_idOpcionalstring—
daysOpcionalinteger (1–90)—

Herramientas de escritura11 herramientas

select_meta_ad_account

Escritura1 créditos

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

ParámetroTipoDescripción
account_idObligatoriostring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_meta_website_audience

Escritura2 créditos

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.

ParámetroTipoDescripción
nameObligatoriostring—
eventObligatoriostringpixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysOpcionalinteger (1–180)—
exclude_eventOpcionalstringe.g. Purchase for cart abandoners
pixel_idOpcionalstring—
descriptionOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_meta_lookalike_audience

Escritura2 créditos

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

ParámetroTipoDescripción
nameObligatoriostring—
source_audience_idObligatoriostring—
countriesObligatorioarray<string>ISO codes
ratio_percentOpcionalnumber (1–10)1 = closest 1%

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_meta_campaign

Escritura2 créditos

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.

ParámetroTipoDescripción
nameObligatoriostring—
objectiveObligatoriosales | traffic | engagement | messages | awareness—
daily_budgetOpcionalnumberaccount currency
goalOpcionalstring—
audienceOpcionalobject—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_meta_campaign

Escritura2 créditos

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.

ParámetroTipoDescripción
campaign_idObligatoriostringMeta campaign id or Tecrube campaign id
daily_budgetOpcionalnumber—
lifetime_budgetOpcionalnumber—
statusOpcionalACTIVE | PAUSED | ARCHIVED—
nameOpcionalstring—
bid_strategyOpcionalstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capOpcionalnumber—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_meta_ad_set

Escritura2 créditos

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.

ParámetroTipoDescripción
adset_idObligatoriostring—
daily_budgetOpcionalnumber—
lifetime_budgetOpcionalnumber—
statusOpcionalACTIVE | PAUSED | ARCHIVED—
nameOpcionalstring—
bid_strategyOpcionalstring—
bid_amountOpcionalnumber—
targetingOpcionalobject—
start_timeOpcionalstringISO 8601
end_timeOpcionalstringISO 8601

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

duplicate_meta_ad_set

Escritura2 créditos

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.

ParámetroTipoDescripción
adset_idObligatoriostring—
interest_idsOpcionalarray<string>replace interests, keep the rest of the targeting
targetingOpcionalobject—
daily_budgetOpcionalnumber—
nameOpcionalstring—
bid_amountOpcionalnumber—
start_timeOpcionalstring—
end_timeOpcionalstring—
deep_copyOpcionalboolean—
rename_suffixOpcionalstring—
target_campaign_idOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

pause_meta_ad_sets_above_cpa

Escritura2 créditos

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.

ParámetroTipoDescripción
cpa_thresholdObligatorionumberaccount currency
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
min_spendOpcionalnumber—
campaign_idsOpcionalarray<string>—
reallocateOpcionalbooleanmove the paused sets' daily budget to the best ad set (default true)

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_meta_video_ad

Escritura2 créditos

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.

ParámetroTipoDescripción
adset_idObligatoriostring—
video_idObligatoriostringvideo id in the Meta ad account
linkObligatoriostring—
nameOpcionalstring—
messageOpcionalstring—
titleOpcionalstring—
call_to_actionOpcionalLEARN_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_urlOpcionalstring—
page_idOpcionalstring—
instagram_user_idOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

boost_instagram_post

Escritura2 créditos

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.

ParámetroTipoDescripción
adset_idObligatoriostring—
instagram_media_idOpcionalstring—
pick_bestOpcionalbooleanuse the most engaging recent Instagram post
lookback_postsOpcionalinteger (1–100)—
facebook_post_idOpcionalstring{page_id}_{post_id} to boost a Page post instead
linkOpcionalstring—
call_to_actionOpcionalLEARN_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—
nameOpcionalstring—
instagram_user_idOpcionalstring—
page_idOpcionalstring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.