Skip to main content
Whop Ads는 Whop 계정에서 바로 외부 광고 네트워크에 유료 광고를 게재합니다. 광고 지출은 모든 캠페인에 걸쳐 계정에 설정된 카드 또는 잔액으로 청구됩니다. 광고 계정, 검토, 게재 시작, 청구는 Whop이 처리합니다. 두 번의 API 호출만으로 아무것도 없는 상태에서 라이브 광고까지 만들 수 있습니다. 크리에이티브를 생성한 다음, 캠페인, 광고 그룹, 광고를 한 번의 요청으로 생성하세요.

리소스

청구 및 결제 복구

지출은 캠페인 전체에 걸쳐 계정 수준에서 수금됩니다. 결제가 실패하면 각 캠페인에 설정된 active/paused status는 유지되지만 delivery_status: "payment_failed"로 게재가 차단됩니다. 계정의 결제 수단을 수정한 다음, 계정에 대해 실패한 광고 결제 재시도를 한 번 호출하세요. 응답은 백그라운드 시도를 대기열에 넣을 뿐이며 결제를 확정하지는 않습니다. 정산이 완료되면 다른 게재 요건을 충족하는 한 활성 캠페인은 재개될 수 있고 일시 중지된 캠페인은 일시 중지 상태로 유지됩니다. 대시보드 흐름, 요청 예시, 중복 요청 동작, 레거시 캠페인 처리 방식은 광고 비용 결제를 참고하세요.

최초 1회 설정

  • 스코프: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • 광고 결제 수단: 대시보드에서 연결합니다(잔액 또는 카드). 게재를 시작할 때만 필요하며, 초안은 결제 수단 없이도 작동합니다.
1

크리에이티브 생성

잔액에서 청구됩니다(amount_charged, 잔액이 부족하면 deposit_url과 함께 402 반환). status가 ready가 될 때까지 GET /media/{id}를 폴링한 다음 file.id를 사용하세요.
failed이면 요금이 환불됩니다. 프롬프트를 수정해 다시 시도하세요. 동영상: "type": "video"와 함께 선택적으로 duration_seconds(5/10/15), resolution(480p–4k), 최대 4개의 reference_media 파일 ID(첫 번째 파일이 시작 프레임의 기반이 됨)를 지정합니다.
2

광고 생성 및 게재 시작 — 한 번의 요청

인라인 ad_group과 ad_campaign을 포함한 POST /ads는 하나의 트랜잭션으로 전체 트리를 생성하고 게재를 시작합니다.
아직 지출할 준비가 되지 않았나요? ad_campaign에 "status": "draft"를 추가한 다음, 나중에 PATCH /ad_campaigns/{id} {"status": "active"}로 게재를 시작하세요.기존 컨테이너를 재사용하려면 ad_group 대신 ad_group_id를, ad_campaign 대신 ad_campaign_id를 전달하세요.
3

모니터링

GET /ads/{id}를 폴링하세요. delivery_status는 실시간 상태이며(콘텐츠 검토를 위한 짧은 in_review는 정상입니다), issues[]에는 광고 네트워크가 비동기적으로 거부한 항목에 대해 사람이 읽을 수 있는 message가 담겨 있습니다.광고, 광고 그룹 또는 캠페인에서 pause / unpause로 게재를 제어하세요. 문구나 크리에이티브는 PATCH /ads/{id}로 편집하세요. creatives를 보내면 전체 세트가 교체되므로 기본 항목을 포함해야 합니다.

오류

모든 검증 실패는 무엇을 수정해야 하는지 알려주는 메시지와 함께 400을 반환합니다.