Kural oluşturma

Bir Britva kuralı, girdi olarak tek bir reklam alan ve onunla ne yapılacağına karar veren küçük bir JavaScript fonksiyonudur: onu duraklatmak ya da tam tersine, etkinleştirmek. Bu makale, düzenleyicide yeni bir kuralın nasıl oluşturulacağına dair adım adım bir kılavuzdur.

Her kural bir checkAd(ad) fonksiyonudur. Onun içinde reklamın metriklerini (ad.* alanları aracılığıyla) kontrol edersiniz ve koşul karşılandığında bir eylem çağırırsınız — örneğin, bir duraklatma. Prensibin kendisi hakkında daha fazla bilgi için — Otomatik kurallar nasıl çalışır bölümüne bakın.

Kural nasıl oluşturulur

1. Britva bölümünü açın ve Kurallar sekmesinde + Yeni kural'a tıklayın.

   Yeni kural düzenleyicisi için ayrı bir sayfa açılır (açılır pencere değil).

2. Üstteki alana kuralın Ad'ını girin — kısa ve net, örneğin "Depsiz duraklat".

3. Adın yanındaki açılır menüden kuralın kapsam'ını seçin: global, team veya user. Mevcut seçenekler rolünüze bağlıdır (bkz. Alan referansı).

4. Ortadaki düzenleyicide kural kodunu yazın. Varsayılan olarak, içinde zaten checkAd(ad) fonksiyonu ve yorum satırı haline getirilmiş bir örnek bulunan bir şablon vardır:

   JavaScript

   /** @param {Ad} ad */
   function checkAd(ad) {
     // Пример: пауза при 0 депов и большом расходе.
     // if (ad.deps_total === 0 && ad.spend_24h > 100) {
     //   pauseAd('24h', 'no deps');
     // }
   }

   Örneği yorum satırı olmaktan çıkarın veya kendi mantığınızı yazın. Hangi metriklerin mevcut olduğunu hatırlamak için sağdaki Makrolar sekmesini açın — ad.* alanlarının tam referansını içerir. Herhangi bir alana tıklamak onu koda ekler.

5. (İsteğe bağlı) Kodu elle yazmak istemiyorsanız — görevi sol sütundaki AI Asistanı'na kelimelerle tarif edin ("Depozitosu olmayan ve günde 100'ün üzerinde harcayan reklamları duraklat"). Asistan, tek tıkla düzenleyiciye ekleyebileceğiniz hazır bir kod önerecektir.

   🎬 GIF: AI Asistanı'na bir istek ve önerilen kodun düzenleyiciye eklenmesi.

6. Kuralı sağdaki Test sekmesinde test edin — mevcut canlı reklamlar üzerinde çalışır ve bunlardan hangilerinin etkileneceğini gösterir. Bu güvenlidir: test sırasında hiçbir şey duraklatılmaz. Daha fazla bilgi için — Kuralı test etme bölümüne bakın.

7. Aktif anahtarının açık olduğundan emin olun ve Oluştur'a tıklayın.

   Kaydettikten sonra kural, Kurallar sekmesindeki listede görünür ve ortak kontrol döngüsünde çalışmaya başlar.

İpucu

Kuralı devre dışı olarak oluşturun (Aktif kutucuğunu temizleyin), Test sekmesinde çalıştırın ve yalnızca sonuçtan emin olduğunuzda etkinleştirin. Bu şekilde, siz onu hâlâ yapılandırırken canlı reklamlar üzerinde tetiklenmez.

Alan referansı

Alanlar, soldan sağa, kompakt bir düzenleyici başlığında toplanmıştır.

Ad — kuralın kısa adı; onu listede ve günlüklerde bununla bulacaksınız. Kaydetmek için zorunludur.

Kapsam (global / team / user) — kuralı kimin gördüğü ve hangi reklamları kontrol ettiği:

• user — kişisel kurallarınız, yalnızca sizin reklamlarınızı kontrol ederler;
• team — takım kuralları (takım liderlerine ve yöneticilere açık);
• global — herkes için ortak kurallar (yalnızca yöneticilere açık).

Seçeneklerin listesi rolünüze bağlıdır: sıradan bir buyer yalnızca user'ı görür, bir takım lideri — team ve user'ı, bir yönetici — üçünü birden. Kapsam, oluşturma sırasında belirlenir.

rank (öncelik) — kuralların sırasını belirleyen bir sayı: sayı ne kadar küçükse, öncelik o kadar yüksektir. Varsayılan değer 100'dür. Birden fazla kural tek bir reklam üzerinde hak iddia ederse, daha düşük rank'a sahip kural önce çalışır.

Aktif / Devre dışı — bir anahtar. Yalnızca aktif kurallar kontrole katılır. Devre dışı bir kural kaydedilir ancak tetiklenmez — onu hâlâ iyileştirirken kullanışlıdır.

desc — Açıklama alanını genişleten bir ok düğmesi. Serbest metin: kuralın ne yaptığı ve neden yaptığı. İsteğe bağlıdır, ancak meslektaşlarınıza ve gelecekteki kendinize yardımcı olur.

JS kodu (function checkAd(ad)) — merkezi düzenleyicideki kuralın gövdesi. Kaydetmek için zorunludur. Fonksiyonun içinde şunlara erişiminiz vardır:

• reklam alanları ad.* (harcama, depozitolar, ROAS, geo vb.) — tam liste Makrolar sekmesindedir;
• eylemler — duraklatma ve devam ettirme (bkz. Eylemler).

Minimal bir örnek — 24 saat içinde harcama varsa ancak depozito yoksa reklamı bir günlüğüne duraklat:

JavaScript

/** @param {Ad} ad */
function checkAd(ad) {
  if (ad.deps_total === 0 && ad.spend_24h > 100) {
    pauseAd('24h', 'нет депов при расходе > 100');
  }
}

Burada pauseAd('24h', 'причина') reklamın kendisini 24 saatliğine duraklatır. Ayrıca bir reklam setini (pauseAdset(...)) ve bir kampanyayı (pauseCampaign(...)) da duraklatabilirsiniz. Eylemlerin tam listesi, çağrı biçimleri ve duraklatma türleri — Eylemler bölümünde.

Dikkat

Fonksiyonun adı tam olarak checkAd olmalı ve tek bir parametre ad almalıdır. Fonksiyonun üzerindeki /** @param {Ad} ad */ satırını silmeyin — bu, ad.* alanları için ipuçlarını doğrudan düzenleyicide etkinleştirir.

İpucu

Bir alan adından emin değil misiniz? Makrolar sekmesini açın ve ad veya açıklamaya göre aramayı kullanın. Alanlar gruplandırılmıştır: reklam, kreatif, teklif, geo, ağ ve önceki dönemin metrikleri.

Oluşturmadan sonra ne görünür

Kaydedilmiş (zaten var olan) bir kuralın düzenleyicinin altında iki sekmesi vardır:

• Beklemede — bu kuralın şu anda duraklatmada tuttuğu reklamlar. Yanında — sayılarının bir sayacı.
• Eylem geçmişi — kuralın tüm tetiklenmelerinin günlüğü: ne zaman, hangi reklam için ve ne yapıldığı.

Yeni, henüz kaydedilmemiş bir kuralın bu sekmeleri yoktur — ilk kayıttan sonra görünürler.

Bir kuralı silme

Sil (düzenleyicinin sağ üst köşesindeki ⋮ menüsündeki öğe) geçmişi silmez: kural devre dışı duruma taşınır ve tetiklenmelerinin günlüğü tutulur. Ancak kuralın kendisini tek tıkla tekrar aktif duruma geri getiremezsiniz — bilinçli hareket edin.

Sırada ne var

Eylemler

bir kuralın bir reklam, reklam seti ve kampanya ile neler yapabileceği.

Koşullar ve metrikler

bir kuralda hangi `ad.*` alanları ve metrikleri kullanılabilir.

Kuralı test etme

bir kuralı uygulamadan canlı veride nasıl test edersiniz.

Zamanlama ve duraklatmalar

duraklatma türleri ve ne kadar sürdükleri.