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.
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: {}.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".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.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".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".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.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.
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
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.
