Gelir atfı

Doğrulanmış siparişleri arkalarındaki trafik ve kampanyalara bağlayın.

Siparişler Seean’a iki yolla ulaşır: yerel bir bağlayıcı bir ödeme sağlayıcısının imzalı webhook’larını alır ya da sunucunuz doğrulanmış siparişleri ve iadeleri Seean’ın sipariş API’sine gönderir. Her web sitesi sizin seçtiğiniz tek bir para biriminde raporlar. Bir sipariş Seean’ın tanıdığı bir ziyaretçiyi adlandırdığında, atıf (temaslar, ilk ve son kaynak, açılış sayfası, satın alma süresi) sunucuda o ziyaretçinin siparişten önceki 90 gündeki izlenen ziyaretlerinden türetilir. Entegrasyonunuzun sağladığı alanlar yalnızca izlenen ziyareti olmayan ziyaretçiler için kullanılır.

Bir ödeme sağlayıcısı bağlamak

Kendi web sitenizde Settings → Integrations → Payment providers bölümünü açın ve Creem, Mollie, Paddle, Polar, RevenueCat, Revolut, Shopify, Stripe, Superwall veya Whop altında Enable seçin. Panel kurulum adımlarını, web sitesinin o sağlayıcı için webhook URL’sini (https://events.seean.io/api/connect/<provider>/<site ID>) ve etkinleştirilecek olayları listeler; sağlayıcının imzalama gizli anahtarını yapıştırın, Seean her teslimatı saklamadan önce doğrular. Stripe, Polar ve Paddle için Quick connect, bir kez yapıştırdığınız bir API anahtarından webhook’u oluşturur; anahtar saklanmaz. Save secret sonrasında alan güvenlik için temizlenir ve altındaki satır son dört karakterle Secret saved (ends in …) yazar; böylece doğru gizli anahtarın saklandığını doğrulayabilirsiniz. Yalnızca değiştirmek için yeni bir değer yapıştırın. Ödenen siparişler ve iadeler sonra otomatik gelir ve durum satırı son olayı ve varsa hatayı gösterir. Başarısız bir bağlama veya bağlantı kesme, istek hız sınırına takıldığında beklenecek saniyeler dahil sunucunun nedenini gösterir. Aşağıdaki sağlayıcı rehberleri her sağlayıcının adımlarını, atıf kod parçasını, iade ve para birimi davranışını ve sınırlarını verir.

Stripe, bağlantıdan sonra ek olarak ayrı, yalnızca sahibe açık bir Optional Stripe payment reads bölümü sunar. Başta işaretsiz bir onay denetimi, tam olarak ilk Checkout faturası, ödemeler ve iadeler için kısıtlı bir okuma anahtarının saklanmasını açıkça yetkilendirir; yenilemeler veya geriye dönük doldurma için değil. Anahtar hiçbir zaman önceden doldurulmaz veya döndürülmez; yalnızca sahip etkin durumu, test/canlı modu, hesabı ve son ekini görür. Değiştirmek yeni onay gerektirir. Remove read key, webhook’u, siparişleri ve mevcut ödeme bağlantılarını olduğu gibi bırakır. Hızlı/elle yeniden bağlama saklanan okuma erişimini kaldırır; hızlı bağlama anahtarı bir kez kullanılıp atılır. Demo/meşgul denetimler devre dışıdır; başarılı eylemler ve sağlayıcı değişiklikleri yazılan okuma anahtarını temizler. İzinler, başarılı iade kontrolleri, imzalı olay/yeniden oynatma bağlantısı ve sınırlı, açık tek oturumluk kurtarma için Stripe rehberine bakın. Bu kaynak teslimatı üretim dağıtımını veya canlı geçmiş kurtarmayı doğrulamaz.

Teslimat kurtarma

Yerel bir bağlayıcı; bir iade siparişinden önce geldiğinde (iadenin oluşturulmasından sonra en fazla bir gün; sonrasında iade onaylanır ve yoksayılır), bir Revolut sipariş araması başarısız olduğunda veya alım geçici olarak kullanılamadığında 503 döndürür. Hız sınırları 429 döndürür. Bu yanıtlar teslimatı sağlayıcının yeniden denemelerine uygun bırakır; Seean ikinci bir webhook kuyruğu tutmaz. Özgün sipariş saklandıktan sonra iadeyi aynı iade kimliğiyle yeniden oynatmak onu bir kez uygular.

Son teslimat zamanı ve kayıtlı eşleme veya arama hatası için Settings → Integrations → Payment providers bölümünü kontrol edin. Kimlik bilgilerini veya geçersiz ödeme verisini kaynağında düzeltin. Sonraki başarılı bir teslimat son hatayı temizler; bu yüzden başarısız teslimatları sağlayıcının panelinde de kontrol edin. Desteklenmeyen olaylar ve kalıcı yük/para birimi hataları 200 ile onaylanır; reddedilen siparişler saklanmaz.

Yeniden deneme takvimleri ve süre sonu her sağlayıcı tarafından denetlenir. Teslimat denemelerinin süresi dolarsa, varsa yeniden teslim denetimlerini kullanın veya doğrulanmış siparişi/iadeyi özgün tanımlayıcılarla Order API üzerinden gönderin. Daha önce onaylanan hatalar bu değişiklikle otomatik olarak yeniden oynatılmaz. Stripe’ın isteğe bağlı okumaları yeni teslim edilen imzalı Checkout olaylarından veya tam yeniden oynatmalardan ilk ödeme bağlantıları kurabilir; anahtarı etkinleştirmek geçmiş kurtarmayı başlatmaz. Kimliği doğrulanmış sahipler ayrıca özel bir entegrasyon aracılığıyla tek oturumluk bir mutabakat denemesi ve ardından açık bir uygulama isteyebilir; otomatik veya site genelinde çalıştırma yoktur. Desteklenmeyen çok faturalı/kredi düzenlemeleri ve eksik referanslar inceleme gerektirir. Bir ödemeyi yeniden denemek için hiçbir zaman yeni bir sipariş kimliği oluşturmayın.

Sunucunuzdan sipariş göndermek

Settings → Integrations → Revenue bölümünü açın, sonra raporlama para birimini seçmek ve bir sipariş API gizli anahtarı oluşturmak için Custom server integration (Order API) bölümünü genişletin. Doğrulanmış siparişleri gösterilen uç noktaya göndermek için sunucunuzu veya ödeme webhook işleyicinizi kullanın. Gizli anahtarı sunucunuzda tutun; tarayıcı koduna koymayın. Bu özel bir entegrasyondur, her ödeme sağlayıcısına otomatik bağlantı değildir.

İzleyici, ziyaretçi kimliği, açılış yolu, dönüştüren yol ve kampanyayla window.seean.attribution() işlevini sunar. Bu alanları siparişle birlikte sunucunuza iletin: ziyaretçi kimliği siparişi alıcının ziyaretlerine bağlayan şeydir. O olmadan sipariş atfedilmemiş olarak kaydedilir. Ödeme olaylarını yalnızca sağlayıcınızla doğruladıktan sonra iletin.

Raporlama para birimi

Her web sitesinin tek bir raporlama para birimi vardır. Revenue entegrasyon kartında Reporting currency altındaki açılır menüyü açın ve bir ISO 4217 kodu seçin (varsayılan USD); seçim otomatik kaydedilir. Tutarlar o para biriminin en küçük birimiyle gönderilir: 2900 USD 29.00’dır, JPY’nin alt birimi olmadığı için 2900 JPY 2,900’dür ve KWD üç ondalık kullandığı için 2900 KWD 2.900’dür. Başka bir para birimindeki sipariş HTTP 400 ve Order currency EUR does not match the website's reporting currency USD mesajıyla (ilgili kodlarla) reddedilir. Seean para birimi dönüştürmez.

Raporlama para birimini değiştirmek zaten gönderdiğiniz siparişleri dönüştürmez. Analizler onları hariç tutulmuş sayar ve Revenue sayfası “3 orders use another currency and are excluded from the USD totals.” gibi bir bildirim gösterir. Yalnızca geçerli raporlama para birimindeki siparişler toplamları oluşturur.

İadeler

İadeler sipariş başına bir defterdir. Bir iade kalan tutarın tamamını veya kısmi bir amount değerini kapsayabilir, yeniden denemelerin tekilleştirilmesi için isteğe bağlı refundId taşır ve kendi zaman damgasını taşıyabilir. Kalan tutarı aşan bir iade HTTP 400 ile reddedilir; bir sipariş en fazla 50 iade kabul eder. İade edilen toplam sipariş tutarına ulaşınca sipariş iade edilmiş olarak işaretlenir.

İadeler net geliri iade tarihinin döneminde değil, özgün siparişin döneminde düşürür. Temmuz’da iade edilen bir Haziran siparişi Haziran’ın netini düşürür; Temmuz onun için hiçbir şey göstermez. Siparişi içeren aralığı inceleyin.

Türetilen atıf

Bilinen bir ziyaretçisi olan bir sipariş için Seean, o ziyaretçinin sipariş zaman damgasından önceki 90 gündeki ziyaretlerini okur:

• Touches (temaslar): o penceredeki ziyaret sayısı.
• First source ve Last source: ilk ve son ziyaretin yönlendireni veya utm_source değeri; ikisi de yoksa Direct.
• Landing page (açılış sayfası): ilk ziyaretin giriş sayfası.
• Time to buy (satın alma süresi): ilk ziyaretin başından siparişe.
• Campaign (kampanya): entegrasyonunuzun sağladığı kampanya; yoksa en son etiketli ziyaretin utm_campaign değeri.

Ziyaretçinin pencerede izlenen ziyareti yoksa entegrasyonunuzun sağladığı ilk kaynak, son kaynak, temaslar ve satın alma süresi kullanılır ve sipariş yalnızca bir ziyaretçi ve bir açılış yolu adlandırdığında atfedilmiş sayılır. Ziyaretçi kimliği olmadan gönderilen siparişler Unattributed (Atfedilmemiş) olur. Türetilen atıf var olmadan önce kaydedilen siparişler, ziyaretçilerinin izlenen ziyaretlerinden bir kez geriye dönük doldurulur; entegrasyonunuzun sağladığı bir kampanya korunur.

Atıf sınırları

Sipariş alımı 90 günlük pencerede en fazla 2.000 eşleşen olaylık geçmişleri kabul eder. Taşmayı tespit etmek için en fazla 2.001 satırı 1 MiB okuma bütçesiyle yoklar. Tam kaydedilmiş bir yolculuk en fazla 64 KiB yer tutabilir. Bu sınırlar bir web sitesinin toplam trafiğine değil, her siparişin ziyaretçi geçmişine uygulanır. Tam geçmiş sığdığında Seean her teması kaydeder; otuzuncudan sonraki ziyaretleri artık atmaz.

Geçmiş bir sınırı aşarsa sipariş ve iadeler yine tam olarak kaydedilir. Revenue raporu, yolculuğun bir bölümünden kredi atamak yerine eksik geçmiş bildirimi ve bir Incomplete history döküm satırı gösterir. Bu siparişler atfedilen gelire veya ortalama satın alma süresine katkıda bulunmaz; parasal toplamlarda ve atıf oranı paydasında kalırlar. Rapor, etkilenen siparişleri seçili para birimi ve dönemi için, tamamen iade edilenler dahil sayar. Geriye bakış süresini değiştirmek, alım sırasında yakalanamayan geçmişi kurtarmaz.

Eski kısaltılmış yolculuklar da tam geçmişleri kurtarılabilene kadar eksik olarak işaretlenir. Mevcut kayıtlı rapor sonuçları korunur. İzlenen ziyareti olmayan geçmişler yukarıda anlatılan entegrasyon tarafından sağlanan atfı korur; bunlar bir sınırı aşan geçmişten farklıdır. Bu sınırların ötesinde otomatik zenginleştirme şu anda kullanılamaz.

Ödeme ve teşekkür ziyaretlerini yoksayın

Ödeme sağlayıcısından dönüş çoğunlukla teşekkür veya ödeme sayfanızda son temas kredisini alacak yeni bir ziyaret başlatır. Settings → Exclusions → Revenue attribution only altında yöneticiler ve sahipler trafik hariç tutma sözdizimiyle (/thanks tam olarak veya /checkout/* önek için) en fazla 20 yol kuralı ekler. Eşleşen bir yolda giren ziyaretler, geriye bakış ve model uygulanmadan önce siparişin temaslarından çıkarılır; hiç temas kalmazsa sipariş Unattributed olur. Hiçbir şey silinmez: trafik, Genel bakış sayfaları ve diğer her rapor o ziyaretleri korur ve dönüştüren sayfa entegrasyonunuzun sağladığı yolu göstermeye devam eder. Kurallar yalnızca yeni hesaplamalara uygulanır: bir kural değiştiğinde Revenue ve Genel bakış raporları yeni bir analiz başlatır; zaten kaydedilen sonuçlar, zaten hesaplanan zamanlanmış raporlar ve API sonuçları olduğu gibi kalır ve sonraki API isteği yeni kurallarla hesaplar. Ziyaret geçmişi olmayan siparişler (ziyaretçi kimliği olmadan gönderilenler veya türetilen atıftan eskiler) filtrelenemez; rapor onları kurallar bildiriminin altında sayar.

Gelir raporu

Web sitesi kenar çubuğunda Revenue bölümünü açın. Tabloları her değeri tek satırda tutar; dar ekranlarda bir tablo kartının içinde yana kayar ve uzun satın alma yolculukları üç noktayla kısaltılır (tam yol için üzerine gelin). Araç çubuğunda tarih aralığı ve atıf denetimleri bulunur:

• Attribution model: First touch, geriye bakıştaki ilk ziyarete, Last touch siparişe götüren ziyarete kredi verir, Linear siparişi ziyaretleri arasında eşit böler.
• Attribution lookback: siparişten önce 7, 14, 30 veya 90 gün. Geriye bakıştan eski bir ziyaret temas değildir. Tam kaydedilmiş ziyaretler, aşağıdaki atıf sınırlarına tabi olarak model kredisi için kullanılır.
• Website default: sayfa web sitesinin kayıtlı model ve geriye bakışıyla açılır (biri kaydedilene kadar son temas, 30 gün). Seçiminiz farklı olduğunda yöneticiler ve sahipler Save as website default görür; varsayılan Genel bakışın gelir kredisi, analiz API’si ve MCP get_revenue ile ve her takım arkadaşıyla paylaşılır. URL’deki bir seçim o görünüm için her zaman kazanır. Overview: net / gross, Genel bakış KPI’sının ne göstereceğini seçer (bkz. KPI’lar); demo web sitesi bu ayarları değiştiremez.

Üst şerit brüt, iadeler (iade sayısıyla), net, atfedilen gelir, atıf oranı ve ortalama satın alma süresini gösterir. Attribution breakdown beş sekmeye sahiptir: Landing pages, Converting pages, First source, Last source ve Sources. Sources her kaynağa seçili model altında kredi verir; bu yüzden Linear ile bir sipariş, net tutarının bir payıyla kaynaklarının her biri altında bir kez görünür. Revenue by product siparişleri, geliri, payı ve atfedilen bölümü listeler. Touches before purchase siparişleri türetilen temas sayısına göre kovalar. Purchase journeys ödenen siparişleri geriye bakış içindeki her ziyaretin giriş sayfasına göre, en eskisi önce gruplar (/ → /pricing → /checkout): ardışık tekrarlar birleşir, yalnızca son altı adım bir üç noktanın arkasında tutulur, entegrasyonunuzun sağladığı bir yol türetilen yolculuğun yerine geçer ve ziyaret geçmişi olmayan siparişler açılış sayfalarını gösterir. Yolculuklar ziyaret giriş sayfalarıdır, görüntülenen her sayfa değil.

Orders, dönemin siparişlerini en yenisi önce, Load more ile yirmişer, yalnızca raporlama para biriminde listeler: zaman (görüntüleme saat diliminizdeki tam an için üzerine gelin), Refunded veya Partially refunded −amount rozetli ürün, ilk kaynak, yolculuk ve seçili model ile geriye bakış altındaki tutar. Eksik geçmişli siparişler Incomplete history gösterir. Refunds, o siparişlerin her iadesini - iade zamanı, sipariş kimliği (veya sipariş zamanı), ürün, iade kimliği ve tutar - yine yirmişer listeler; iade defterleri var olmadan önce kaydedilen tam bir iade legacy olarak bir kez görünür. İadeler hem burada hem toplamlarda her zaman siparişlerinin döneminde sayılır. Görüntüleyiciler iki listeyi de okuyabilir; ham dışa aktarmalar Settings → Data altında kalır.

Modeli veya geriye bakışı değiştirmek aynı aralık için yeni bir analiz başlatır; mevcut sonuçlar ve saklanan siparişler yeniden yazılmaz.

Dönemleri karşılaştırın

Tarih aralığının yanındaki karşılaştırma düğmesi Genel bakışla aynı seçenekleri sunar: Previous period, Previous week, Previous month, Previous quarter, Previous year, Custom range… ve No comparison (bkz. tarih aralıkları ve filtreler). Bir karşılaştırma etkinken üst şeritteki her KPI sayısı yerine karşılaştırma aralığına göre yüzde değişimini gösterir: brüt, iadeler, net, atfedilen gelir, atıf oranı ve satın alma süresi. İadelerde veya satın alma süresinde artış düşüş olarak gösterilir. Previous period aynı analizde hesaplanır; diğer seçimler aynı model, geriye bakış ve raporlama para birimiyle bir ek gelir analizi başlatır. Döküm tabloları, ürünler, temaslar, yolculuklar, siparişler ve iadeler geçerli dönem görünümleri olarak kalır ve All time için karşılaştırma yoktur.

Atıf aktarımı

Siparişi bir bağlayıcı veya sunucunuz kaydetsin, ziyarete bağlantı ziyaretçi kimliğidir. Bir bağlayıcıyla, window.seean.attribution() işlevinden seean_visitor_id (ve isteğe bağlı olarak seean_landing_path, seean_converting_path, seean_campaign) değerlerini sağlayıcı rehberinin gösterdiği gibi sağlayıcının ödeme meta verisine, özel verisine, sepet özniteliklerine veya abone özniteliklerine ekleyin; Seean bu anahtarları doğrulanmış olaydan okur. Herkese açık izleme belirteci hiçbir zaman sipariş alımını yetkilendirmez.

Özel bir entegrasyon için, ödeme oluşturma sırasında kullanılabilir olduğunda window.seean?.attribution?.() değerini yakalayın ve yalnızca desteklenen alanları sunucunuza iletin. Sonraki doğrulanmış ödeme olayının kullanabilmesi için bunları ödeme/sipariş referansıyla saklayın. Yardımcı yüklemeden önce yok olabilir veya toplama devre dışıyken atıf döndürmeyebilir. Bu durumda atfedilmemiş bir sipariş kabul edin; ziyaretçi veya kampanya değeri uydurmayın.

İzleyici yüklendikten sonra atfı okumadan önce window.seean?.ready değerini bekleyin (await). Bu, ilk toplama denemesinden veya zaman aşımından sonra tamamlanır; bir ziyaretçi kimliğinin var olduğunu garanti etmez. Bunu eşzamansız ödeme işleyicinizin içinde kullanın ve ödemenin atıf olmadan sürmesine izin verin. Her sağlayıcı örneği bu beklemeyi içerir.

Varsayılan ziyaretçi karması UTC gece yarısında değişir ve tek bir web sitesine özgüdür. 90 günlük geriye bakış yakalanan tanımlayıcıyı taşıyan kayıtları arar; o ziyaretçinin farklı günlük karmalarını birleştirmez. Gecikmeli ödeme webhook’ları için ödeme anındaki atfı koruyun. Yeni bir UTC gününde sonraki bir dönüş yeni bir kimliğe sahiptir; bu yüzden çok günlü yolculuklar yeniden kurulmaz. Eski siparişler ve kayıtlı sonuçlar özgün tanımlayıcılarını ve değerlerini korur.

Yeniden denemeler boyunca kararlı harici sipariş tanımlayıcıları kullanın. Yinelenen ödemeleri temsil ettikleri ayrı ödenen siparişler olarak iletin ve her iadeyi sağlayıcının iade kimliğiyle özgün harici sipariş kimliğine eşleyin. Entegrasyonunuz sağlayıcının olay sıralamasını ve yinelemelerini hesaba katmalıdır. Sağlayıcı tutarlarını web sitesinin raporlama para birimi alt birimlerine yalnızca ödeme gerçekten o para biriminde tahsil edildiğinde dönüştürün; Seean diğer para birimlerini dönüştürmek yerine reddeder.

Entegrasyonunuzu doğrulayın

Sağlayıcınızın test olanaklarını ve mümkünse ayrı bir Seean test web sitesini kullanın. Ödenen bir siparişi, özdeş bir yeniden denemeyi, kısmi bir iadeyi, tam bir iadeyi ve atıfsız bir siparişi doğrulayın. Web sitesinin Revenue raporunu tam tutarlar ve türetilen atıfla karşılaştırın. Başarılı bir izleyici isteği veya onay sayfası ziyareti siparişin alındığını kanıtlamaz.

Entegrasyon referansı

Yükler, sunucu anahtarı işleme, para birimi kuralları, iade kuralları ve yeniden deneme davranışı için Order API ve iadeler rehberini izleyin. Sağlayıcı kullanılabilirliği, hangi sağlayıcıların yerel bağlayıcısı olduğunu özetler.

Sağlayıcı rehberleri

Her rehber sağlayıcının kurulum adımlarını, ödemesi için atıf kod parçasını, neyin kaydedildiğini, iadeleri, para birimini, doğrulamayı ve sınırları kapsar.

İzlenen ziyaretçi geçmişi, Order API veya desteklenen bir sağlayıcı bağlayıcısı aracılığıyla yeni bir sipariş kabul edildiğinde bir kez yakalanır. Geçici bir geçmiş arama hatası yeniden denenebilir bir yanıt döndürür; kabul edilen bir yineleme özgün atfı ve tam tutarı korur. Bkz. Order API yeniden denemeleri.

• Creem

  Connect Creem to Seean with the webhook secret, pass the visitor ID as checkout metadata and receive completed checkouts and refunds.

• Mollie

  Connect Mollie to Seean through signed next-generation webhooks, pass the visitor ID as payment metadata and receive paid payments and refunds.

• Paddle

  Connect Paddle to Seean with the notification secret key, pass the visitor ID as checkout custom data and receive completed transactions and approved refunds.

• Polar

  Connect Polar to Seean with the webhook secret, pass the visitor ID as checkout metadata and receive paid orders, renewals and refunds.

• RevenueCat

  Connect RevenueCat to Seean with the webhook authorization value, pass the visitor ID as Web Billing metadata or a subscriber attribute and receive purchases, renewals and refunds.

• Revolut

  Connect the Revolut Merchant API to Seean with the webhook signing secret and Merchant API secret key, pass the visitor ID as order metadata and receive completed orders.

• Shopify

  Connect a Shopify store to Seean with the webhook signing secret, write the visitor ID as a cart attribute and receive paid orders and refunds.

• Stripe

  Connect Stripe Checkout to Seean with the webhook signing secret, pass the visitor ID as session metadata and receive paid orders and refunds.

• Superwall

  Connect Superwall to Seean with the webhook signing secret, set the visitor ID as a user attribute and receive purchases and renewals.

• Whop

  Connect Whop to Seean with the webhook signing secret, pass the visitor ID as checkout metadata and receive successful payments and refunds.

Anlaşılmayan bir yer mi var? Destekle iletişime geçin.