Tecrübetecrube.com
Araç referansı — Reklam

Meta araçları

Facebook ve Instagram kampanyaları, reklam setleri, kitleler, yaratıcılar, form sonuçları ve erişim tahminleri.

Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü özgün İngilizce metinlerdir.

Okuma araçları10 araç

list_meta_ad_accounts

Okuma1 kredi

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.

Bu araç parametre almaz.

meta_insights_report

Okuma2 kredi

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.

ParametreTipAçıklama
levelİsteğe bağlıcampaign | adset | ad—
daysİsteğe bağlıinteger (1–1125)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
breakdownİsteğe bağlınone | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | regionplacement = publisher_platform + platform_position; device = impression_device
conversion_eventİsteğe bağlıpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
campaign_idsİsteğe bağlıarray<string>—
adset_idsİsteğe bağlıarray<string>—
ad_idsİsteğe bağlıarray<string>—
sort_byİsteğe bağlıspend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc—
sort_orderİsteğe bağlıdesc | asc—
min_spendİsteğe bağlınumber—
roas_belowİsteğe bağlınumber—
roas_aboveİsteğe bağlınumber—
cpa_aboveİsteğe bağlınumber—
cpa_belowİsteğe bağlınumber—
frequency_aboveİsteğe bağlınumber—
limitİsteğe bağlıinteger (1–500)—

meta_top_creatives

Okuma2 kredi

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.

ParametreTipAçıklama
placementİsteğe bağlıstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position)
metricİsteğe bağlıroas | cpa | conversions | ctr | spend | revenue—
conversion_eventİsteğe bağlıpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysİsteğe bağlıinteger (1–1125)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
limitİsteğe bağlıinteger (1–25)—
min_spendİsteğe bağlınumber—
campaign_idsİsteğe bağlıarray<string>—

list_meta_audiences

Okuma1 kredi

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

Bu araç parametre almaz.

search_meta_interests

Okuma1 kredi

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

ParametreTipAçıklama
queryZorunlustring—
limitİsteğe bağlıinteger (1–100)—
localeİsteğe bağlıstringe.g. tr_TR, en_US

meta_reach_estimate

Okuma2 kredi

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

ParametreTipAçıklama
targetingZorunluobject—
optimization_goalİsteğe bağlıstringREACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idİsteğe bağlıstring—
custom_event_typeİsteğe bağlıstringe.g. PURCHASE (with pixel_id)

list_meta_ad_sets

Okuma1 kredi

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

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
adset_idsİsteğe bağlıarray<string>—

list_meta_instagram_posts

Okuma1 kredi

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

ParametreTipAçıklama
instagram_user_idİsteğe bağlıstring—
limitİsteğe bağlıinteger (1–100)—
sort_byİsteğe bağlıengagement | recent—

list_meta_lead_forms

Okuma1 kredi

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

ParametreTipAçıklama
page_idİsteğe bağlıstring—

meta_lead_form_summary

Okuma2 kredi

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.

ParametreTipAçıklama
form_idZorunlustring—
page_idİsteğe bağlıstring—
daysİsteğe bağlıinteger (1–90)—

Yazma araçları11 araç

select_meta_ad_account

Yazma1 kredi

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

ParametreTipAçıklama
account_idZorunlustring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_meta_website_audience

Yazma2 kredi

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.

ParametreTipAçıklama
nameZorunlustring—
eventZorunlustringpixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysİsteğe bağlıinteger (1–180)—
exclude_eventİsteğe bağlıstringe.g. Purchase for cart abandoners
pixel_idİsteğe bağlıstring—
descriptionİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_meta_lookalike_audience

Yazma2 kredi

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

ParametreTipAçıklama
nameZorunlustring—
source_audience_idZorunlustring—
countriesZorunluarray<string>ISO codes
ratio_percentİsteğe bağlınumber (1–10)1 = closest 1%

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_meta_campaign

Yazma2 kredi

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.

ParametreTipAçıklama
nameZorunlustring—
objectiveZorunlusales | traffic | engagement | messages | awareness—
daily_budgetİsteğe bağlınumberaccount currency
goalİsteğe bağlıstring—
audienceİsteğe bağlıobject—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_meta_campaign

Yazma2 kredi

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.

ParametreTipAçıklama
campaign_idZorunlustringMeta campaign id or Tecrube campaign id
daily_budgetİsteğe bağlınumber—
lifetime_budgetİsteğe bağlınumber—
statusİsteğe bağlıACTIVE | PAUSED | ARCHIVED—
nameİsteğe bağlıstring—
bid_strategyİsteğe bağlıstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capİsteğe bağlınumber—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_meta_ad_set

Yazma2 kredi

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.

ParametreTipAçıklama
adset_idZorunlustring—
daily_budgetİsteğe bağlınumber—
lifetime_budgetİsteğe bağlınumber—
statusİsteğe bağlıACTIVE | PAUSED | ARCHIVED—
nameİsteğe bağlıstring—
bid_strategyİsteğe bağlıstring—
bid_amountİsteğe bağlınumber—
targetingİsteğe bağlıobject—
start_timeİsteğe bağlıstringISO 8601
end_timeİsteğe bağlıstringISO 8601

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

duplicate_meta_ad_set

Yazma2 kredi

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.

ParametreTipAçıklama
adset_idZorunlustring—
interest_idsİsteğe bağlıarray<string>replace interests, keep the rest of the targeting
targetingİsteğe bağlıobject—
daily_budgetİsteğe bağlınumber—
nameİsteğe bağlıstring—
bid_amountİsteğe bağlınumber—
start_timeİsteğe bağlıstring—
end_timeİsteğe bağlıstring—
deep_copyİsteğe bağlıboolean—
rename_suffixİsteğe bağlıstring—
target_campaign_idİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

pause_meta_ad_sets_above_cpa

Yazma2 kredi

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.

ParametreTipAçıklama
cpa_thresholdZorunlunumberaccount currency
conversion_eventİsteğe bağlıpurchase | lead | add_to_cart | complete_registration | messaging | link_clickresult type used for conversions and CPA (default purchase)
daysİsteğe bağlıinteger (1–1125)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
min_spendİsteğe bağlınumber—
campaign_idsİsteğe bağlıarray<string>—
reallocateİsteğe bağlıbooleanmove the paused sets' daily budget to the best ad set (default true)

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_meta_video_ad

Yazma2 kredi

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.

ParametreTipAçıklama
adset_idZorunlustring—
video_idZorunlustringvideo id in the Meta ad account
linkZorunlustring—
nameİsteğe bağlıstring—
messageİsteğe bağlıstring—
titleİsteğe bağlıstring—
call_to_actionİsteğe bağlıLEARN_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_urlİsteğe bağlıstring—
page_idİsteğe bağlıstring—
instagram_user_idİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

boost_instagram_post

Yazma2 kredi

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.

ParametreTipAçıklama
adset_idZorunlustring—
instagram_media_idİsteğe bağlıstring—
pick_bestİsteğe bağlıbooleanuse the most engaging recent Instagram post
lookback_postsİsteğe bağlıinteger (1–100)—
facebook_post_idİsteğe bağlıstring{page_id}_{post_id} to boost a Page post instead
linkİsteğe bağlıstring—
call_to_actionİsteğe bağlıLEARN_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—
nameİsteğe bağlıstring—
instagram_user_idİsteğe bağlıstring—
page_idİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.