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

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 kredi

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

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

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

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

ParametreTipAçıklama
account_idİsteğe bağlıstringajans 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ıstringYYYY-MM-DD, date_to ile birlikte
date_toİsteğe bağlıstringYYYY-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ıbooleanparasal değerlere KDV'yi dahil eder, varsayılan false

diagnose_yandex_delivery

Okuma1 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringajans 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_idZorunlustringYandex Direct kampanya id'si (list_yandex_campaigns)

Yazma araçları3 araç

update_yandex_campaign_status

Yazma2 kredi

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

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

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

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

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

ParametreTipAçıklama
account_idİsteğe bağlıstringajans 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
nameZorunlustring—
weekly_budgetZorunlunumberhesap para biriminde; Yandex bütçeleri HAFTALIKTIR
placementİsteğe bağlısearch_only | search_and_network—
start_dateİsteğe bağlıstringYYYY-MM-DD, not in the past
end_dateİsteğe bağlıstringYYYY-MM-DD

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