Snapchat araçları
Snapchat reklam hesapları, kampanyalar ve performans raporu; durum ve günlük bütçe değişiklikleri önizleme ve onaydan geçer, geri alınabilir.
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ı4 araç
list_snapchat_ad_accounts
Okuma1 krediBağlı oturumla, kuruluşları genelinde erişilen Snapchat Ads hesapları: account_id, ad, para birimi, saat dilimi, durum, kuruluş ve hangisinin seçili olduğu. Salt okunur; Snapchat bağlı değilse connected=false döner.
Bu araç parametre almaz.
list_snapchat_campaigns
Okuma1 krediHesabın Snapchat Ads kampanyaları: id, ad, durum, hedef, günlük bütçe ve toplam harcama sınırı (hesap para birimi), zamanlama, yayın durumu, ayrıca son N tam gündeki harcama, gösterim, kaydırma ve satın alma dönüşümleri. Salt okunur; rakam uydurmaz (Snapchat döndürmediyse stats=null).
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
daysİsteğe bağlı | integer (1–31) | dünde biten son N tam gün; varsayılan 7 |
statusİsteğe bağlı | active | paused | — |
snapchat_performance_report
Okuma1 krediHesabın saat diliminde en çok 31 tam gün için Snapchat Ads performansı: toplamlar, kampanya kırılımı ve isteğe bağlı günlük satırlarla harcama, gösterim, kaydırma, satın alma, satın alma değeri ve sepete ekleme. Bugün dahil değildir. Salt okunur; rakam uydurmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
daysİsteğe bağlı | integer (1–31) | dünde biten son N tam gün; varsayılan 7 |
campaign_idİsteğe bağlı | string | raporu tek kampanyayla sınırlar |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD; en geç dün |
granularityİsteğe bağlı | total | day | varsayılan total |
diagnose_snapchat_delivery
Okuma1 krediBir Snapchat Ads kampanyasının CANLI yayın tanısı. Kullanıcı kampanyanın yayınlanmadığını, duraklatıldığını, beklediğini, sınırlı kaldığını ya da reddedildiğini bildirdiğinde ilk çağrılacak araçtır. Reklam hesabını, kampanyayı, reklam setlerini (yayın durumu kodları, bütçe, teklif stratejisi, teklif, ROAS değeri, tempo) ve reklamları (inceleme durumu ve ret nedenleri), ayrıca kampanyanın değişiklik kaydını ve Snap'in teklif tahminini okur; bir bulgu listesi (kapsam, Snap'in kodu, kategori, kanıt) ve okunamayanlar için cannot_read döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
campaign_idZorunlu | string | Snapchat kampanya id'si (list_snapchat_campaigns) |
Yazma araçları3 araç
update_snapchat_campaign_status
Yazma2 krediBir Snapchat Ads kampanyasını duraklatır veya etkinleştirir. Kullanıcı istediğinde uygulanır, denetim kaydına yazılır ve undo_action ile geri alınabilir.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
campaign_idZorunlu | string | — |
statusZorunlu | pause | activate | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_snapchat_campaign_budget
Yazma2 krediBir Snapchat Ads kampanyasının günlük bütçesini ayarlar (hesap para birimi, en az 20). Değişiklik başına %50'nin veya 24 saat içinde 2 katının üzerindeki artışlar engellenir; kampanyanın zaten günlük bütçesi varsa undo_action ile geri alınabilir.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
campaign_idZorunlu | string | — |
daily_budgetZorunlu | number | hesap para biriminde yeni günlük bütçe, en az 20 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_snapchat_campaign
Yazma5 krediSnapchat kampanyasını reklam grubuyla (hedefleme, bütçe, optimizasyon hedefi, teklif stratejisi) birlikte kurar; ikisi de duraklatılmış açılır. Reklam için önce Snapchat'e kreatif yüklenmesi gerektiğinden reklam burada kurulmaz. Kullanıcı istediğinde uygulanır; yayına almak için update_snapchat_campaign_status.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Snapchat ad account id; defaults to the connection's selected account |
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap para biriminde, en az 5 (Snapchat'in alt sınırı 5.000.000 mikro) |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES | — |
optimization_goalİsteğe bağlı | IMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS | — |
bid_strategyİsteğe bağlı | AUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST | — |
bidİsteğe bağlı | number | — |
pixel_idİsteğe bağlı | string | — |
ad_squad_nameİsteğe bağlı | string | — |
start_timeİsteğe bağlı | string | ISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z |
audienceİsteğe bağlı | object | countries, age_min, age_max, genders |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.