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

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 kredi

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

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

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

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

ParametreTipAçıklama
account_idİsteğe bağlıstringSnapchat 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ıstringraporu tek kampanyayla sınırlar
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD; en geç dün
granularityİsteğe bağlıtotal | dayvarsayılan total

diagnose_snapchat_delivery

Okuma1 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringSnapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap
campaign_idZorunlustringSnapchat kampanya id'si (list_snapchat_campaigns)

Yazma araçları3 araç

update_snapchat_campaign_status

Yazma2 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringSnapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap
campaign_idZorunlustring—
statusZorunlupause | 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 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringSnapchat reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap
campaign_idZorunlustring—
daily_budgetZorunlunumberhesap 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 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringSnapchat ad account id; defaults to the connection's selected account
nameZorunlustring—
daily_budgetZorunlunumberhesap 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ıstringISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z
audienceİsteğe bağlıobjectcountries, age_min, age_max, genders

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