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

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 kredi

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

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

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

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

ParametreTipAçıklama
account_idİsteğe bağlıstringPinterest 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ıstringYYYY-MM-DD (UTC), en çok 90 gün geriye; end_date ile kullanılır
end_dateİsteğe bağlıstringYYYY-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 kredi

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

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

Yazma araçları5 araç

update_pinterest_campaign_status

Yazma2 kredi

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

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

Yazma2 kredi

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

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

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

create_pinterest_campaign

Yazma5 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringPinterest reklam hesabı kimliği; varsayılan: bağlantıda seçili hesap
nameZorunlustring—
daily_budgetZorunlunumber—
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ıstringtanı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ıobjectcountries, 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 kredi

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

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

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

ParametreTipAçıklama
account_idİsteğe bağlıstringPinterest 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ıobjectaudience 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.