Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원. Tracking 안에 마운트됩니다. accountId와 accessToken은 여기에서 가져옵니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다.

예시 데이터입니다. Playground 열기.

Props

string
트래픽 소스로 유입된 사람으로 범위를 좁히며, 소스 경로로 지정합니다 — 계정의 캠페인 중 하나는 whop:adcamp_…:*, 다른 곳에서 운영한 광고는 ext:*, 그리고 referrer:*, direct. 광고 테이블의 클릭 수가 링크할 때 사용하는 값과 같으므로, 페이지에서 자체 URL로부터 이 값을 바로 채울 수 있습니다. 기본값은 ""입니다.
string
이벤트 이름으로 해당 이벤트를 수행한 사람으로 범위를 좁힙니다 — payment.completed, pixel.lead, pixel.page. 기본값은 ""입니다.
string
커스텀 이름으로 커스텀 픽셀 이벤트를 수행한 사람으로 범위를 좁힙니다. 빈 eventName과 함께 사용합니다. 기본값은 ""입니다.
string
트래픽에 포함된 utm_source로 범위를 좁힙니다. 여러 값 중 하나와 일치시키려면 쉼표로 구분하세요. 기본값은 ""입니다.
string
US 또는 GB 같은 ISO 3166-1 alpha-2 국가 코드로 범위를 좁힙니다. 기본값은 ""입니다.
string
기기 유형으로 범위를 좁힙니다 — desktop, mobile, tablet, bot. 기본값은 ""입니다.
string
브라우저 이름으로 범위를 좁힙니다. 기본값은 ""입니다.
string
운영 체제 이름으로 범위를 좁힙니다. 기본값은 ""입니다.
string
고객만 보려면 true, 구매한 적이 없는 사람만 보려면 false, 모두 보려면 비워 둡니다. 기본값은 ""입니다.
string
검색 상자에 적용된 필터 — 이름, 이메일 또는 식별자. 기본값은 ""입니다.
string
사람 필터로 만든 저장된 오디언스(adaud_…)로 범위를 좁힙니다. 오디언스 필터 메뉴가 이 값을 변경합니다. 기본값은 ""입니다.
string
source/eventName 필터의 이벤트 기간을 핸들의 period 대신 정확한 ISO 8601 시점으로 고정합니다. eventFrom과 eventTo를 둘 다 설정하거나 둘 다 설정하지 마세요. 기본값은 ""입니다.
string
고정된 이벤트 기간의 끝으로, ISO 8601 시점입니다. 기본값은 ""입니다.
string
정렬된 열: name, email, ltv, purchase_count, event_count, first_seen_at, last_seen_at. 기본값은 "last_seen_at"입니다.
"asc" | "desc"
정렬 방향. 기본값은 "desc"입니다.

이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

onPeriodChanged

보는 사람이 기간 선택기에서 기간을 변경했습니다. 같은 핸들 아래의 모든 화면은 이미 이를 따랐습니다. 이 값을 저장하고 핸들에 period/customRange로 다시 전달하세요. 그렇지 않으면 다음 마운트 시 기간이 초기화됩니다.
object

onAttributionModelChanged

보는 사람이 필터 행의 Attribution 메뉴에서 어떤 터치에 기여도를 부여할지 변경했습니다. 같은 핸들 아래의 모든 화면은 이미 기여도를 다시 계산했습니다. 이 값을 저장하고 핸들에 attributionModel로 다시 전달하세요. 그렇지 않으면 다음 마운트 시 원래대로 돌아갑니다.
object

onFiltersChanged

보는 사람이 필터, 검색 상자 또는 오디언스 선택기를 변경했습니다. 무엇이 변경되었든 전체 필터 상태를 전달합니다 — 이를 자체 URL에 반영하고 props로 다시 전달하면 뷰를 재현할 수 있습니다.
PeopleFilterBag

onSortChanged

보는 사람이 열을 정렬했습니다. 저장하고 sort/dir로 다시 전달하세요. 그렇지 않으면 다음 마운트 시 정렬이 초기화됩니다.
object

onPersonOpened

보는 사람이 사람 행을 클릭했지만 핸들에 따라갈 links.person이 없습니다. 이를 사용해 person 엘리먼트를 표시하세요. 예: createOverlay("person", { identifier: payload.personId }) (personId는 사람별로 안정적인 키이고, identifier는 해당 화면이 가진 것 중 사람이 가장 알아보기 쉬운 식별자입니다). 또는 핸들에 links.person을 전달해 행을 실제 링크로 만드세요.
object

onLoaderStart

로딩 스켈레톤이 처음 그려진 후, onReady 전에 실행됩니다.

onReady

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

onError

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 code를 사용하세요. sourceKey는 실패한 호스트 상태 소스를 식별합니다.
object

메서드

create가 반환한 핸들에서, 또는 React ref를 통해 호출합니다.

mount

target에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다. 매개변수
string | HTMLElement
필수

destroy

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

update

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요. 매개변수
Partial<PeopleElementProps>
필수

스타일링

이 엘리먼트는 스타일링용 클래스 이름을 노출하지 않습니다. 스타일을 변경하려면 appearance(테마, 강조 색상, 변수)를 사용하세요.