본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트
  • 문서
  • 카카오모먼트
  • 고객파일 관리

사이드 메뉴

카카오맵

검색

카카오모먼트

고객파일 관리

이 문서는 고객파일 API 사용 방법을 안내합니다.

고객파일 목록 조회

기본 정보
메서드URL인증 방식
GEThttps://apis.moment.kakao.com/openapi/v4/customerFiles비즈니스 토큰

업로드된 고객파일 목록을 조회합니다.

광고그룹 생성 및 수정 시 [맞춤 타겟] > [내 데이터]에서 활용 가능합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 성공 시 JSON 객체로 생성한 고객파일 목록 정보를 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O

응답

본문
이름타입설명
-CustomerFile[]업로드된 고객파일 목록
CustomerFile
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
adidListKeyString고객파일 등록 Key
customerFileStatusString상태, 아래 중 하나
  • WAITING: 고객파일 모수추출 대기중
  • COMPLETE: 모수추출 완료
  • DELETE: 삭제 또는 삭제중인 상태
  • ERROR: 그 외 비정상적인 경우
  • MODIFYING: 수정된 모수 준비중
populationScoreLong타겟 모수
등록한 고객파일에서 추출된 카카오 사용자 수
준비 중인 고객파일은 모수 추출 이전 단계로 타게팅에 사용할 수 없으며, 고객파일을 등록 후 최대 6시간 이내에 모수 추출이 완료됨
readyBoolean준비완료 여부
createdDateString등록일시
고객파일을 수정한 경우 수정한 고객파일의 생성일시
lastModifyRequestDateString최근 수정일시
originalCreatedDateString최초 고객파일 등록 일시
고객파일을 수정한 경우 최초 등록한 고객파일의 생성일시
populationUpdateDateString타겟 업데이트 일시
타겟모수가 업데이트된 시간
typeString고객파일 등록 유형
sourceUrlString등록 URL
renewableBoolean갱신 여부
renewalExpireDateTimeString갱신 유효기간
타겟 생성일시로부터 90일

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/customerFiles" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
{
"id": 1,
"adAccountId": 1234,
"name": "첫번째_고객파일",
"adidListKey": "a1234b567890123cde45f6g7890hij23",
"customerFileStatus": "COMPLETE",
"ready": true,
"createdDate": "2020-01-01 00:00",
"lastModifyRequestDate": "2020-01-01 00:00",
"originalCreatedDate": "2020-01-01 00:00",
"populationUpdateDate": "2020-01-01 14:00"
}
]

고객파일 상세 조회

기본 정보
메서드URL인증 방식
GEThttps://apis.moment.kakao.com/openapi/v4/customerFiles/${ID}비즈니스 토큰

고객파일 상세 정보를 조회합니다.

사용자 비즈니스 토큰을 헤더에 담아 GET으로 고객파일 번호를 전달하여 요청합니다. 요청 성공 시 응답은 대상 고객파일의 상세 정보를 포함합니다.

이 API는 고객파일마다 5초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
경로 변수
이름타입설명필수
IDLong고객파일 번호O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
adidListKeyString고객파일 등록 Key
readyBoolean준비완료 여부
customerFileStatusString상태, 아래 중 하나
  • WAITING(고객파일 모수추출 대기중)
  • COMPLETE(모수추출 완료)
  • DELETE(삭제 또는 삭제중인 상태)
  • MODIFYING(수정된 모수 준비중)
  • ERROR(그 외 비정상적인 경우)
  • TRANSFORM_ERROR(URL 유형에서 CSV파일 등록에 실패한 상태)
populationScoreLong타겟 모수
등록한 고객파일에서 추출된 카카오 사용자 수로
준비 중인 고객파일은 모수 추출 이전 단계로 타게팅에 사용할 수 없으며,
고객파일을 등록 후 최대 6시간 이내에 모수 추출이 완료됨
createdDateString등록일시
고객파일을 수정한 경우 수정한 고객파일의 생성일시
lastModifyRequestDateString최근 수정일시
originalCreatedDateString최초 고객파일 등록일시
고객파일을 수정한 경우 최초 등록한 고객파일의 생성일시
populationUpdateDateString타겟 업데이트 일시
타겟모수가 업데이트된 시간
typeString고객파일 등록 유형
sourceUrlString등록 URL
renewableBoolean갱신여부
renewalExpireDateTimeString갱신 유효기간

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/customerFiles/${ID}" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 2656,
"adAccountId": 27429,
"name": "고객파일 등록",
"adidListKey": "c8010decafde484eb33284b53a290c30",
"customerFileStatus": "MODIFYING",
"populationScore": 7170,
"ready": true,
"createdDate": "2024-02-06T00:03:59",
"lastModifyRequestDate": "2024-02-06T15:35:44",
"originalCreatedDate": "2024-02-05T16:58:20",
"populationUpdateDate": "2024-02-06T01:34:00",
"type": "URL",
"sourceUrl": "https://sample-url.com/*****valid1.csv",
"renewable": true,
"renewalExpireDateTime": "2024-05-06T00:03:58",
"transformStatus": "COMPLETED",
"transformDateTime": "2024-02-06T00:16:19"
}

고객파일 등록

파일로 등록

기본 정보
메서드URL인증 방식
POSThttps://apis.moment.kakao.com/openapi/v4/customerFiles비즈니스 토큰

광고그룹 생성 및 수정 시 사용할 고객파일을 파일 형태로 업로드할 수 있습니다.

이 API는 Multipart/form-data 방식만 지원합니다. 하나의 고객파일은 10개 이하의 CSV 파일(총합 200MB 이하)을 업로드하여 구성할 수 있으며, 계정당 최대 50개의 고객파일을 등록할 수 있습니다. 파일 등록 후 최대 6시간 이내로 모수가 추출됩니다. 고객파일 파일 내용 형식은 가이드예제를 참고합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 고객파일 이름, 파일을 필수 파라미터로 전달해야 합니다. 성공 시 등록에 성공한 고객파일의 상세 정보를 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

이 API는 사용자 계정, 광고계정마다 5초에 한 번씩 요청 가능하도록 제한되어 있습니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
본문
이름타입설명필수
nameString고객파일 이름
한글, 영문, 특수문자, 공백을 허용하며 120자 이내
O
filesMultipartFile고객파일
MimeTypetext/csvcsv 확장자를 가진 파일
최대 10개의 파일 업로드 가능
총합 200MB까지 허용
O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
successCountInteger성공 횟수
failedCountInteger실패 횟수
successFileUrlString성공 데이터 파일 URL
failedFileUrlString실패 데이터 파일 URL
fileTypeString파일 식별자 유형
ADID
customerFileStatusString상태
WAITING (대기중)
createdDateString등록일시

예제

요청
curl -X POST "https://apis.moment.kakao.com/openapi/v4/customerFiles" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}" \
-H "Content-Type: multipart/form-data" \
-F "files=@local/sample1.csv" \
-F "files=@local/sample2.csv" \
-F "files=@local/sample3.csv" \
-F "name=첫번째_고객파일"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 1,
"adAccountId": 1234,
"name": "첫번째_고객파일",
"successCount": 100,
"failedCount": 0,
"successFileUrl": "https://stwg.kakaocdn.net/success.csv",
"fileType": "ADID",
"customerFileStatus": "WAITING",
"createDate": "2020-01-01 00:00:00"
}

URL로 등록

기본 정보
메서드URL인증 방식
POSThttps://apis.moment.kakao.com/openapi/v4/customerFiles/url비즈니스 토큰

광고그룹에서 사용할 고객파일을 URL로 등록할 수 있습니다.

CSV 형식의 ADID(Advertiser ID) 목록이 존재하는 파일 URL을 등록하여 고객파일 타겟을 생성할 수 있습니다. URL은 http:// 또는 https:// 형식의 퍼블릭 엑세스가 가능하고 ADID 리스트를 다운로드 받을 수 있는 URL이어야 합니다. CSV 파일은 파일로 등록 API와 달리 별도의 파일 용량 제한이 없습니다. CSV 파일 내용 형식은 가이드예제를 참고합니다. 타겟 등록 후 최대 6시간 이내로 모수가 추출됩니다.

URL로 고객파일 등록 시, 갱신 옵션을 포함하여 요청하면 카카오모먼트는 하루 1회 URL을 정기적으로 호출하여 ADID 리스트를 갱신합니다. 갱신이 완료되기 전까지는 갱신 전 파일로 광고그룹 타겟은 작동합니다. 갱신 유효기간은 최초 타겟 등록으로부터 90일까지입니다. 갱신 유효기간이 완료된 이후에는 타겟을 신규 생성해야 합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 성공 시 등록에 성공한 고객파일의 상세 정보를 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

이 API는 사용자 계정, 광고계정마다 5초에 한 번씩 요청 가능하도록 제한되어 있습니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
본문
이름타입설명필수
nameString고객파일 이름
한글, 영문, 특수문자, 공백을 허용하며 120자 이내
O
fileTypeString파일 식별자 유형
ADID
O
sourceUrlString등록 URLO
renewableBoolean갱신여부
true일 경우 일 1회 갱신 수행
O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
customerFileStatusString상태
WAITING (대기중)
createdDateString등록일시
lastModifiedDateString최근 수정일시
originalCreatedDateString최초 고객파일 등록일시
고객파일을 수정한 경우, 최초 등록한 고객파일의 생성일시
typeString고객파일 등록 유형
sourceUrlString등록 URL
renewableBoolean갱신여부
renewalExpireDateTimeString갱신 유효기간
타겟 생성일시로부터 90일

예제

요청
curl -X POST "https://apis.moment.kakao.com/openapi/v4/customerFiles/url" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}" \
-H "Content-Type: application/json" \
-d '{
"name": "test9",
"fileType": "ADID",
"sourceUrl": "https://sample-url.com/this-is-sample-file.csv",
"renewable": true
}'
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 1234,
"adAccountId": 12345,
"name": "test9",
"adidListKey": "1be324a5e8314cec9ddc526e2e9858a7",
"customerFileStatus": "WAITING",
"ready": false,
"createdDate": "2024-01-25T19:31:41.571411",
"lastModifiedDate": "2024-01-25T19:31:41.571411",
"originalCreatedDate": "2024-01-25T19:31:41.489213",
"populationUpdateDate": null,
"type": "URL",
"sourceUrl": "https://sample-url.com/*****e-file.csv",
"renewable": false,
"renewalExpireDateTime": null,
"transformStatus": "STANDBY",
"transformDateTime": null
}

고객파일 수정

파일로 수정

기본 정보
메서드URL인증 방식
PUThttps://apis.moment.kakao.com/openapi/v4/customerFiles비즈니스 토큰

등록되어 있는 고객파일 타겟을 수정할 수 있습니다.

customerFileStatus 상태가 COMPLETE인 타겟만 수정이 가능하며, 파일 유형으로 등록한 타겟은 파일 유형으로만 수정이 가능합니다. 수정 가능 항목은 파일(files) 입니다. 타겟 수정 후 최대 6시간 이내로 모수가 추출됩니다. 수정이 완료되기 전까지는 수정 전 타겟 모수로 광고그룹 타겟팅은 작동하며, 수정이 완료되면 수정된 타겟으로 광고그룹 타겟이 변경됩니다. 이 API는 Multipart/form-data 방식만 지원합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청합니다. 성공 시 등록에 성공한 고객파일의 상세 정보를 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

이 API는 고객파일마다 5초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
본문
이름타입설명필수
idLong고객파일 번호O
filesMultipartFile고객파일
MimeTypetext/csvcsv 확장자를 가진 파일
최대 10개의 파일 업로드 가능
총합 200MB까지 허용
O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
successCountInteger성공 횟수
failedCountInteger실패 횟수
successFileUrlString성공 데이터 파일 URL
failedFileUrlString실패 데이터 파일 URL
fileTypeString파일 식별자 유형
ADID
customerFileStatusString상태
WAITING (대기중)
createdDateString등록일시

예제

요청
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/customerFiles" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}" \
-H "Content-Type: multipart/form-data" \
-F "files=@local/sample1.csv" \
-F "files=@local/sample2.csv" \
-F "files=@local/sample3.csv" \
-F "id=1234"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 1,
"adAccountId": 1234,
"name": "첫번째_고객파일",
"successCount": 100,
"failedCount": 0,
"successFileUrl": "https://stwg.kakaocdn.net/success.csv",
"fileType": "ADID",
"customerFileStatus": "WAITING",
"createDate": "2020-01-01 00:00:00"
}

URL로 수정

기본 정보
메서드URL인증 방식
PUThttps://apis.moment.kakao.com/openapi/v4/customerFiles/url비즈니스 토큰

등록된 고객파일 타겟을 수정할 수 있습니다.

URL 유형으로 등록한 타겟은 URL 유형으로만 수정이 가능합니다.

수정 가능 항목은 URL(sourceUrl), 갱신옵션(renewable)입니다. 타겟 수정 후 최대 6시간 이내로 모수가 추출됩니다. 수정이 완료되기 전까지는 수정 전 타겟 모수로 광고그룹 타겟팅은 작동하며, 수정이 완료되면 수정된 타겟으로 광고그룹 타겟이 변경됩니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청합니다. 실패 시 에러 코드에서 원인을 확인합니다.

이 API는 고객파일마다 5초에 한 번씩 요청이 가능하도록 제한되어 있습니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
본문
이름타입설명필수
idLong고객파일 번호O
fileTypeString파일 식별자 유형
ADID
O
sourceUrlString등록 URLO
renewableBoolean갱신여부
true일 경우 일 1회 갱신 수행
O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
customerFileStatusString상태
WAITING (대기중)
createdDateString등록일시
lastModifiedDateString최근 수정일시
originalCreatedDateString최초 고객파일 등록일시
고객파일을 수정한 경우, 최초 등록한 고객파일의 생성일시
typeString고객파일 등록 유형
sourceUrlString등록 URL
renewableBoolean갱신여부
renewalExpireDateTimeString갱신 유효기간
타겟 생성일시로부터 90일

예제

요청
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/customerFiles/url" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}" \
-H "Content-Type: application/json" \
-d '{
"id": 9999,
"sourceUrl": "https://sample-url.com/customer_file_invalid1.csv",
"renewable": false
}'
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 2611,
"version": 0,
"createdDate": "2024-01-31T18:24:32",
"lastModifiedDate": "2024-01-31T18:24:32",
"adAccountId": 27429,
"name": "test1",
"fileUrl": null,
"payloadFileUrl": null,
"status": "WAITING",
"adidListKey": "df3078a4a3f44cb6bc9041d1ca77c73f",
"fileType": "ADID",
"type": "URL",
"sourceUrl": "ttps://sample-url.com/*****e-file.csv",
"renewable": false,
"renewalExpireDateTime": null,
"payloadFileUploadDate": null,
"dataRegStatusTargeting": "STANDBY",
"dataRegStatusPopulation": "STANDBY",
"transformStatus": "STANDBY",
"transformDateTime": null,
"originalCreatedDate": "2024-01-30T14:34:22",
"populationUpdateDate": null,
"modifyStatus": "WAITING",
"lastModifiedDate": "2024-01-31T18:24:32.234037",
"maskedSourceUrl": "https://sample-url.com/*****e-file.csv"
}

고객파일 이름 수정

기본 정보
메서드URL인증 방식
PUThttps://apis.moment.kakao.com/openapi/v4/customerFiles/name비즈니스 토큰

고객파일 이름을 수정합니다.

이미 등록된 파일의 수정은 불가능하며 이름만 수정 가능합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 PUT으로 요청합니다. 이름을 수정할 고객파일 번호와 수정할 고객파일 이름을 필수 파라미터로 전달해야 합니다. 성공 시 수정된 고객파일 정보를 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
본문
이름타입설명필수
idLong고객파일 번호O
nameString수정할 고객파일 이름
한글, 영문, 특수문자, 공백을 허용하며 120자 이내
O

응답

본문
이름타입설명
idLong고객파일 번호
adAccountIdLong광고계정 번호
nameString고객파일 이름
adidListKeyString고객파일 등록 Key
readyBoolean준비완료 여부
customerFileStatusString상태, 아래 중 하나
  • WAITING(고객파일 모수추출 대기중)
  • COMPLETE(모수추출 완료)
  • DELETE(삭제 또는 삭제중인 상태)
  • MODIFYING(수정된 모수 준비중)
  • ERROR(그 외 비정상적인 경우)
  • TRANSFORM_ERROR(URL 유형에서 CSV파일 등록에 실패한 상태)
createdDateString등록일시
lastModifiedDateString최근 수정일시
originalCreatedDateString최초 고객파일 등록 일시
고객파일을 수정한 경우 최초 등록한 고객파일의 생성일시
populationUpdateDateString타겟 업데이트 일시
타겟모수가 업데이트된 시간

예제

요청
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/customerFiles/name" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}" \
-d '{
"id": 123,
"name": "변경한_고객파일이름"
}'
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 2687,
"adAccountId": 27429,
"name": "변경한_고객파일이름",
"adidListKey": "da4a57899e43428bb7e47b09ac9c4311",
"customerFileStatus": "COMPLETE",
"ready": true,
"createdDate": "2024-02-07T00:03:38",
"lastModifiedDate": "2024-02-07T17:58:11.591512",
"originalCreatedDate": "2024-02-06T17:12:15",
"populationUpdateDate": "2024-02-07T01:34:00",
"type": "URL",
"sourceUrl": "https://sample-url.com/*****valid1.csv",
"renewable": true,
"renewalExpireDateTime": "2024-05-07T00:03:38",
"transformStatus": "COMPLETED",
"transformDateTime": "2024-02-07T00:16:23"
}

고객파일 삭제

기본 정보
메서드URL인증 방식
DELETEhttps://apis.moment.kakao.com/openapi/v4/customerFiles/${ID}비즈니스 토큰

등록된 고객파일을 삭제합니다.

광고그룹에서 사용 중일 경우 삭제가 불가능합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 DELETE로 요청하고, 성공 시 HTTP 상태 코드 200에 응답 본문은 없습니다. 실패 시 에러 코드에서 원인을 확인합니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
경로 변수
이름타입설명필수
IDLong고객파일 번호O

예제

요청
curl -v -X DELETE "https://apis.moment.kakao.com/openapi/v4/customerFiles/${ID}" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

고객파일 여러 개 삭제

기본 정보
메서드URL인증 방식
DELETEhttps://apis.moment.kakao.com/openapi/v4/customerFiles비즈니스 토큰

복수의 고객파일을 한 번에 고객파일을 삭제합니다.

광고그룹에서 사용 중일 경우 삭제가 불가능합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 DELETE로 요청하고, 성공 시 HTTP 상태 코드 200에 응답 본문은 없습니다. 실패 시 에러 코드에서 원인을 확인합니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
쿼리 파라미터
이름타입설명필수
customerFileIdsString고객파일 번호
여러 개의 고객파일 번호를 쉼표(,)로 구분한 하나의 문자열로 전달
O

예제

요청
curl -v -X DELETE "https://apis.moment.kakao.com/openapi/v4/customerFiles?customerFileIds=${CUSTOMER_FILE_ID},${CUSTOMER_FILE_ID}" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
응답
{
"successCount": 1,
"failCount": 1,
"errorMessages": ["타겟을 사용 중인 오디언스가 있습니다."]
}

고객파일 사용 현황 조회

기본 정보
메서드URL인증 방식
GEThttps://apis.moment.kakao.com/openapi/v4/customerFiles/usages/${ID}비즈니스 토큰

지정한 고객파일을 사용 중인 광고그룹 및 캠페인 목록을 조회합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청하며, 고객파일 번호를 필수 파라미터로 전달해야 합니다. 성공 시 고객파일을 사용 중인 광고그룹 및 캠페인의 목록을 받습니다. 실패 시 에러 코드에서 원인을 확인합니다.

요청

헤더
이름설명필수
AuthorizationAuthorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountIdadAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
경로 변수
이름타입설명필수
IDLong고객파일 번호O

응답

본문
이름타입설명
-AdGroupAndCampaign[]고객파일을 사용 중인 광고그룹 및 캠페인 목록
AdGroupAndCampaign
이름타입설명
adGroupAdGroup광고그룹
campaignCampaign캠페인

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/customerFiles/usages/${ID}" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
{
"adGroup": {
"id": 56,
"name": "첫번째_광고그룹",
"adGroupStatus": [
"LIVE"
],
"adGroupType": "DISPLAY"
},
"campaign": {
"id": 78,
"name": "첫번째_캠페인",
"campaignTypeGoal": {
"campaignType": "DISPLAY",
"goal": "VISITING"
}
}
}
]

더 보기

도움이 되었나요?