İçeriğe geç
Tecrübetecrube.com
Asistan araçları · Kurulum ve kampanya

Meta araçları

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

Onay sürecinde — yakında

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 kredi

Bağ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 kredi

Bir 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.

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
date_presetİsteğe bağlıtoday | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_monthinstead 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 | regionplacement = publisher_platform + platform_position; device = impression_device
conversion_eventİsteğe bağlıpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clickdö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ıstringoptional: 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 kredi

Instagram 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.

ParametreTipAçıklama
placementİsteğe bağlıstringall | 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_clickdö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ı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>—
account_idİsteğe bağlıstringoptional: 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 kredi

Meta 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.

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: 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 kredi

Meta'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.

ParametreTipAçı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 | demographicinterest (default) or a detailed-targeting category
category_classİsteğe bağlıstringraw adTargetingCategory class, overrides kind
account_idİsteğe bağlıstringoptional: 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 kredi

Harcama 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.

ParametreTipAçıklama
targetingZorunluobject—
optimization_goalİsteğe bağlıstringREACH (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ıstringoptional: 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 kredi

Meta reklam setleri: durum, günlük/toplam bütçe (hesap para birimi), teklif, optimizasyon hedefi, hedefleme ve zamanlama.

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
adset_idsİsteğe bağlıarray<string>—
account_idİsteğe bağlıstringoptional: 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 kredi

Bağ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.

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_conversations

Okuma1 kredi

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.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçı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ıstringoptional: 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 kredi

Facebook 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.

ParametreTipAçıklama
page_idİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Tek 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.

ParametreTipAçıklama
form_idZorunlustring—
page_idİsteğe bağlıstring—
daysİsteğe bağlıinteger (1–90)—
account_idİsteğe bağlıstringoptional: 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 kredi

Kullanı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.

ParametreTipAçıklama
business_idİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
catalog_idZorunlustringMeta ürün kataloğu id'si (list_meta_catalogs)
queryİsteğe bağlıstringad şunu içerir
review_statusİsteğe bağlıapproved | rejected | pending | outdated—
filterİsteğe bağlıobjectGraph ürün filtresi, ör. {"retailer_id": {"eq": "SKU1"}}
limitİsteğe bağlıinteger (1–1000)—
account_idİsteğe bağlıstringoptional: 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 kredi

Katalog 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.

ParametreTipAçıklama
catalog_idZorunlustringMeta ürün kataloğu id'si (list_meta_catalogs)
account_idİsteğe bağlıstringoptional: 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 kredi

Bağ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.

ParametreTipAçıklama
promotable_onlyİsteğe bağlıbooleanyalnızca seçili reklam hesabının tanıtabileceği Sayfalar

list_meta_campaigns

Okuma1 kredi

Meta 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.

ParametreTipAçıklama
effective_statusİsteğe bağlıarray<string>ör. ACTIVE, PAUSED
account_idİsteğe bağlıstringoptional: 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 kredi

Hesabı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.

ParametreTipAçıklama
adset_idİsteğe bağlıstring—
campaign_idİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
page_idİsteğe bağlıstring—
limitİsteğe bağlıinteger (1–100)—

list_meta_pixels

Okuma1 kredi

Reklam hesabının Meta pikselleri (veri kümeleri), ad ve son tetiklenme zamanıyla. Salt okunur.

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: 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 kredi

Hazı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.

ParametreTipAçıklama
fieldsZorunluarray<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ıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
time_incrementİsteğe bağlıstring1 = 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ıstringoptional: 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 kredi

Reklamlarda 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 kredi

Kayıtlı kitleler (Ads Manager'daki yeniden kullanılabilir hedefleme ön ayarları), hedefleme ve yaklaşık boyutla. Salt okunur.

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: 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 kredi

Reklam hesabının özel dönüşümleri: id, ad, kural (URL / olay), olay türü, piksel, son tetiklenme, varsayılan değer. Salt okunur.

ParametreTipAçıklama
include_archivedİsteğe bağlıboolean—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
campaign_idZorunlustringMeta kampanya id'si (list_meta_campaigns) ya da Tecrübe kampanya id'si
account_idİsteğe bağlıstringoptional: 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 kredi

Meta 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.

ParametreTipAçıklama
sinceİsteğe bağlıstringYYYY-MM-DD
untilİsteğe bağlıstringYYYY-MM-DD
daysİsteğe bağlıinteger (1–365)—
levelİsteğe bağlıstringnesne türüne göre filtrele: campaign | adset | ad | account …
limitİsteğe bağlıinteger (1–1000)—
account_idİsteğe bağlıstringoptional: 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 kredi

Mevcut 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.

ParametreTipAçıklama
adset_idZorunlustring—
optimization_goalİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçı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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
ad_idZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Seç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.

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

instagram_follower_growth

Okuma1 kredi

Bir 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.

ParametreTipAçıklama
ig_user_idİsteğe bağlıstring—
daysİsteğe bağlıinteger (1–30)—

download_meta_leads

Okuma1 kredi

Bir 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.

ParametreTipAçıklama
form_idZorunlustring—
page_idİsteğe bağlıstring—
limitİsteğe bağlıinteger (1–2000)—
sinceİsteğe bağlıstringYYYY-MM-DD
account_idİsteğe bağlıstringoptional: 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 kredi

Meta 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.

ParametreTipAçı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ıstringoptional: 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 kredi

Sonraki 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.

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

Meta 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.

ParametreTipAçıklama
nameZorunlustring—
eventZorunlustringpiksel 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ıstringoptional: 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 kredi

Bir özel hedef kitlenin bir veya daha fazla ülkede Meta benzer hedef kitlesini (%1–10) oluşturur. Önce önizleme ve onay.

ParametreTipAçıklama
nameZorunlustring—
source_audience_idZorunlustring—
countriesZorunluarray<string>ISO kodları
ratio_percentİsteğe bağlınumber (1–10)1 = en yakın %1
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
nameZorunlustring—
objectiveZorunlusales | traffic | engagement | messages | awareness—
daily_budgetİsteğe bağlınumberhesap 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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
campaign_idZorunlustringMeta kampanya id'si veya Tecrube kampanya id'si
daily_budgetİsteğe bağlınumberad account currency
lifetime_budgetİsteğe bağlınumber—
currencyİsteğe bağlıstringoptional 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ıstringLOWEST_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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
adset_idZorunlustring—
daily_budgetİsteğe bağlınumberad account currency
lifetime_budgetİsteğe bağlınumber—
currencyİsteğe bağlıstringoptional 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ıstringISO 8601
end_timeİsteğe bağlıstringISO 8601
account_idİsteğe bağlıstringoptional: 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 kredi

Kazanan 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.

ParametreTipAçıklama
adset_idZorunlustring—
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ıstringoptional: 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 kredi

CPA'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.

ParametreTipAçıklama
cpa_thresholdZorunlunumberhesap para birimi
conversion_eventİsteğe bağlıpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clickdö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ı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ıbooleanduraklatılan setlerin günlük bütçesini en iyi reklam setine taşı (varsayılan true)
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
adset_idZorunlustring—
video_idİsteğe bağlıstringMeta reklam hesabındaki video id'si
video_urlİsteğe bağlıstringpublic https video URL; Meta fetches it (instead of video_id)
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—
account_idİsteğe bağlıstringoptional: 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 kredi

Mevcut 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.

ParametreTipAçıklama
adset_idZorunlustring—
instagram_media_idİsteğe bağlıstring—
pick_bestİsteğe bağlıbooleanen ç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ıstringbunun 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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
catalog_idİsteğe bağlıstringMeta ürün kataloğu id'si (list_meta_catalogs)
product_idİsteğe bağlıstringgü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ıstringISO; 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ıstringfemale | male | unisex
materialİsteğe bağlıstring—
patternİsteğe bağlıstring—
product_typeİsteğe bağlıstringseller's own category path
additional_image_urlsİsteğe bağlıarray<string>extra product image URLs
account_idİsteğe bağlıstringoptional: 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 kredi

Meta 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.

ParametreTipAçıklama
nameZorunlustring—
catalog_idZorunlustringMeta ürün kataloğu id'si (list_meta_catalogs)
product_set_idZorunlustring—
daily_budgetİsteğe bağlınumberhesap 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ıstringoptional: 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 kredi

Facebook 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.

ParametreTipAçıklama
page_idİsteğe bağlıstring—
subscribeİsteğe bağlıbooleantrue = subscribe the Page now
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
campaign_idZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir Meta reklam setini KALICI olarak siler. Her zaman açık onay bekler ve geri alınamaz.

ParametreTipAçıklama
adset_idZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir Meta reklamını KALICI olarak siler. Her zaman açık onay bekler ve geri alınamaz.

ParametreTipAçıklama
ad_idZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir Meta özel ya da benzer kitlesini KALICI olarak siler (kopyalar, hatalar, gizlilik talepleri). Her zaman açık onay bekler ve geri alınamaz.

ParametreTipAçıklama
audience_idZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Mevcut 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.

ParametreTipAçıklama
campaign_idZorunlustring—
nameZorunlustring—
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ınumberhesap para birimi
lifetime_budgetİsteğe bağlınumber—
bid_strategyİsteğe bağlıstring—
bid_amountİsteğe bağlınumber—
targetingZorunluobject—
start_timeİsteğe bağlıstringISO 8601
end_timeİsteğe bağlıstringISO 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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
kindZorunlucampaign | adset | ad—
entity_idZorunlustring—
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ıstringreklam seti kopyası için kampanya, reklam kopyası için reklam seti
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
adset_idZorunlustring—
nameİsteğe bağlıstring—
product_set_idZorunlustring—
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ıstringoptional: 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 kredi

Tek 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.

ParametreTipAçıklama
ad_idZorunlustring—
statusİsteğe bağlıACTIVE | PAUSED | ARCHIVED—
nameİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
ad_idZorunlustring—
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ıstringherkese açık https görsel URL'si ya da Studio medya URL'si
image_hashİsteğe bağlıstringupload_meta_image çıktısından
image_base64İsteğe bağlıstringbase64 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ıstringyeni kreatif adı
account_idİsteğe bağlıstringoptional: 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 kredi

Mevcut 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.

ParametreTipAçıklama
nameZorunlustring—
campaign_aZorunlustring—
campaign_bZorunlustring—
start_timeZorunlustringISO 8601 (ofset yoksa UTC)
end_timeZorunlustringISO 8601
control_nameİsteğe bağlıstring—
treatment_nameİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Hesap 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.

ParametreTipAçı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ıstringoptional: 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 kredi

Meta 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.

ParametreTipAçıklama
catalog_idZorunlustring—
nameZorunlustring—
filterİsteğe bağlıobjectkural, ör. {"product_type": {"i_contains": "gömlek"}}; {} bütün ürünler demektir
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
nameZorunlustring—
id_typeİsteğe bağlıEMAIL | PHONE | EXTERN_ID—
identifiersZorunluarray<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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
nameZorunlustring—
product_set_idZorunlustring—
eventİsteğe bağlıstringViewContent | AddToCart | Purchase (varsayılan ViewContent)
exclude_eventİsteğe bağlıstringvarsayı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ıstringoptional: 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 kredi

Reklam 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.

ParametreTipAçıklama
nameZorunlustring—
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
nameZorunlustring—
pixel_idİsteğe bağlıstring—
url_containsİsteğe bağlıstring—
eventİsteğe bağlıstringpiksel 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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
conversion_idZorunlustring—
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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
nameZorunlustring—
sourceZorunlupage | 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ıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
page_idİsteğe bağlıstring—
nameZorunlustring—
privacy_policy_urlZorunlustring—
questionsZorunluarray<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ıbooleanbir gözden geçirme adımı ekler (yüksek niyetli form)
account_idİsteğe bağlıstringoptional: 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 kredi

Bir 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.

ParametreTipAçıklama
image_urlİsteğe bağlıstringherkese açık https görsel URL'si ya da Studio medya URL'si
image_base64İsteğe bağlıstringbase64 görsel, en fazla 5 MB
nameİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Herkese 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.

ParametreTipAçıklama
video_urlZorunlustringherkese açık https video URL'si; Meta kendisi getirir
nameİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: 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 kredi

Meta'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.

ParametreTipAçıklama
pixel_idİsteğe bağlıstring—
event_nameZorunlustring—
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ıstringpiksel 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ıstringoptional: 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 kredi

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.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
nameZorunlustringaccount name, e.g. “Acme Ads”
currencyZorunlustringpermanent; Meta-supported ISO code (TRY, USD, EUR…)
business_idİsteğe bağlıstringBusiness Manager id the account belongs to; required when the user has several
connection_idİsteğe bağlıstringoptional: which Meta identity (connection) opens the account
forceİsteğe bağlıbooleancreate even though this identity already has an ad account
account_idİsteğe bağlıstringoptional: 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.