Meta araçları
Facebook ve Instagram kampanyaları, reklam setleri, kitleler, yaratıcılar, form sonuçları ve erişim tahminleri.
Bu kanalın entegrasyonu hazır; bağlantı, platformun geliştirici uygulamamızı onaylamasıyla açılacak. Onay tamamlanana kadar hesap bağlanamaz ve bu sayfada anlatılan işlemler kullanılamaz.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları32 araç
list_meta_ad_accounts
Okuma1 krediBağlı Meta token'ıyla erişilebilen Meta reklam hesapları: id (act_…), ad, para birimi, durum, saat dilimi, toplam harcama, işletme ve hangisinin seçili olduğu. Salt okunur; Meta bağlı değilse connected=false döner.
Bu araç parametre almaz.
meta_insights_report
Okuma2 krediBir tarih aralığı için kampanya, reklam seti veya reklam düzeyinde Facebook + Instagram performansı (Meta Insights); isteğe bağlı olarak yaş, cinsiyet, yerleşim veya cihaza göre kırılımlı: harcama, gösterim, erişim, sıklık, tıklama, CTR, CPM, CPC, dönüşüm, gelir, ROAS (purchase_roas) ve CPA (cost_per_action_type). Herhangi bir metriğe göre sıralanır ve eşiklerle filtrelenir (ör. harcamaya göre sıralı roas_below=3, cpa_above=40). Yalnızca gerçek veri.
| Parametre | Tip | Açıklama |
|---|---|---|
levelİsteğe bağlı | campaign | adset | ad | — |
daysİsteğe bağlı | integer (1–1125) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
date_presetİsteğe bağlı | today | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_month | instead of days/start_date/end_date |
breakdownİsteğe bağlı | none | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | region | placement = publisher_platform + platform_position; device = impression_device |
conversion_eventİsteğe bağlı | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | dönüşüm ve CPA için kullanılan sonuç türü (varsayılan 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) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediInstagram Reels gibi bir yerleşimde en iyi performans gösteren Meta reklamları (kreatifler); ROAS, CPA, dönüşüm veya CTR'ye göre sıralı; kreatif ayrıntıları (küçük resim, video, Instagram permalink) ve çoğaltma için reklam seti id'leriyle.
| Parametre | Tip | Açıklama |
|---|---|---|
placementİsteğe bağlı | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (publisher_platform:platform_position ile eşleştirilir) |
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 | app_install | link_click | dönüşüm ve CPA için kullanılan sonuç türü (varsayılan purchase) |
daysİsteğe bağlı | integer (1–1125) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-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> | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediMeta reklam hesabının özel ve benzer hedef kitleleri: id, ad, alt tür, yaklaşık büyüklük aralığı, saklama süresi, yayın durumu.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediMeta'nın ilgi alanı taksonomisinde (hedefleme araması) anahtar kelimeyle arama: ilgi alanı id'si, ad, yol ve kitle büyüklüğü aralığı. id'ler targeting.interest_ids içinde kullanılır.
| Parametre | Tip | Açıklama |
|---|---|---|
queryİsteğe bağlı | string | — |
limitİsteğe bağlı | integer (1–100) | — |
localeİsteğe bağlı | string | ör. tr_TR, en_US |
kindİsteğe bağlı | interest | behavior | life_event | industry | family_status | income | demographic | interest (default) or a detailed-targeting category |
category_classİsteğe bağlı | string | raw adTargetingCategory class, overrides kind |
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediHarcama yapmadan önce bir hedefleme kümesi için tahmini kitle büyüklüğü (Meta yayın tahmini; olmazsa erişim tahmini): aylık aktif kullanıcı aralığı ve günlük kullanıcılar.
| Parametre | Tip | Açıklama |
|---|---|---|
targetingZorunlu | object | — |
optimization_goalİsteğe bağlı | string | REACH (varsayılan), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idİsteğe bağlı | string | — |
custom_event_typeİsteğe bağlı | string | ör. PURCHASE (pixel_id ile) |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediMeta reklam setleri: durum, günlük/toplam bütçe (hesap para birimi), teklif, optimizasyon hedefi, hedefleme ve zamanlama.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | — |
adset_idsİsteğe bağlı | array<string> | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediBağlı Instagram işletme hesabının son gönderileri; beğeni, yorum ve etkileşimle, etkileşime göre sıralı — öne çıkarılacak gönderiyi seçmek için.
| Parametre | Tip | Açı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_conversations
Okuma1 krediMessenger 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.
Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | — |
platformİsteğe bağlı | messenger | instagram | — |
limitİsteğe bağlı | integer (1–50) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediFacebook Sayfasının potansiyel müşteri (anlık) formları; durum ve potansiyel müşteri sayılarıyla. Yeni potansiyel müşteri formu oluşturma desteklenmez.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediTek bir potansiyel müşteri formu için son N günün potansiyel müşteri sayıları; güne, reklama ve platforma göre. Yalnızca sayılar; kişisel yanıtlar asla döndürülmez.
| Parametre | Tip | Açıklama |
|---|---|---|
form_idZorunlu | string | — |
page_idİsteğe bağlı | string | — |
daysİsteğe bağlı | integer (1–90) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediKullanıcının Meta işletmelerine ait ürün katalogları (Commerce Manager): id, ad, ürün sayısı, sektör, işletme. catalog_management gerektirir; Meta bağlı değilse connected=false.
| Parametre | Tip | Açıklama |
|---|---|---|
business_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediBir Meta kataloğunun ürünleri; perakendeci id'si, fiyat, stok durumu, ürün durumu, URL, görsel, inceleme durumu ve ret nedenleriyle. İnceleme durumuna ya da Graph filtresine göre filtrelenir. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
catalog_idZorunlu | string | Meta ürün kataloğu id'si (list_meta_catalogs) |
queryİsteğe bağlı | string | ad şunu içerir |
review_statusİsteğe bağlı | approved | rejected | pending | outdated | — |
filterİsteğe bağlı | object | Graph ürün filtresi, ör. {"retailer_id": {"eq": "SKU1"}} |
limitİsteğe bağlı | integer (1–1000) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediKatalog satış reklam setleri için bir Meta kataloğunun ürün setleri (id, ad, ürün sayısı, filtre) ve kataloğun ürün feed'leri son yükleme sonucuyla. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
catalog_idZorunlu | string | Meta ürün kataloğu id'si (list_meta_catalogs) |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediBağlı Meta kullanıcısının yönettiği Facebook Sayfaları (id, ad, kategori, görevler, bağlı Instagram hesabı) ya da promotable_only ile reklam hesabının reklam verebileceği Sayfalar. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
promotable_onlyİsteğe bağlı | boolean | yalnızca seçili reklam hesabının tanıtabileceği Sayfalar |
list_meta_campaigns
Okuma1 krediMeta reklam hesabındaki canlı kampanyalar (bu uygulama dışında oluşturulanlar dahil): id, ad, durum, hedef, hesap para biriminde günlük/toplam bütçe, teklif stratejisi, zamanlama. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
effective_statusİsteğe bağlı | array<string> | ör. ACTIVE, PAUSED |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediHesabın, bir reklam setinin ya da bir kampanyanın Meta reklamları: id, ad, durum, etkin durum, reklam seti, kreatif id'si ve küçük resim. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idİsteğe bağlı | string | — |
campaign_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediBir Facebook Sayfasının metin, görsel ve kalıcı bağlantıyla son gönderileri; organik bir gönderiyi reklam olarak yeniden kullanmak için (object_story_id). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | — |
limitİsteğe bağlı | integer (1–100) | — |
list_meta_pixels
Okuma1 krediReklam hesabının Meta pikselleri (veri kümeleri), ad ve son tetiklenme zamanıyla. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediHazır raporların kapsamadığı her şey için Meta Insights API'nin serbest biçimli okuması: Meta'nın desteklediği her alan, kırılım, eylem kırılımı, filtre ve zaman aralığı. Ham satırlar döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
fieldsZorunlu | array<string> | Insights alanları, ör. spend, reach, actions, video_p75_watched_actions |
levelİsteğe bağlı | account | campaign | adset | ad | — |
breakdownsİsteğe bağlı | array<string> | ör. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone |
action_breakdownsİsteğe bağlı | array<string> | ör. action_type, action_device |
daysİsteğe bağlı | integer (1–1125) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
time_incrementİsteğe bağlı | string | 1 = günlük, 7 = haftalık, monthly, all_days |
filteringİsteğe bağlı | array<object> | Graph filtreleri [{field, operator, value}] |
limitİsteğe bağlı | integer (1–5000) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediReklamlarda kullanılabilecek Instagram hesapları: reklam hesabına bağlı olanlar ve kullanıcının Facebook Sayfalarına bağlı olanlar (id, kullanıcı adı, sayfa). Salt okunur.
Bu araç parametre almaz.
list_meta_saved_audiences
Okuma1 krediKayıtlı kitleler (Ads Manager'daki yeniden kullanılabilir hedefleme ön ayarları), hedefleme ve yaklaşık boyutla. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediReklam hesabının özel dönüşümleri: id, ad, kural (URL / olay), olay türü, piksel, son tetiklenme, varsayılan değer. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
include_archivedİsteğe bağlı | boolean | — |
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediBir Meta kampanyasının CANLI yayın tanısı. Kullanıcı bir durum ya da uyarı bildirdiğinde (yayınlanmıyor, sorunlu, öğreniyor, sınırlı, reddedildi) ilk çağrılacak araçtır. Kampanyayı, reklam setlerini ve reklamlarını etkin durumlarıyla; Meta'nın yayını engellediğini bildirdiği sorunları (issues_info: düzey, hata kodu, özet, mesaj); her setin öğrenme aşamasını; teklif stratejisini, teklif tutarını, bütçeyi ve kalan bütçeyi; her reklamın inceleme sonucunu ve bir bulgu listesini döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Meta kampanya id'si (list_meta_campaigns) ya da Tecrübe kampanya id'si |
account_idİsteğe bağlı | string | optional: 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
Okuma2 krediMeta reklam hesabının etkinlik geçmişi: kim neyi ne zaman değiştirdi (bütçe, durum, hedefleme, kreatif düzenlemeleri); Meta sağladığında eski/yeni değerlerle. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
sinceİsteğe bağlı | string | YYYY-MM-DD |
untilİsteğe bağlı | string | YYYY-MM-DD |
daysİsteğe bağlı | integer (1–365) | — |
levelİsteğe bağlı | string | nesne türüne göre filtrele: campaign | adset | ad | account … |
limitİsteğe bağlı | integer (1–1000) | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediMevcut bir reklam setinin şu anki hedeflemesi için Meta'nın yayın tahmini: ulaşılabilir aylık kullanıcı, günlük kullanıcı ve beklenen sonuç eğrisi; harcama yapmadan. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
optimization_goalİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediBir Meta kreatifinin ya da reklamının önizlemesini bir yerleşim biçiminde (feed, story, reels …) yayınlamadan oluşturur; geçici bir önizleme URL'si döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
creative_idİsteğe bağlı | string | — |
ad_idİsteğe bağlı | string | — |
ad_formatİsteğe bağlı | DESKTOP_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_idİsteğe bağlı | string | optional: 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
Okuma1 krediBir reklamın mevcut kreatifini okur: başlık, ana metin, açıklama, görsel ya da video, düğme, hedef bağlantı, Sayfa / Instagram kimliği ve hangi Advantage+ kreatif özelliklerinin etkin olduğu. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediSeçili Instagram işletme hesabının medyasını tarayarak bir Instagram gönderisi ya da Reels bağlantısını medya id'sine çözer (boost_instagram_post için gerekir). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
urlZorunlu | string | — |
ig_user_idİsteğe bağlı | string | — |
instagram_follower_growth
Okuma1 krediBir Instagram işletme hesabının son en fazla 30 gündeki günlük yeni takipçileri ve mevcut takipçi sayısı; takipçi ve profil ziyareti kampanyalarını ölçmek için. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
ig_user_idİsteğe bağlı | string | — |
daysİsteğe bağlı | integer (1–30) | — |
download_meta_leads
Okuma1 krediBir Meta anında formu üzerinden gönderilen yanıtları indirir (her soru, ayrıca her potansiyel müşterinin reklamı, reklam seti ve kampanyası). Kişisel veri: leads_retrieval gerektirir; formun izni kapsamında işleyin. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
form_idZorunlu | string | — |
page_idİsteğe bağlı | string | — |
limitİsteğe bağlı | integer (1–2000) | — |
sinceİsteğe bağlı | string | YYYY-MM-DD |
account_idİsteğe bağlı | string | optional: 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
Okuma1 krediMeta hedeflemesi kurarken üç yardım: elinizdekilere yakın ilgi önerir, bir ilgi kimliğinin ya da adının hâlâ kullanılabilir olduğunu denetler (geçersiz ilgi taşıyan reklam seti reddedilir) ya da hesabın en düşük günlük bütçelerini okur. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
modeİsteğe bağlı | suggest | validate | minimum_budget | — |
interest_idsİsteğe bağlı | array<string> | — |
namesİsteğe bağlı | array<string> | — |
limit_typeİsteğe bağlı | interests | behaviors | income | life_events | — |
is_exclusionİsteğe bağlı | boolean | — |
bid_amountİsteğe bağlı | integer | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma araçları38 araç
select_meta_ad_account
Yazma1 krediSonraki tüm Meta araçlarının hangi Meta reklam hesabında çalışacağını seçer (ajans / çoklu hesap). Yalnızca kullanıcının erişebildiği hesaplar kabul edilir.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_website_audience
Yazma2 krediMeta pikselinden bir web sitesi özel hedef kitlesi oluşturur (ör. son 30 günde sepete ekleyip satın almayanlar). Önce önizleme ve onay; kitle birkaç saat içinde dolar.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
eventZorunlu | string | piksel olayı: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysİsteğe bağlı | integer (1–180) | — |
exclude_eventİsteğe bağlı | string | ör. sepeti terk edenler için Purchase |
pixel_idİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_lookalike_audience
Yazma2 krediBir özel hedef kitlenin bir veya daha fazla ülkede Meta benzer hedef kitlesini (%1–10) oluşturur. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
source_audience_idZorunlu | string | — |
countriesZorunlu | array<string> | ISO kodları |
ratio_percentİsteğe bağlı | number (1–10) | 1 = en yakın %1 |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_campaign
Yazma2 krediBir Meta kampanyasını uçtan uca (kampanya + reklam seti + sayfa ve kreatif varsa reklam) hedef, günlük bütçe ve hedeflemeyle duraklatılmış taslak olarak oluşturur. Bir ledger taslağı ve bir onay öğesi yazar; Meta'ya yalnızca onaydan sonra gönderilir.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
objectiveZorunlu | sales | traffic | engagement | messages | awareness | — |
daily_budgetİsteğe bağlı | number | hesap para birimi |
goalİsteğe bağlı | string | — |
special_ad_categoriesİsteğe bağlı | array<string> | CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES |
audienceİsteğe bağlı | object | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_meta_campaign
Yazma2 krediBir Meta kampanyasının bütçesini (günlük/toplam), durumunu, adını, teklif stratejisini veya harcama sınırını değiştirir. Önce → sonra önizlemesi; adım başına +%50'nin üzerindeki bütçe artışları engellenir. Yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Meta kampanya id'si veya Tecrube kampanya id'si |
daily_budgetİsteğe bağlı | number | ad account currency |
lifetime_budgetİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | optional ISO check; must equal the ad account currency |
statusİsteğe bağlı | ACTIVE | PAUSED | ARCHIVED | — |
nameİsteğe bağlı | string | — |
bid_strategyİsteğe bağlı | string | LOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS |
spend_capİsteğe bağlı | number | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_meta_ad_set
Yazma2 krediBir Meta reklam setinin bütçesini, durumunu, hedeflemesini (konumlar, yaş, cinsiyet, ilgi alanları, kitleler, yerleşimler), teklifini veya zamanlamasını değiştirir. Önce önizleme ve onay; bütçe koruma kuralı geçerlidir.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
daily_budgetİsteğe bağlı | number | ad account currency |
lifetime_budgetİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | optional ISO check; must equal the ad account currency |
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ı | string | ISO 8601 |
end_timeİsteğe bağlı | string | ISO 8601 |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
duplicate_meta_ad_set
Yazma2 krediKazanan bir Meta reklam setini (reklamlarıyla birlikte) duraklatılmış bir kopya olarak çoğaltır ve test için ona yeni bir ilgi alanı kitlesi, hedefleme veya bütçe verir. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
interest_idsİsteğe bağlı | array<string> | ilgi alanlarını değiştir, hedeflemenin geri kalanını koru |
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 | — |
account_idİsteğe bağlı | string | optional: 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 |
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 krediCPA'sı bir eşiğin üzerinde olan (veya en az eşik kadar harcayıp sıfır sonuç alan) aktif Meta reklam setlerini bulur, tek eylemde duraklatır ve serbest kalan günlük bütçelerini +%50 koruma kuralı içinde en iyi CPA'lı reklam setine taşır. Önce listeyi gösterir; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
cpa_thresholdZorunlu | number | hesap para birimi |
conversion_eventİsteğe bağlı | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | dönüşüm ve CPA için kullanılan sonuç türü (varsayılan purchase) |
daysİsteğe bağlı | integer (1–1125) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
min_spendİsteğe bağlı | number | — |
campaign_idsİsteğe bağlı | array<string> | — |
reallocateİsteğe bağlı | boolean | duraklatılan setlerin günlük bütçesini en iyi reklam setine taşı (varsayılan true) |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_carousel_ad
Yazma2 krediFacebook ve Instagram için bir reklam setinde Meta carousel reklamı (2–10 görsel kart, ör. beş ürün görseli) oluşturur. Studio görselleri Meta'ya yüklenir (adimages). Onaydan sonra duraklatılmış olarak oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
linkZorunlu | string | — |
messageİsteğe bağlı | string | birincil metin |
cardsZorunlu | array<object> | — |
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 | — |
optimize_card_orderİsteğe bağlı | boolean | — |
page_idİsteğe bağlı | string | — |
instagram_user_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_video_ad
Yazma2 krediBir reklam setinde mevcut bir video id'sinden Meta video reklamı oluşturur (küçük resim verilmezse videodan alınır). Onaydan sonra duraklatılmış olarak oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
video_idİsteğe bağlı | string | Meta reklam hesabındaki video id'si |
video_urlİsteğe bağlı | string | public https video URL; Meta fetches it (instead of video_id) |
linkZorunlu | string | — |
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 | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
boost_instagram_post
Yazma2 krediMevcut bir Instagram gönderisini (source_instagram_media_id) veya Facebook Sayfası gönderisini (object_story_id) bir reklam setinde reklama dönüştürür; pick_best en çok etkileşim alan son Instagram gönderisini seçer. Önce önizleme ve onay; duraklatılmış olarak oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
instagram_media_idİsteğe bağlı | string | — |
pick_bestİsteğe bağlı | boolean | en çok etkileşim alan son Instagram gönderisini kullan |
lookback_postsİsteğe bağlı | integer (1–100) | — |
facebook_post_idİsteğe bağlı | string | bunun yerine bir Sayfa gönderisini öne çıkarmak için {page_id}_{post_id} |
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 | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upsert_meta_catalog_product
Yazma2 krediBir Meta kataloğuna ürün ekler (POST /{catalog_id}/products; retailer_id, name, url, image_url, price, currency, availability gerekir) ya da mevcut bir ürünü günceller (POST /{product_id}). Önce önizleme ve onay; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
catalog_idİsteğe bağlı | string | Meta ürün kataloğu id'si (list_meta_catalogs) |
product_idİsteğe bağlı | string | güncellenecek mevcut Meta ürün id'si; oluşturmak için boş bırakılır |
retailer_idİsteğe bağlı | string | — |
nameİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
urlİsteğe bağlı | string | — |
image_urlİsteğe bağlı | string | — |
priceİsteğe bağlı | number | — |
sale_priceİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | ISO; varsayılan: reklam hesabı para birimi |
availabilityİsteğe bağlı | in stock | out of stock | preorder | available for order | discontinued | — |
conditionİsteğe bağlı | new | refurbished | used | — |
brandİsteğe bağlı | string | — |
categoryİsteğe bağlı | string | — |
gtinİsteğe bağlı | string | — |
colorİsteğe bağlı | string | — |
sizeİsteğe bağlı | string | — |
item_group_idİsteğe bağlı | string | — |
custom_label_0İsteğe bağlı | string | — |
visibilityİsteğe bağlı | published | staging | — |
custom_label_1İsteğe bağlı | string | — |
custom_label_2İsteğe bağlı | string | — |
custom_label_3İsteğe bağlı | string | — |
custom_label_4İsteğe bağlı | string | — |
genderİsteğe bağlı | string | female | male | unisex |
materialİsteğe bağlı | string | — |
patternİsteğe bağlı | string | — |
product_typeİsteğe bağlı | string | seller's own category path |
additional_image_urlsİsteğe bağlı | array<string> | extra product image URLs |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_catalog_sales_campaign
Yazma2 krediMeta katalog satış kampanyası (promoted_object.product_catalog_id ile OUTCOME_SALES hedefi) ve bir ürün setini tanıtan reklam seti (promoted_object.product_set_id, satın alma optimizasyonu) duraklatılmış taslak olarak oluşturur. Deftere taslak ve onay öğesi yazar; Meta'ya yalnızca onaydan sonra gönderilir.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
catalog_idZorunlu | string | Meta ürün kataloğu id'si (list_meta_catalogs) |
product_set_idZorunlu | string | — |
daily_budgetİsteğe bağlı | number | hesap para birimi |
countriesİsteğe bağlı | array<string> | ISO kodları, varsayılan TR |
pixel_idİsteğe bağlı | string | — |
goalİsteğe bağlı | string | — |
audienceİsteğe bağlı | object | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
meta_page_subscription
Yazma1 krediFacebook sayfasının Tecrübe webhook'una abone olup olmadığı ve hangi alanlarla (yeni Messenger / Instagram mesajları ve kayıt formu yanıtları ancak abonelik varsa gelir); subscribe=true aboneliği kurar (tekrar çağrılabilir). pages_manage_metadata gerektirir.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | — |
subscribeİsteğe bağlı | boolean | true = subscribe the Page now |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_meta_campaign
YazmaGeri alınamaz5 krediBir Meta kampanyasını KALICI olarak siler (raporlar Meta'da okunabilir kalır). Her zaman açık onay bekler ve geri alınamaz. Emin değilseniz duraklatın.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_meta_adset
YazmaGeri alınamaz5 krediBir Meta reklam setini KALICI olarak siler. Her zaman açık onay bekler ve geri alınamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_meta_ad
YazmaGeri alınamaz5 krediBir Meta reklamını KALICI olarak siler. Her zaman açık onay bekler ve geri alınamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_meta_audience
YazmaGeri alınamaz5 krediBir Meta özel ya da benzer kitlesini KALICI olarak siler (kopyalar, hatalar, gizlilik talepleri). Her zaman açık onay bekler ve geri alınamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
audience_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_adset
Yazma5 krediMevcut bir Meta kampanyasında optimizasyon hedefi, bütçe, teklif, zamanlama, tanıtılan nesne ve tam hedeflemeyle (konumlar, demografi, ayrıntılı hedefleme, kitleler, yerleşimler) duraklatılmış bir reklam seti oluşturur. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
nameZorunlu | string | — |
optimization_goalİsteğe bağlı | LINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT | — |
billing_eventİsteğe bağlı | IMPRESSIONS | LINK_CLICKS | THRUPLAY | — |
daily_budgetİsteğe bağlı | number | hesap para birimi |
lifetime_budgetİsteğe bağlı | number | — |
bid_strategyİsteğe bağlı | string | — |
bid_amountİsteğe bağlı | number | — |
targetingZorunlu | object | — |
start_timeİsteğe bağlı | string | ISO 8601 |
end_timeİsteğe bağlı | string | ISO 8601 |
pixel_idİsteğe bağlı | string | — |
custom_event_typeİsteğe bağlı | string | — |
page_idİsteğe bağlı | string | — |
destination_typeİsteğe bağlı | string | ör. WEBSITE, MESSENGER, WHATSAPP, ON_AD |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
copy_meta_entity
Yazma5 krediBir Meta kampanyasını, reklam setini ya da reklamı çoğaltır (Ads Manager 'Çoğalt'); isteğe bağlı olarak alt öğeleriyle ve başka bir üst öğeye. Kopya her zaman duraklatılmıştır. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
kindZorunlu | campaign | adset | ad | — |
entity_idZorunlu | string | — |
deep_copyİsteğe bağlı | boolean | — |
rename_prefixİsteğe bağlı | string | — |
rename_suffixİsteğe bağlı | string | — |
target_parent_idİsteğe bağlı | string | reklam seti kopyası için kampanya, reklam kopyası için reklam seti |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_link_ad
Yazma8 krediBir reklam setinde görsel URL'sinden, yüklenmiş görsel hash'inden ya da base64 görselden; ana metin, başlık ve düğmeyle tek görselli bir Meta bağlantı reklamı (kreatif + reklam) oluşturur. Onaydan sonra duraklatılmış olarak oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
linkZorunlu | string | — |
messageİsteğe bağlı | string | ana metin |
headlineİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
image_urlİsteğe bağlı | string | herkese açık https görsel URL'si ya da Studio medya URL'si |
image_hashİsteğe bağlı | string | upload_meta_image'dan |
image_base64İsteğe bağlı | string | base64 görsel, en fazla 5 MB |
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 | — |
page_idİsteğe bağlı | string | — |
instagram_user_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_dynamic_ad
Yazma8 krediBir katalog satışları reklam setinde, kendini katalog ürün setinden ({{product.name}}, {{product.price}}) dolduran dinamik ürün reklamı oluşturur. Onaydan sonra duraklatılmış olarak oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
adset_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
product_set_idZorunlu | string | — |
messageİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | şablon metin, varsayılan {{product.price}} |
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 | — |
fallback_linkİsteğe bağlı | string | — |
page_idİsteğe bağlı | string | — |
instagram_user_idİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_meta_ad
Yazma5 krediTek bir Meta reklamını duraklatır, sürdürür, arşivler ya da yeniden adlandırır. Önce → sonra önizlemesi; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | ARCHIVED | — |
nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_meta_ad_creative
Yazma5 krediBir bağlantı reklamının kreatifini (görsel, metin, bağlantı, düğme) reklamı silmeden değiştirir: mevcut kreatif artı değişikliklerinizden yeni bir kreatif oluşturulup yerine konur; böylece reklam id'sini ve geçmişini korur. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
messageİsteğe bağlı | string | — |
headlineİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
linkİsteğe bağlı | string | — |
image_urlİsteğe bağlı | string | herkese açık https görsel URL'si ya da Studio medya URL'si |
image_hashİsteğe bağlı | string | upload_meta_image çıktısından |
image_base64İsteğe bağlı | string | base64 görsel, en fazla 5 MB |
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 | — |
page_idİsteğe bağlı | string | — |
nameİsteğe bağlı | string | yeni kreatif adı |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_ab_test
Yazma5 krediMevcut iki kampanyayı bir süre boyunca çakışmayan kitlelerde 50/50 çalıştıran ve adil bir kazanan bildiren Meta bölünmüş testi oluşturur. Business Manager gerektirir. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
campaign_aZorunlu | string | — |
campaign_bZorunlu | string | — |
start_timeZorunlu | string | ISO 8601 (ofset yoksa UTC) |
end_timeZorunlu | string | ISO 8601 |
control_nameİsteğe bağlı | string | — |
treatment_nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_meta_account_controls
Yazma2 krediHesap düzeyinde marka güvenliği: Meta reklam hesabındaki BÜTÜN kampanyaları bağlayan kitle ve yerleşim kısıtlarını okur ya da yazar (yaş alt sınırı, hariç tutulan ülkeler, Audience Network veya Marketplace gibi kapatılan yerleşimler). Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | get | set | — |
age_minİsteğe bağlı | integer (13–65) | — |
placement_exclusionsİsteğe bağlı | array<string> | kapatılacak yerleşimler: AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN |
countriesİsteğe bağlı | array<string> | — |
excluded_countriesİsteğe bağlı | array<string> | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_product_set
Yazma2 krediMeta katalogunda kurala göre ürün seti oluşturur (marka, ürün türü, fiyat, stok durumu, özel etiketler…); katalog satış reklam setinin ürün kümesi olarak kullanılır. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
catalog_idZorunlu | string | — |
nameZorunlu | string | — |
filterİsteğe bağlı | object | kural, ör. {"product_type": {"i_contains": "gömlek"}}; {} bütün ürünler demektir |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_customer_file_audience
Yazma5 krediBir müşteri listesinden Meta özel kitlesi oluşturur (customaudiences + users). Değerler, herhangi bir şey saklanmadan ya da gönderilmeden önce Tecrübe içinde normalleştirilir ve SHA-256 ile karma hâline getirilir; önizleme yalnızca sayıları gösterir. Reklam hesabının Özel Kitle Koşulları'nı kabul etmiş olması gerekir. Önce onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
id_typeİsteğe bağlı | EMAIL | PHONE | EXTERN_ID | — |
identifiersZorunlu | array<string> | e-postalar, ülke kodlu telefonlar ya da kendi müşteri kimlikleriniz; SHA-256 ile zaten karma hâline getirilmiş değerler de kabul edilir |
descriptionİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_product_audience
Yazma5 krediBir katalog ürün setinden yeniden pazarlama kitlesi oluşturur (ör. son 30 günde ürüne bakıp satın almayanlar). Katalog satışları reklam setinin kitlesi olarak kullanılır. Önce onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
product_set_idZorunlu | string | — |
eventİsteğe bağlı | string | ViewContent | AddToCart | Purchase (varsayılan ViewContent) |
exclude_eventİsteğe bağlı | string | varsayılan Purchase; hiçbirini hariç tutmamak için boş bırakın |
retention_daysİsteğe bağlı | integer (1–180) | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_pixel
Yazma2 krediReklam hesabında yeni bir Meta pikseli (veri kümesi) oluşturur ve siteye eklenecek pixel_id'yi döndürür. Önce list_meta_pixels'e bakın: Meta bir hesabın kaç piksele sahip olabileceğini sınırlar. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_custom_conversion
Yazma2 krediBir Meta pikselinde URL kuralından ve/veya bir olaydan özel dönüşüm oluşturur (ör. URL /thank-you içerir). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
pixel_idİsteğe bağlı | string | — |
url_containsİsteğe bağlı | string | — |
eventİsteğe bağlı | string | piksel olayı, ör. PageView, Purchase |
custom_event_typeİsteğe bağlı | PURCHASE | 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_valueİsteğe bağlı | number | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_meta_custom_conversion
Yazma2 krediBir Meta özel dönüşümünü yeniden adlandırır ya da açıklamasını / varsayılan değerini değiştirir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
descriptionİsteğe bağlı | string | — |
default_conversion_valueİsteğe bağlı | number | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_engagement_audience
Yazma5 krediBir Facebook Sayfası, Instagram işletme profili ya da potansiyel müşteri formuyla etkileşimden Meta yeniden hedefleme kitlesi oluşturur (ör. açtı ama göndermedi). Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
sourceZorunlu | page | instagram | lead_form | — |
source_idİsteğe bağlı | string | — |
eventİsteğe bağlı | string | ör. page_engaged, ig_business_profile_engaged, lead_generation_opened |
retention_daysİsteğe bağlı | integer (1–730) | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_lead_form
Yazma5 krediBir Facebook Sayfasında standart ve özel sorular, giriş, gizlilik politikası ve teşekkür ekranıyla anında (potansiyel müşteri) form oluşturur; potansiyel müşteri reklamı için form id'sini döndürür. Önce önizleme ve onay.
| Parametre | Tip | Açıklama |
|---|---|---|
page_idİsteğe bağlı | string | — |
nameZorunlu | string | — |
privacy_policy_urlZorunlu | string | — |
questionsZorunlu | array<object> | — |
follow_up_urlİsteğe bağlı | string | — |
intro_headlineİsteğe bağlı | string | — |
intro_descriptionİsteğe bağlı | string | — |
thank_you_textİsteğe bağlı | string | — |
localeİsteğe bağlı | string | ör. tr_TR |
higher_intentİsteğe bağlı | boolean | bir gözden geçirme adımı ekler (yüksek niyetli form) |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_meta_image
Yazma1 krediBir görseli Meta reklam hesabının görsel kütüphanesine yükler ve reklamlarda yeniden kullanmak için image_hash'ini verir. Harici URL'ler yalnızca herkese açık internetten getirilir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
image_urlİsteğe bağlı | string | herkese açık https görsel URL'si ya da Studio medya URL'si |
image_base64İsteğe bağlı | string | base64 görsel, en fazla 5 MB |
nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_meta_video
Yazma3 krediHerkese açık bir URL'den Meta reklam hesabına video ekler (Meta videoyu kendisi getirir) ve create_meta_video_ad için video_id'sini verir. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
video_urlZorunlu | string | herkese açık https video URL'si; Meta kendisi getirir |
nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
send_meta_conversion_event
Yazma1 krediMeta'ya sunucu taraflı bir dönüşüm olayı gönderir (Conversions API), ör. çevrimdışı ya da CRM satışı. E-posta, telefon ve harici id saklanmadan veya gönderilmeden önce SHA-256 ile karma hâline getirilir. Önce Events Manager'da kontrol etmek için test_event_code kullanın. Önce önizleme ve onaydan geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
pixel_idİsteğe bağlı | string | — |
event_nameZorunlu | string | — |
emailİsteğe bağlı | string | — |
phoneİsteğe bağlı | string | — |
external_idİsteğe bağlı | string | — |
valueİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | — |
event_idİsteğe bağlı | string | piksel ile paylaşılan tekilleştirme id'si |
event_source_urlİsteğe bağlı | string | — |
action_sourceİsteğe bağlı | website | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other | — |
fbcİsteğe bağlı | string | — |
fbpİsteğe bağlı | string | — |
test_event_codeİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_meta_ad_account
YazmaGeri alınamaz2 krediCreate 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.
Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | account name, e.g. “Acme Ads” |
currencyZorunlu | string | permanent; Meta-supported ISO code (TRY, USD, EUR…) |
business_idİsteğe bağlı | string | Business Manager id the account belongs to; required when the user has several |
connection_idİsteğe bağlı | string | optional: which Meta identity (connection) opens the account |
forceİsteğe bağlı | boolean | create even though this identity already has an ad account |
account_idİsteğe bağlı | string | optional: 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.