고객 파일

고객파일 등록 및 수정 요청

• 고객 파일과 관련된 API는 잠재고객 API 에서 확인이 가능 합니다.
• 등록된 고객 파일은 광고그룹에서 활용 될 수 있습니다. 광고 그룹 - 잠재고객을 참고 하세요

고객파일 추가/제거 요청

API 정의

• 기존 고객파일 타겟에 일부 adid를 추가하거나 일부 adid를 제거하는 API 입니다.
• 고객파일 추가/제거 요청 API에 주요 스펙이 정의되어 있습니다.
• 파일 업로드의 경우 100MB의 파일 용량 제한 및 업로드에 20초의 timeout 제한 사항이 있습니다.
• 고객파일은 최대 600MB 까지 추가가 가능합니다.

콜백 동작 방식

• 분석 작업 진행 완료 및 실패 여부를 파악할 수 있도록 callbackUrl을 등록할 수 있습니다.
• 고객 파일 추가 또는 삭제 호출 시 '유효성 체크 + 업로드 처리'에 대해 성공/실패 응답을 한 뒤, 분석 완료 결과는 등록하신 콜백 Url로 전달드립니다.
• 분석 완료 전까지 동일 adidLibraryNo에 대하여 고객파일 추가/제거 요청을 할 수 없습니다.
• 콜백 후에도 타겟 모수가 바로 바뀌지 않습니다. ('N' 시간 뒤 세그먼트 갱신 작업이 진행됩니다)

콜백 스팩

고객파일 추가/제거 요청 분석 결과를 callbackUrl로, Content-type: application/json의 body 를 갖고 있는 HTTP POST 요청을 보냅니다.
status 필드는 다음과 같은 값을 가질 수 있습니다.

• COMPLETED : 분석이 성공적으로 완료되었습니다
• FAILED : 분석에 실패했습니다

1. 고객파일 추가/제거 요청 등록 완료

POST
Url : {callbackUrl}
Content-Type: application/json
{
    "adidLibraryNo": 1,
    "status": "COMPLETED",
    "message": "Analyze success"
    "requestedAt": "2024-01-01T01:59:59.000+0000"
}

2. 고객파일 추가/제거 요청 등록 실패

POST
Url : {callbackUrl}
Content-Type: application/json
{
    "adidLibraryNo": 1,
    "status": "FAILED",
    "message": "분석 결과 파일이 없거나 adid 카운트값이 0이라서 처리할 수 없습니다. "
    "requestedAt": "2024-01-01T01:59:59.000+0000",
}