Bu sayfa
@whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.v1.0.0 sürümünden beri.
Websites içine bağlanır. Props ve geri çağırmaları create seçenekleri veya React props’ları üzerinden iletin.
Bu öğeyi satır içi (
create) olarak bağlayabilir veya modal bir katman (createOverlay) olarak açabilirsiniz.Örnek veriler. Deneme alanını açın.
Props
Pikselin ait olduğu,
biz_ önekli hesap kimliği. Zorunludur; kod parçacığı, taramalar ve davetlerin tümü bu hesap üzerinde çalışır. Varsayılan: "".Taramalar ve geliştirici daveti için kapsamlı bir token. Taramalar
company:basic:read gerektirir; “Bir geliştirici davet et” ayrıca authorized_user:create gerektirir ve olay ön ayarları hesabı company:balance:read ile okur (bu olmadan sihirbaz genel bir ön ayar listesiyle yine çalışır). destinationUrl iletilmediğinde boş URL alanı, hesabın reklamlarından ve piksel trafiğinden sayfalar da önerir; bu okumalar ad_campaign:basic:read ve stats:read gerektirir, bunlar olmadan alan yalnızca boş kalır. Token’ı sunucunuzda POST /api/v1/access_tokens ile oluşturun ve süresi dolmadan yenisini ayarlayın. Bu sihirbazı kendi içinde açan başka bir öğe (reklamların campaign-creator öğesi gibi) bu çağrıları kendi token’ı ile yapar; bu nedenle ikinci bir token oluşturmak yerine bu kapsamları o tek token’a ekleyin: bu öğenin başka bir yerde ayarladığınız bir kimlik bilgisini okuma yolu yoktur. Belirtilmezse çağrılar görüntüleyenin kendi oturumunu taşır ve bu oturum yalnızca aynı kaynaktan (same-origin) gelen isteklere yanıt verir.Kontrol edilecek sayfa; bağlama sırasında taranır. Boş bırakırsanız sihirbaz bir sayfa ister. Olaylar adımındaki “Verify live” düğmesini de bu belirler: bu düğme, sunucu tarafı bir taramanın göremediği olayları yakalamak için hesap sahibini kendi hunisinde gezdirir; bu nedenle yalnızca burada belirtilen veya sihirbazda adlandırılan bir hedef bilindiğinde görünür. Açılışta bir kez okunur, bu nedenle
update() akışın ortasında hedefi değiştirmez; farklı bir sayfa için yeni bir bağlama oluşturun. Varsayılan: "".İsteğe bağlı. O sayfada tetiklenmesi gereken bir olay (
lead, schedule, view_content, …); olaylar adımı bu olay algılanana kadar ilerlemez. Ayarlanmazsa her olay sunulur ve hiçbiri zorunlu değildir. Whop’un sunucu tarafında kaydettiği olaylar (purchase, subscribe, deneme süreleri, ödeme adımları) yok sayılır. Açılışta bir kez okunur. Varsayılan: "".Olay hedef sayfa yerine orada tetikleniyorsa, hedefin yönlendirdiği URL. Hesap sahibi bunu sihirbazda da ayarlayabilir;
redirectUrlChanged olayını dinleyin ve bir dahaki sefere geri iletin. Varsayılan: "".Sihirbazın nerede açılacağı: kurulum adımı veya piksel zaten mevcutsa ve yalnızca dönüşüm olayı eksikse doğrudan
events. Varsayılan: "install".“Neden bir piksel” giriş ekranında açılır. Hesap sahibinin burada neden olduğunu zaten bildiği yerlerde (örneğin onu başlatmanın ortasında buraya gönderen bir kampanya akışında) kapatın; sihirbaz doğrudan kurulum adımında açılır. Varsayılan:
true.“Kurulum için bir geliştirici davet et” yolunu sunar. Yerleştirmenizi kullanan kişilerin arkasındaki Whop ekibine üye davet etmemesi gereken yerlerde gizleyin. Varsayılan:
true.Bir sayfa kontrolden geçtikten sonra, sonraki adım olarak dönüşüm olaylarını sunan “pikseliniz yayında” ekranını gösterir. Hesap sahibinin doğrudan olaylar için geldiği yerlerde kapatın; başarılı bir kontrol, tıklayıp geçecekleri bir ekranda beklemek yerine doğrudan olaylara gider. Varsayılan:
true.Kurulum talimatları yerine sayfa kontrolüyle başlar: URL alanı (ve önerileri) en üstte yer alır, kurulum yolları “Pixel not installed yet?” anahtarının altına katlanır ve başlıkta “Verify your pixel” yazar. Zaten bir pikseli olan ve neden hiçbir şeyin ilişkilendirilmediğini öğrenmek için burada olan bir hesap sahibi içindir.
showIntro: false ile birlikte kullanın. Varsayılan: false.Olaylar
Geri çağırmaları create seçeneklerinde veya React props’larında iletin.onRedirectUrlChanged
Hesap sahibi sihirbazda bir yönlendirme URL’si ayarladı veya temizledi. Bunu saklayın ve bir dahaki sefere redirectUrl olarak geri iletin.
onScanned
Bir piksel taraması sonuçlandı. Sihirbazın kontrol ettiği her URL için tetiklenir, böylece kendi kurulum rozetiniz bunu takip edebilir. primary, kurulmakta olan sayfayı işaretler: huni denetleyicisi, diğer ana makine adları da dahil olmak üzere hesap sahibinin listelediği diğer her şeyi tarar; bu nedenle bir sonucu onların sitesiyle ilgili kabul etmeden önce bu değeri kontrol edin. Bir websites tablosunu doğru tutmak için buna ihtiyacınız yoktur: o tanıtıcı altında bağlandığında, yayında olduğu kanıtlanan bir site bekleyen satırını zaten alır.
onFinished
Done düğmesine basıldı. Sayfayı kendiniz yeniden kontrol edin; bu olay gereksinimlerinizin karşılandığını değil, sihirbazın bittiğini bildirir.
onUrlSubmitted
Hesap sahibi kontrol edilecek sayfayı sihirbazın içinden belirtti: elle yazarak veya önerilen sayfalardan seçerek. Yalnızca bağlama sırasında bir hedef sağlanmadığında erişilebilir.
onVerifyLaunched
“Verify live” düğmesine basıldı. popupBlocked, tarayıcının huni penceresini reddettiği ve bu nedenle gezintinin hiç başlamadığı anlamına gelir.
onVerifyConnected
Huni sayfası sihirbaza geri sinyal gönderdi: piksel orada yüklü ve gezinti canlı.
onVerdict
Canlı doğrulama gezintisi tamamlandı. ok, izleme boşluğu olmadığı anlamına gelir; aksi takdirde gaps, gezintinin bulduğu boşluk kodlarını taşır.
onEventVerified
Hesap sahibi “Verify live” ile hunisinde gezindi ve bu olay tetiklendi; bu, olayın sunucu tarafı bir taramanın erişemediği yerde bağlı olduğunun kanıtıdır.
onLoaderStart
Yükleme iskeleti ilk kez çizildikten sonra ve onReady öncesinde çalışır.
onReady
Öğenin ilk tam çiziminden sonra çalışır.
onError
Öğe yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için code kullanın. sourceKey, başarısız olan bir host-state kaynağını tanımlar.
Yöntemler
Bunlarıcreate tarafından döndürülen tanıtıcı üzerinde veya bir React ref aracılığıyla çağırın.
mount
Öğeyi target içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.
Parametreler
destroy
Öğeyi kaldırır, çerçevesini ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React öğeyi otomatik olarak kaldırır.
update
Yeni props’ları bağlı öğeyle birleştirir. React’te bunun yerine bileşen props’larını değiştirin.
Parametreler
Stil verme
Bu parçalaraappearance.classes aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları öğenin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.
appearance değerini <Websites> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.
