Yandex Direct araçları
Yandex Direct hesapları, kampanyalar ve performans raporu; durum ve haftalı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_yandex_clients
Okuma1 krediBağlı oturumla erişilen Yandex Direct hesapları: ajansın müşterileri, ajans değilse bağlı hesabın kendisi. Kullanıcı adı (account_id), ad, para birimi, tür ve arşiv bayrağını döndürür. Salt okunur; Yandex bağlı değilse connected=false döner.
Bu araç parametre almaz.
list_yandex_campaigns
Okuma1 krediYandex Direct kampanyaları: id, ad, tür, durum, statü, teklif stratejisi ve haftalık bütçe, son N güne ait harcama, gösterim, tıklama ve dönüşümlerle birlikte. İstatistik raporu hâlâ kuyruktaysa stats boş kalır ve stats_ready=false döner. Salt okunur; rakam uydurmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
daysİsteğe bağlı | integer (1–365) | bugün dahil son N gün, varsayılan 30 |
stateİsteğe bağlı | on | off | suspended | ended | archived | converted | — |
yandex_performance_report
Okuma1 krediYandex Direct kampanya performans raporu: gösterim, tıklama, maliyet, CTR, ortalama CPC, dönüşüm ve dönüşüm başına maliyet; kampanya veya gün bazında. Büyük raporları Yandex kuyruğa alır: pending=true aynı argümanlarla yeniden çağırın demektir. Salt okunur; rakam uydurmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
daysİsteğe bağlı | integer (1–365) | bugün dahil son N gün, varsayılan 30 |
date_fromİsteğe bağlı | string | YYYY-MM-DD, date_to ile birlikte |
date_toİsteğe bağlı | string | YYYY-MM-DD, date_from ile birlikte |
campaign_idİsteğe bağlı | string | — |
group_byİsteğe bağlı | campaign | day | — |
include_vatİsteğe bağlı | boolean | parasal değerlere KDV'yi dahil eder, varsayılan false |
diagnose_yandex_delivery
Okuma1 krediBir Yandex Direct kampanyasının CANLI yayın tanısı. Kullanıcı kampanyanın gösterilmediğini, kapalı ya da durdurulmuş olduğunu, incelemede beklediğini ya da reddedildiğini bildirdiğinde ilk çağrılacak araçtır. Kampanyayı (durum, statü, ödeme durumu, Yandex'in durum açıklaması, teklif stratejisinin hedef ve sınırları, bakiye), reklam gruplarını (anahtar kelime inceleme durumu, gösterim durumu) ve reklamları (durum, inceleme durumu, ret metni, site bağlantısı / görsel / öğe başına inceleme), ayrıca son 7 günde değişen nesneleri okur; bir bulgu listesi (kapsam, Yandex'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 | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
campaign_idZorunlu | string | Yandex Direct kampanya id'si (list_yandex_campaigns) |
Yazma araçları3 araç
update_yandex_campaign_status
Yazma2 krediBir Yandex Direct 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 | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
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_yandex_campaign_budget
Yazma2 krediBir Yandex Direct kampanyasının haftalık bütçesini ayarlar (hesap para birimi); Yandex artık günlük kampanya bütçesi kullanmıyor. Yalnızca metin ve birleşik kampanyalar için geçerlidir; portföy, özel dönem ve öncelikli hedef stratejileri 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 | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
campaign_idZorunlu | string | — |
weekly_budgetZorunlu | number | hesap para biriminde yeni haftalık bütçe |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_yandex_campaign
Yazma5 krediYandex Direct metin kampanyası kurar (otomatik strateji: haftalık tıklama bütçesi) ve hemen durdurur — Yandex kampanyaları yayında doğurur, ayrıca 2024'ten beri yeni kampanyada manuel strateji kabul etmiyor. Bütçe HAFTALIKTIR, günlük değil. Reklam grubu ve reklam Yandex arayüzünden eklenir.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | ajans müşterisinin Yandex kullanıcı adı (Client-Login olarak gönderilir); varsayılan: bağlantıda seçili hesap veya bağlı hesabın kendisi |
nameZorunlu | string | — |
weekly_budgetZorunlu | number | hesap para biriminde; Yandex bütçeleri HAFTALIKTIR |
placementİsteğe bağlı | search_only | search_and_network | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD, not in the past |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.