Skip to main content
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.

Playground

Elementleri örnek verilerle bir araya getirin. Kontrolleri kullanın, elementler ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

Seçenekler

Bunları whop.tracking.create({ … }) metoduna veya React’te <Tracking> üzerinde prop olarak iletin.
string
Bunun kişilerini ve olaylarını okuduğu, biz_ önekli hesap kimliği. Zorunlu. Varsayılan: "".
string
Her iki yüzeyin okuma için kullandığı kapsamlı bir token. Tüm tanıtıcı için tek bir token’ı sunucunuzda POST /api/v1/access_tokens ile oluşturun ve süresi dolmadan önce update({ accessToken }) ile yenisini ayarlayın. Listeleri okumak member:basic:read veya company:basic:read gerektirir; filtre menülerinin seçenek sayıları ek olarak stats:read kullanır ve People tablosunun kayıtlı kitle filtresi audience:basic:read kullanır; bunlar olmadan menüler yalnızca daha az seçenek gösterir. Atlanırsa çağrılar izleyicinin kendi oturumunu taşır; bu da yalnızca aynı kaynaktan (same-origin) yanıt verir.
Kişi bağlantılarının sitenizde nereye gittiği. person, her biri satır başına URL kodlamalı olarak değiştirilen iki yer tutuculu mutlak URL şablonudur: {personId} sabit prsn_… kimliğidir ve aynı kişi için her yüzeyde aynıdır, bu nedenle sayfanızı onunla anahtarlayın ve person elementini orada bağlayın; {identifier} yüzeyin sahip olduğu insan açısından en anlamlı tanımlayıcıdır (bilindiğinde bir kullanıcı kimliği veya e-posta), bu nedenle yüzeyler arasında farklılık gösterebilir. Mutlak olmalıdır (https://…); göreli bir URL element çerçevesine göre çözümleneceğinden ayarlanmamış kabul edilir. Ayarlanmadığında bir kişi tıklaması bunun yerine kendi elementinde personOpened olayını tetikler; bu, person elementini sayfanızın üzerinde sunmanın işaretidir. people ve events temel URL’leri reklam tanıtıcısıyla simetri için kabul edilir, ancak bu tanıtıcı altındaki hiçbir şey onları görüntülemez. Varsayılan: {}.
string
Her iki yüzeyin kapsadığı zaman aralığı: today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time veya custom (customRange ile eşleştirin). Elementler seçiciyi taşır ve bunu değiştirir; değeri periodChanged üzerinden geri okuyun. Varsayılan: "last_14_days".Şunlardan biri: "today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time" veya "custom".
object | null
period değeri custom olduğunda kullanılan, ISO 8601 anları olarak açık zaman aralığı. Aksi takdirde yok sayılır. Varsayılan: null.
"account" | "local"
Zaman aralığının iki saat diliminden hangisinde çözümlendiği: hesabın kendi planlama saat dilimi olan account veya izleyicinin tarayıcısının bulunduğu saat dilimi olan local. Hesap herhangi bir saat dilimi ayarlamadığında account, izleyicinin kendi saat dilimine geri döner. Varsayılan: "account".
"last_touch" | "first_touch"
Kaynağa göre filtrelerken bir kişinin yolculuğundaki hangi temas noktasının krediyi aldığı: varsayılan olan last_touch veya first_touch. Elementler seçiciyi taşır ve bunu değiştirir, böylece bir host onu yönetebilir ve attributionModelChanged üzerinden geri okuyabilir. Varsayılan: "last_touch".
Appearance
Bu grubun öğeleri için görsel özelleştirme. Genel WhopElements({ appearance }) ayarını geçersiz kılar. update({ appearance }) ile canlı olarak değiştirin.
WhopElementsLocale
Bu grubun öğe arayüz metinleri için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer tüm değerler varsayılan yerel ayara geri döner.

Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop’larında iletin.

onLoadingChange

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir öğe hâlâ yükleniyorken değer true olur.
boolean

Metotlar

Bunları whop.tracking.create({ … }) veya useTracking() ile elde edilen Tracking tanıtıcısı üzerinde çağırın.

update

Yeni tanıtıcı seçeneklerini bağlı her öğeyle birleştirir. React’te bunun yerine ad alanı props’larını değiştirin. Parametreler
Partial<TrackingOptions>
gerekli

destroy

Bu tanıtıcının oluşturduğu her öğeyi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer tüm çağrıları reddeder; baştan başlamak için yeni bir tanıtıcı oluşturun. Sağlayıcı bağlantısı kaldırıldığında React grubu otomatik olarak kaldırır.

Öğeler

Bu grubun bağladığı öğeler. Her birinin kendi sayfası vardır:

PeopleElement

Hesabın gördüğü herkes: piksel etkinliğinden çözümlenen ziyaretçiler ve müşteriler; kaynakları, harcamaları ve etkinlik sayaçlarıyla birlikte. Arayın; kaynak, olay, coğrafya veya cihaza göre filtreleyin; herhangi bir sütunu sıralayın ve sayfalar arasında gezinin. Bir satır tıklaması, tanıtıcı yapılandırdığında links.person bağlantısını izler, aksi takdirde size personOpened olarak geri döner.

EventsElement

Hesabın ölçtüğü her olay (sayfa görüntülemeleri, potansiyel müşteriler, satın almalar ve özel piksel olayları) ham, filtrelenebilir bir akış olarak. Herhangi bir metriğin arkasındaki satırlar: tanıtıcının zaman aralığı boyunca olay, kaynak, coğrafya veya cihaza göre filtreleyin ya da bir kişinin tüm yolculuğunu okumak için onun tanımlayıcısını arayın. Bir kişi hücresi, tanıtıcı yapılandırdığında links.person bağlantısını izler, aksi takdirde size personOpened olarak geri döner.

PersonElement

Hesabın bir kişi hakkında bildiği her şey: kim olduğu, nereden geldiği, ne harcadığı ve gerçekleştirdiği her olay, sırasıyla. Bir kişi tıklamasının götürdüğü görünüm: onu links.person bağlantısının işaret ettiği sayfada bağlayın ya da people veya events personOpened tetiklediğinde kendi sayfanızın üzerinde sunun. identifier, bir kişinin altında görüldüğü herhangi bir tanımlayıcıyı kabul eder, bu nedenle bir personOpened yükü burada değiştirilmeden çözümlenir.