당근 광고 OpenAPI 베타 출시…광고 등록·수정·성과 조회 연동

당근이 광고를 등록·수정하고 성과를 조회할 수 있는 광고 OpenAPI 베타를 출시했다. 광고주는 당근 광고 관리 화면에 직접 접속하는 대신 자체 광고 관리 도구나 내부 대시보드를 연결해 운영 업무를 처리할 수 있다.

연동 기능은 광고 관리와 성과 조회, 전환 이벤트 전송으로 나뉜다. 캠페인·광고그룹·소재를 조회하거나 새로 등록하고 수정할 수 있으며, 같은 단위로 기간별 성과를 불러올 수 있다. 구매와 장바구니 담기 등 전환 이벤트를 보내는 기능도 포함했다.

API 키는 전문가모드의 고객센터 아래 ‘온라인 문의’에서 발급한다. ‘문의하기’에서 ‘광고 도구 및 전환’, ‘OpenAPI 키 발급’을 차례로 선택하고, 연동할 광고 계정의 광고주 ID를 지정해 문의를 등록하는 방식이다. 등록 후에는 키를 확인할 수 있는 링크가 전달된다.

키는 광고주 ID와 사용 유형 단위로 발급된다. 새 키를 발급받는 즉시 기존 키가 폐기되므로, 같은 계정의 인증 정보를 교체할 때도 종전 키를 계속 사용할 수는 없다.

당근은 광고 계정별로 호출 횟수를 제한한다. 광고 관리와 성과 조회는 1분당 60회, 이벤트 전송은 1초당 100회가 한도다. 광고 관리·조회와 이벤트 전송의 집계 시간 단위가 서로 다르다.

한도를 넘긴 요청에는 429 응답을 반환하고 해당 요청은 처리하지 않는다. 광고에 반영되지 않은 요청은 일정 시간을 두고 다시 전송하는 방식이다. 한도 초과가 반복되면 광고 운영정책에 따라 API 이용이 제한될 수 있으며, 호출 한도는 서비스 상황에 따라 조정될 수 있다.