Skip to content

Kampanyalar

Kampanya etiketlenmiş bir gönderi paketidir. Gönderi-başı istatistikler yerine tek bir özet istediğin ürün lansmanları, içerik serileri, haftalık özetler veya ücretli medya anları için kullan.

Endpoint'ler

Hepsi /api/v1/post-campaigns altında:

  • GET /post-campaignssearch, status, page, perPage query parametreleriyle listele (varsayılan page=1, perPage=25).
  • POST /post-campaigns{ name, desc?, color?, status? } ile oluştur.
  • PUT /post-campaigns/:id — alanları güncelle.
  • PATCH /post-campaigns/:id/status — aktif durumu aç/kapa.
  • DELETE /post-campaigns/:id — kaldır.

Kampanya modeli

typescript
{
  user: ObjectId,
  team_id: ObjectId,
  name: string,
  desc: string,
  color: string,        // hex veya named
  status: number,       // varsayılan 1
  postSucceed: number,  // sayaç
  postFailed: number,   // sayaç
}

postSucceed ve postFailed, alt gönderiler yayınlandığında veya başarısız olduğunda artırılan açık sayaçlardır, okuma anında hesaplanan toplamlar değil.

Gönderi ekleme

Gönderiler bir kampanyaya campaign ObjectId alanı üzerinden referans verir. Bir gönderiyi POST /api/v1/posts body'sine campaign ekleyerek (veya bir taslağın kampanyasını değiştirmek için PUT /api/v1/posts/:id) ekle. Bir kampanya içindeki gönderileri listelemek için:

GET /api/v1/posts?campaign=<id>

Kampanya-başı analitik

Bugün özel bir kampanya-analitik endpoint'i yoktur. Toplam metrikler dolaylı olarak mevcuttur:

  • postSucceed / postFailed sayaçları hızlı bir sağlık kontrolü verir.
  • Gösterim ve etkileşim toplamları için /api/v1/analytics/posts-by-channel?campaign=<id> filtrele (desteklenen yerlerde) — endpoint-başı matris için Kampanya Performansı'na bak.

İlgili