이 페이지는
@whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.v1.0.0부터 사용 가능.
Ads 안에 마운트됩니다. 생성해 핸들을 얻은 다음, 그 핸들에 엘리먼트를 마운트하세요. 하위 컨트롤러를 제거하려면 destroy()를 호출하세요. 새 핸들을 얻으려면 다시 생성하세요.
미리보기
예시 데이터로 이 하위 컨트롤러의 기본 배치를 보여 주는 실시간 인터랙티브 데모입니다.옵션
ads.create('reporting', { … })에 전달하거나, React에서는 <Reporting>의 props로 전달하세요. 상위에서 주입되는 props는 여기에 표시되지 않습니다.
모든 화면이 보고하는 기간입니다:
today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, all_time 또는 custom(customRange와 함께 사용). 차트에 선택기가 있으며 이 값을 변경하므로, 호스트는 기간을 제어하고 periodChanged에서 다시 읽을 수 있습니다. 기본값은 "last_14_days"입니다."today", "yesterday", "last_7_days", "last_14_days", "last_30_days", "last_90_days", "all_time", "custom" 중 하나입니다.모든 보고 수치에 적용할 시간대 선택입니다. 계정의
preferences.ads_scheduling_timezone을 사용하려면 account를, 뷰어의 브라우저 시간대를 사용하려면 local을 지정하세요. 차트가 제공하는 선택지는 이 두 가지뿐입니다. 자유 형식의 IANA 시간대는 선택기가 데이터에 잘못된 레이블을 붙이게 할 수 있으며, 뷰어가 선택을 바꾸면 사라집니다. 다른 시간대로 보고하려면 계정 설정을 변경하세요. 계정에 설정이 없으면 account는 뷰어의 시간대로 대체됩니다. 기본값은 "account"입니다.환산 금액에 사용할 소문자 세 글자 ISO 4217 통화 코드입니다(예:
usd 또는 eur). 설정하지 않으면 계정의 preferences.ads_reporting_currency가 사용됩니다. 기본값은 ""입니다.구매자 여정에서 어떤 접점에 기여를 부여할지 지정합니다: 기본값인
last_touch 또는 first_touch. 두 경우 모두 여정 어디에서든 Whop 접점이 있으면 Whop 버킷에 기여가 부여되며, 모델은 양 끝점만 선택합니다. 테이블에 선택기가 있으며 이 값을 변경하므로, 호스트는 이를 제어하고 attributionModelChanged에서 다시 읽을 수 있습니다. 기본값은 "last_touch"입니다.보고 대상을 이 광고 캠페인(
adcamp_…)으로 좁힙니다. 비어 있으면 전체 계정을 보고합니다. adGroupIds 또는 adIds가 설정되면 이를 재정의합니다. 정확한 수치를 얻으려면 ID를 하나만 전달하세요. 보고 API는 단일 소스 경로로 범위를 지정하므로, 둘 이상이 주어지면 차트는 첫 번째 것만 보고합니다. 기본값은 []입니다.table 엘리먼트가 처음 열 테이블입니다: campaigns, ad-groups, ads 또는 트래픽 소스 보기를 위한 all. all은 소스 시리즈가 계정 수준에만 존재하므로 항상 계정 전체를 보고합니다. 따라서 함께 설정한 필터는 테이블은 좁히지만 차트는 좁히지 않습니다. 기본값은 "campaigns"입니다.차트가 보고할 트래픽을 소스 경로로 지정합니다. Whop을 통해 구매한 광고는
whop:*, 다른 곳에서 운영한 광고는 ext:* 및 ext:<platform>:*, 오가닉은 referrer:*, 그리고 direct, other가 있습니다. 기본값인 null은 Whop 광고만 보고하고, []는 모든 소스를 보고하며, 비어 있지 않은 배열은 해당 소스를 보고합니다. Whop 광고 내에서 범위를 좁히는 campaignIds 등과는 다른 축입니다. 지출은 Whop 광고 구매에만 사용되므로, 이 값이 무엇이든 지출 기반 비율은 Whop에 귀속된 상태로 유지됩니다. table 엘리먼트의 All 탭이 이 값을 변경합니다. 기본값은 null입니다.이벤트
콜백은 create 옵션 또는 React props로 전달하세요.onEditRequested
뷰어가 행 메뉴, 초안 행 또는 세부 정보 오버레이의 Edit ad에서 무언가를 편집하려고 요청했습니다. campaignId는 항상 포함되며, adGroupId와 adId는 클릭한 대상으로 범위를 좁힙니다. useCampaignCreator가 꺼져 있을 때만 발생합니다. 켜져 있으면 대신 페이지 위에 빌더가 열리고 이 이벤트는 발생하지 않습니다.
메서드
ads.create('reporting', { … })로 얻은 하위 핸들에서 호출하세요.
update
하위 컨트롤러에 새 props와 콜백을 병합합니다.
매개변수
destroy
하위 컨트롤러와 그 엘리먼트를 파괴한 다음 전용 슬롯을 해제합니다. 이후의 create("reporting")은 새로 시작합니다.
엘리먼트
이 하위 컨트롤러가 마운트하는 엘리먼트입니다. 각 엘리먼트에는 자체 페이지가 있습니다.ChartElement
특정 기간 동안의 계정 성과를 보여 주며, 지출, 노출, 클릭 또는 계정이 기록하는 모든 전환 중 무엇을 표시할지 고르는 선택기가 있습니다. 읽기 전용입니다.
TableElement
광고 계정의 캠페인, 광고 그룹, 광고를 하나의 테이블에 보여 주며, 그 사이를 이동하는 탭이 있습니다. 행을 선택해 하위 수준을 좁히고, 검색하고, 정렬하고, 수치를 세분화하고, 열을 선택하고, 행에서 바로 일시 중지, 재개, 복제 또는 삭제할 수 있습니다. 보고 기간과 필터링된 행은 핸들에 저장되므로, 옆에 마운트한 차트는 정확히 같은 대상을 보고합니다.

