Skip to main content
고객 목록이나 Whop People 데이터로 맞춤 오디언스를 만들고, 기존 오디언스와 비슷한 사람들에게 도달하기 위해 유사 오디언스를 생성하세요. Audiences API를 사용하면 오디언스를 생성하고, 업로드된 고객 목록에 사람을 추가하고, 오디언스의 이름을 바꾸거나 필터를 다시 적용하고, 비동기 처리를 모니터링할 수 있습니다. Whop People 오디언스는 자동으로 새로 고치거나 스냅샷을 유지할 수 있습니다.

엔드포인트

속성

string
필수
adaud_ 접두사가 붙은 오디언스 ID입니다.
string
필수
오디언스가 정의된 사람들의 그룹을 타기팅하는지, 기존 오디언스와 비슷한 사람들을 타기팅하는지 여부입니다.사용 가능한 옵션: custom, lookalike
boolean
필수
Whop이 저장된 People 필터로 하루 두 번 멤버를 다시 구성하는지 여부입니다. false이면 People 오디언스는 생성 시 매칭된 멤버를 유지합니다. 업로드된 목록, 유사 오디언스, 참여 오디언스에서는 항상 false입니다.
string
필수
오디언스가 생성된 시각(ISO 8601 타임스탬프)입니다.
string | null
필수
pending 오디언스가 시작되지 않은 이유 또는 partial이나 failed 오디언스가 완전히 구성되지 않은 이유입니다. 보고할 내용이 없으면 null입니다.
object | null
필수
멤버를 정의하는 저장된 Whop People 필터로, GET /people과 같은 키를 사용합니다. 업로드된 목록, 참여 오디언스, 유사 오디언스에서는 null입니다.
string | null
필수
오디언스 멤버가 마지막으로 다시 구성된 시각(ISO 8601 타임스탬프)입니다. 첫 구성이 완료될 때까지 null입니다.
number | null
필수
유사 오디언스의 경우: 유사도 구간의 상한을 비율로 나타낸 값입니다(0.02 = 상위 2%). 맞춤 오디언스에서는 null입니다.
number | null
필수
유사 오디언스의 경우: 유사도 구간의 하한을 비율로 나타낸 값입니다. 맞춤 오디언스와 1단계 유사 오디언스에서는 null입니다.
object[]
필수
광고 네트워크별 예상 매칭률입니다. 참여 오디언스와 지원되는 네트워크로 전송되지 않은 오디언스에서는 비어 있습니다.

속성

number | null
필수
예상 매칭률(백분율)의 하한입니다. 사용 가능해질 때까지 null입니다.
string
필수
매칭률 추정치를 제공한 광고 플랫폼입니다.사용 가능한 옵션: meta
string | null
필수
예상 매칭률의 사용 가능 여부입니다.사용 가능한 옵션: calculating, available, unavailable
number | null
필수
예상 매칭률(백분율)의 상한입니다. 사용 가능해질 때까지 null입니다.
number
필수
연결된 광고 계정에 성공적으로 업로드된 멤버 수입니다. 유사 오디언스와 참여 오디언스에서는 항상 0입니다.
string
필수
오디언스 표시 이름입니다.
string[]
필수
Whop이 이 오디언스를 전송하는 광고 네트워크에서의 오디언스 ID입니다.
number
필수
지금까지 소스에서 처리된 멤버 수입니다. 유사 오디언스와 참여 오디언스에서는 항상 0입니다.
number
필수
0부터 100까지의 처리 진행률입니다.
string | null
필수
유사 오디언스의 경우: 이 유사 오디언스의 기반이 된 오디언스입니다. 맞춤 오디언스에서는 null입니다.
string
필수
멤버 소스입니다. 업로드된 CSV, Whop People 필터 또는 소셜 참여 중 하나입니다. 참여 오디언스는 더 이상 생성할 수 없습니다.사용 가능한 옵션: csv_upload, people_filter, engagement
string
필수
오디언스 생성의 현재 상태입니다. pending 오디언스가 업로드할 광고 계정 등 무언가를 기다리고 있으면 error_message에 그 내용이 표시됩니다. 상태가 partial 또는 failed이면 error_message에 무엇이 잘못되었는지 설명됩니다.사용 가능한 옵션: pending, processing, ready, partial, failed
number
필수
소스에서 감지된 총 멤버 수입니다. 업로드된 목록은 CSV 행 수, 자동 오디언스는 매칭된 사람 수입니다. 유사 오디언스와 참여 오디언스에서는 항상 0입니다.
string
필수
오디언스가 마지막으로 업데이트된 시각(ISO 8601 타임스탬프)입니다.
Audience