Pinterest araçları
Pinterest reklam hesapları, kampanyalar ve performans raporu; durum ve 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_pinterest_ad_accounts
Okuma1 krediBağlı Pinterest oturumuyla erişilen Pinterest Ads hesapları: account_id, ad, para birimi, ülke, saat dilimi, izinler ve hangisinin seçili olduğu. Salt okunur; Pinterest bağlı değilse connected=false döner.
Bu araç parametre almaz.
list_pinterest_campaigns
Okuma1 krediHesabın Pinterest Ads kampanyaları: id, ad, durum, hedef, günlük ve toplam bütçe (hesap para birimi), ayrıca son N gündeki (en çok 90) harcama, ücretli gösterim, ücretli tıklama ve dönüşümler. Varsayılan olarak etkin ve duraklatılmış kampanyalar listelenir. Salt okunur; null metrik Pinterest'in değer döndürmediği anlamına gelir, rakam asla uydurulmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
daysİsteğe bağlı | integer (1–90) | UTC'ye göre bugün dahil son N gün (varsayılan 30) |
statusİsteğe bağlı | active | paused | archived | draft | — |
pinterest_performance_report
Okuma1 krediHesap veya kampanya bazında Pinterest Ads performansı: harcama (hesap para birimi), ücretli gösterim, ücretli tıklama, dönüşüm, CTR ve CPC; toplam olarak ya da gün, hafta veya ay kırılımıyla, en çok 90 gün. Salt okunur; rakam asla uydurulmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
daysİsteğe bağlı | integer (1–90) | UTC'ye göre bugün dahil son N gün (varsayılan 30) |
start_dateİsteğe bağlı | string | YYYY-MM-DD (UTC), en çok 90 gün geriye; end_date ile kullanılır |
end_dateİsteğe bağlı | string | YYYY-MM-DD (UTC), start_date'ten en çok 90 gün sonra |
levelİsteğe bağlı | account | campaign | — |
granularityİsteğe bağlı | total | day | week | month | — |
campaign_idsİsteğe bağlı | array<string> | yalnızca level=campaign ile; varsayılan: hesabın etkin ve duraklatılmış kampanyaları |
diagnose_pinterest_delivery
Okuma1 krediBir Pinterest Ads kampanyasının CANLI yayın tanısı. Kullanıcı kampanyanın yayınlanmadığını, duraklatıldığını, beklediğini ya da reddedildiğini bildirdiğinde ilk çağrılacak araçtır. Kampanyayı, reklam gruplarını (özet durum, bütçe, teklif stratejisi, teklif, EBM hedefi, öğrenme modu) ve reklamlarını (inceleme durumu, ret nedenleri) okur; bir bulgu listesi (kapsam, Pinterest'in kodu, kategori, kanıt) ve API'nin vermediği bilgiler için cannot_read döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
campaign_idZorunlu | string | Pinterest kampanya id'si (list_pinterest_campaigns) |
Yazma araçları5 araç
update_pinterest_campaign_status
Yazma2 krediBir Pinterest 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 | Pinterest 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_pinterest_campaign_budget
Yazma2 krediBir Pinterest Ads kampanyasının günlük bütçesini ayarlar (hesap para birimi). Yalnızca kampanya düzeyinde günlük bütçesi olan kampanyalarda çalışır; toplam bütçeli ve bütçesi reklam grubunda olan kampanyalar reddedilir. Değişiklik başına %50'nin veya 24 saat içinde 2 katının üzerindeki artışlar engellenir; undo_action ile geri alınabilir.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest 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 |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_pinterest_campaign
Yazma5 krediPinterest kampanyasını reklam grubuyla, pin kimliği verildiyse reklamıyla birlikte kurar; üçü de duraklatılmış açılır. Günlük bütçe reklam grubundadır (Pinterest'in CBO olmayan akışı). Kullanıcı istediğinde uygulanır; yayına almak için update_pinterest_campaign_status.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
nameZorunlu | string | — |
daily_budgetZorunlu | number | — |
objective_typeİsteğe bağlı | AWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS | — |
billable_eventİsteğe bağlı | CLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC | — |
pin_idİsteğe bağlı | string | tanıtılacak pin; verilmezse yalnız kampanya ve reklam grubu kurulur |
creative_typeİsteğe bağlı | REGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION | — |
destination_urlİsteğe bağlı | string | — |
bidİsteğe bağlı | number | — |
placement_groupİsteğe bağlı | ALL | SEARCH | BROWSE | OTHER | — |
ad_group_nameİsteğe bağlı | string | — |
ad_nameİsteğe bağlı | string | — |
audienceİsteğe bağlı | object | countries, age_min, age_max, genders, locales |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
send_pinterest_conversion_event
Yazma1 krediPinterest'e sunucu taraflı dönüşüm olayı gönderir (Conversions API): tarayıcıdaki etiket engellense de satış ve kayıtlar ölçülür. E-posta ve telefon Tecrübe içinde normalleştirilip SHA-256 ile karma hâline getirilir; etiketle aynı event_id verilirse çift sayılmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
event_nameZorunlu | add_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe | — |
action_sourceİsteğe bağlı | web | app_android | app_ios | offline | — |
emailİsteğe bağlı | string | — |
phoneİsteğe bağlı | string | — |
external_idİsteğe bağlı | string | — |
client_ip_addressİsteğe bağlı | string | — |
client_user_agentİsteğe bağlı | string | — |
event_idİsteğe bağlı | string | Pinterest etiketiyle paylaşılan çift sayım önleme kimliği |
event_timeİsteğe bağlı | integer | — |
event_source_urlİsteğe bağlı | string | — |
valueİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | — |
order_idİsteğe bağlı | string | — |
testİsteğe bağlı | boolean | isteği doğrular ama olayı kaydetmez |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
manage_pinterest_audience
Yazma2 krediPinterest kitlesi oluşturur ya da siler: etiketten gelen site ziyaretçileri, hesapla etkileşen kişiler, müşteri listesi ya da benzer (actalike) kitle. Dolması saatler sürer. Kullanıcı istediğinde uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Pinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap |
actionİsteğe bağlı | create | delete | — |
nameİsteğe bağlı | string | — |
audience_typeİsteğe bağlı | VISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE | — |
descriptionİsteğe bağlı | string | — |
audience_idİsteğe bağlı | string | — |
ruleİsteğe bağlı | object | audience rule, e.g. {"visitor_source_id": "<tag id>"} |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.