Pazaryerinde bir persona yayınla

Moonborn pazaryeri (marketplace), persona'larını kendi çalışma alanının dışına çıkarmanın yoludur. Sen yayınlarsın, moderasyondan geçer, başkaları kurulum (install) yapıp kendi çalışma alanlarında çalıştırabilir ya da fork edip kendi varyantlarını türetebilir. Lineage tree fork'ları senin orijinal yayınına bağlı tutar.

Bu rehber yayıncı tarafını anlatır: bir persona'yı yayınlamaya hazırla, gönder, moderasyonu bekle, yayını yönet, kurulum / fork sayılarını oku ve (Enterprise için) ücretli satışı kur.

Bu rehberi bitirdiğinde

• Bir persona'yı moderasyon-uyumlu hâle getirebileceksin (denetim + distinctiveness skor kontrolü).
• Yayını bir lisansla birlikte yayına gönderebileceksin.
• Moderasyon sonucunu (published / unpublished / in_review) webhook ile takip edebileceksin.
• Yayın üstverisini (metadata) yeniden gönderim olmadan güncelleyebileceksin.
• Kurulum ve fork sayılarını okuyup aşağı akıştaki takipçileri görebileceksin.
• Ücretli yayını (Enterprise) yaratıcı (creator) Stripe Connect hesabıyla kurabileceksin.

Ön koşul: API anahtarı, en az bir persona, Team veya üzeri plan. Persona üretme akışına yeni başlıyorsan önce İlk persona'yı baştan sona üret.

1. Persona'yı yayına hazırla

Yayınlamadan önce iki kontrol yap: denetim skoru ve distinctiveness. Moderasyon kuyruğu bu eşikleri otomatik uygular — düşük skorlu yayınlar reddedilir, döngü uzar.

const audit = await client.personas.audit.run({ id: persona.id });
 
if (audit.overallScore < 4.0) {
  console.log('Denetim düşük (%s/5). Yayınlamadan önce persona\'yı refine et.', audit.overallScore);
}

2. Yayını gönder

const listing = await client.marketplace.listings.publish({
  personaId: persona.id,
  license: 'CC-BY-4.0',
  priceCents: 0,
  description:
    'SaaS ilk-kullanım akışları için ayarlanmış, karakter-tutarlı bir müşteri desteği persona\'sı.',
});
 
console.log(listing.id, listing.status); // status === 'in_review'

Lisans seçenekleri

3. Moderasyon akışını anla

Her yeni yayın in_review durumunda başlar. Varsayılan politika insan incelemesinden geçirir; SLA hedefi marketplace.moderation.review_sla_hours yapılandırma maddesinde (varsayılan 48 saat).

Yayın canlıdır. Aşağı akışta kurulumlar ve fork'lar
artık kilitsizdir. /v1/marketplace/listings'te
görünmeye başlar.

Webhook ile sonucu yakala

Sonucu elle yoklama (polling) yerine webhook'a bağlamak istersen:

await client.webhooks.create({
  url: 'https://your-app.com/webhooks/moonborn',
  events: ['marketplace.listing.published', 'marketplace.listing.unpublished'],
  description: 'Marketplace listing decisions',
});

Webhook imza doğrulama + yeniden deneme anlambilimi için Voice drift'i ele al rehberindeki HMAC deseni aynen geçerlidir — Moonborn webhook'larının tek bir yüzeyi var.

4. Yayını yönet

Yayınlandıktan sonra üstveriyi yeniden gönderime gitmeden güncelleyebilirsin:

await client.marketplace.listings.update({
  id: listing.id,
  description: 'Güncellendi: artık faturalama (billing) üst makama iletmelerini temiz şekilde ele alıyor.',
});

Elle yayından kaldırmak:

await client.marketplace.listings.unpublish({ id: listing.id });

5. Kurulum ve fork sayılarını oku

const detail = await client.marketplace.listings.get({ id: listing.id });
 
console.log({
  downloads: detail.downloads,
  forks: detail.forks,
  ratingsAvg: detail.ratingsAvg,
});

• downloads — kurulum (install) sayısı (her kurulum aşağı akışta bir çalışma alanı).
• forks — fork sayısı (her fork lineage tree'ye bir kenar ekler).
• ratingsAvg — isteğe bağlı: kullanıcı oyları etkinse ortalama.

Fork atfetme detayı: Fork atfetme rehberi.

6. Ücretli yayın (Enterprise)

Ücretli yayınlar için iki şart:

1. marketplace.commerce.enabled = true yapılandırması (Enterprise plan kapısı).
2. Bir yaratıcı (creator) Stripe Connect hesabı.

const creator = await client.marketplace.creators.onboard();
console.log(creator.stripeOnboardingUrl);
// Kullanıcıyı bu URL'e gönder — Stripe Connect ilk-kurulumunu tamamlasın.

Gelir paylaşımı

Varsayılan marketplace.commerce.revenue_share = 0.7 — %70 yaratıcı, %30 platform. Bu değer Enterprise planındaki çalışma alanlarında yapılandırma üzerinden ayarlanabilir.

Ödeme (payout)

Yaratıcının bekleyen bakiyesi marketplace.commerce.payout_min_usd'yi (varsayılan $50) geçtiğinde otomatik tetiklenir. Saatlik mutabakat (reconciliation) zamanlanmış görevi (cron) usage_events'i Stripe kayıtlarına karşı denetler.

Plan gereksinimi

• Yayın + ücretsiz yayın: Team.
• Ücretli yayın + ticaret: Enterprise.

Başardın

Yayının status: 'published' döndüyse, başkaları onu /v1/marketplace/listings'te görüp kurabiliyorsa, kurulum / fork sayılarını okuyabiliyorsan rehber bitti.

Sonraki adım