Criteo 연동

베타

Criteo 연동은 실제 광고주 계정으로 검증 중입니다. adstage의 Criteo 파트너 앱 등록이 끝날 때까지 대시보드의 Criteo 카드는 출시 예정으로 표시되며, 등록이 끝나면 아래에서 설명하는 비용 연동 탭이 열립니다. 먼저 연동하고 싶거나 adstage 수치가 Criteo 콘솔과 다르면 adstage 고객지원팀에 알려 주세요.

adstage에서는 Criteo 캠페인의 광고 비용·노출·클릭·앱 설치 수를 자동으로 수집할 수 있습니다. API 키를 발급받아 입력하는 대신, Criteo 동의 화면에서 광고주 관리자가 adstage의 읽기 접근을 허용하는 방식입니다. Criteo 연동은 비용 연동 탭 하나로 구성됩니다.

1. 연동 개요

adstage 대시보드 연동 > 광고 채널 연동 > Criteo에서 접근을 허용하면 다음과 같이 동작합니다.

기능	지원 여부	설명
비용 수집	지원	캠페인별 비용·노출·클릭·앱 설치 수를 4시간마다 자동 수집
전환 전송	지원하지 않음	Criteo는 측정 업체가 전환을 돌려보내는 규격을 공개하지 않습니다. 6절 참고
트래킹 링크 템플릿	지원하지 않음	커스텀 링크의 채널에 `criteo`를 쓰면 `criteo.ads` 채널로 집계됩니다

2. 사전 준비

Criteo 권한: 접근을 허용하는 사람은 해당 Criteo 광고주의 관리자(Admin) 또는 비즈니스 매니저여야 합니다. 권한이 없는 사용자로 로그인하면 허용할 광고주가 보이지 않습니다. Criteo 문서 기준으로는 테크니컬 매니저도 승인할 수 있습니다.
팝업 허용: 동의 화면은 새 창(팝업)으로 열립니다. 브라우저에서 adstage의 팝업을 허용해 주세요.
API 키 불필요: Criteo 콘솔에서 키나 토큰을 발급받을 필요가 없고, adstage에 입력하는 칸도 없습니다.

3. 연동하기

연동 > 광고 채널 연동 > Criteo의 비용 연동 탭에서 Criteo 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 Criteo에서 접근 허용 버튼을 누를 수 없습니다.
Criteo에서 접근 허용을 클릭합니다. 새 창에 Criteo 동의 화면이 열립니다.
Criteo 계정으로 로그인하면 Access request 페이지에 요청한 조직·앱, 권한 수준, 허용할 수 있는 광고주 목록이 표시됩니다. adstage에 공유할 광고주를 선택하고 Approve를 클릭합니다. adstage가 요청하는 권한은 통계 읽기(Analytics Read) 전용이며, 캠페인을 변경하는 권한은 요청하지 않습니다.
동의가 끝나면 창이 자동으로 닫히고 adstage에 Criteo 광고주 선택 창이 열립니다. 동의 화면에서 공유한 광고주가 광고주 이름과 광고주 ID로 나열됩니다. 비용을 수집할 광고주를 선택하고(여러 개 가능) N개 계정 확정을 클릭합니다.
확정 즉시 선택한 광고주마다 계정이 만들어지고 상태가 준비 중으로 표시됩니다. 첫 수집은 바로 돌지 않고 다음 4시간 주기(KST 1시, 5시, 9시, 13시, 17시, 21시)에 진행되며, 그때 상태가 성공 또는 실패로 바뀝니다. 화면에도 "연동 상태는 4시간 내에 업데이트됩니다"라고 안내됩니다.

주의하세요

동의 화면에서 광고주를 하나도 선택하지 않고 승인하면 "공유된 Criteo 광고주가 없습니다" 메시지가 표시되고 연동이 진행되지 않습니다. 다시 허용하면서 광고주를 선택해 주세요.

동의 창을 그냥 닫거나 거부하면 "Criteo 연결이 취소되었습니다" 안내가 표시되며, 저장되는 것은 없습니다.

이미 연동된 광고주를 다시 허용하면 건너뛰지 않고 새 접근 권한으로 교체됩니다("이미 연결된 Criteo 광고주 N개를 다시 인증했습니다"). 접근이 만료됐을 때 재연동하는 방법이기도 합니다.

4. 연동 계정과 상태 확인하기

비용 연동 탭 아래 목록에서 연동된 광고주를 확인합니다.

계정명: Criteo 광고주 이름과 그 아래 광고주 ID
상태: 준비 중, 성공, 실패
데이터가 업데이트된 최근 일시: 비용 데이터가 실제로 저장된 마지막 시각
관리: 삭제 아이콘. 계정 삭제 확인 창에서 삭제를 클릭하면 연동이 해제됩니다

계정을 삭제하면 그 광고주의 수집이 중단되고, 이미 수집된 데이터는 adstage에 남습니다. Criteo 비용 연동 스위치를 끄면 모든 Criteo 계정의 수집이 함께 멈춥니다.

상태 메시지 설명

준비 중: 계정을 막 연동했거나 다시 허용한 직후입니다. 다음 수집에서 상태가 확정됩니다.
성공: Criteo 보고서 호출이 정상입니다. 광고를 집행하지 않아 데이터가 0건이어도 성공으로 표시됩니다.
실패: Criteo가 접근을 거부했습니다(접근 만료·철회 등). 표시에 마우스를 올리면 실패 횟수와 "인증 실패 — 다시 연결하거나 키를 확인해 주세요" 같은 요약이 보이고, 세부정보를 누르면 원문을 볼 수 있습니다. 실패 상태여도 매 주기 다시 시도하며, 원인이 해결되면 자동으로 성공으로 돌아옵니다.

Criteo 측 일시 오류나 요청 제한은 상태를 바꾸지 않고 다음 주기에 다시 시도합니다.

데이터 미수집 경고

상태가 성공이어도 비용 데이터가 3일 넘게 저장되지 않으면 상태 옆에 ⚠️ 경고와 함께 조치 필요 안내("N일째 광고비 데이터가 수집되지 않았습니다")가 표시됩니다. 광고를 집행 중인데 이 경고가 보이면 연동을 확인해 주세요. 데이터가 다시 들어오면 경고는 자동으로 사라집니다.

Criteo가 발급한 접근 권한은 허용한 뒤 6개월이 지나면 만료되고, 허용한 사용자가 광고주에서 빠지거나 역할이 바뀌면 그 전에도 폐기됩니다. 광고주가 Criteo 동의 대시보드에서 adstage 앱의 접근을 철회해도 같습니다. 만료 전에 미리 경고가 표시되지는 않으며, 만료되면 상태가 실패로 바뀝니다. 이때는 Criteo에서 접근 허용을 다시 눌러 같은 광고주를 선택하면 재연동됩니다.

5. 수집되는 데이터

항목	설명
수집 주기	4시간마다 (KST 1시, 5시, 9시, 13시, 17시, 21시)
수집 범위	최근 30일 (D-30 ~ D-1). 수집 당일(D-0) 데이터는 수치가 확정되지 않아 수집하지 않습니다
데이터 계층	캠페인 × 일자
수집 지표	비용(AdvertiserCost), 노출 수(Displays), 클릭 수(Clicks), 앱 설치 수(AppInstalls)
통화·시간대	원화(KRW), 한국 시간(Asia/Seoul) 기준으로 보고서를 요청합니다
채널명	`criteo.ads`

리포트에서는 매체가 보고한 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다. 앱 설치 수는 매체 전환 수로 저장되어 리포트에서는 전환수 (Channel) 지표로 보입니다. Criteo가 집계한 판매 수·매출(SalesAllClientAttribution, RevenueGeneratedAllClientAttribution)도 함께 받아 보관하지만 아직 리포트 지표로는 제공하지 않습니다.

매 주기 최근 30일을 다시 받아 오므로, Criteo가 뒤늦게 갱신한 설치 수도 최신 값으로 맞춰집니다. 첫 수집도 같은 범위(D-30 ~ D-1)로 진행됩니다.

통화에 대해

adstage는 Criteo 보고서를 원화(KRW)로 요청합니다. Criteo 광고주 계정의 결제 통화가 다르면 Criteo가 환산한 금액이 들어오므로 Criteo 콘솔의 표시 금액과 차이가 날 수 있습니다.

6. 전환 전송과 트래킹 링크

전환 전송은 지원하지 않습니다. Criteo는 측정 업체가 설치·구매 같은 전환을 돌려보내는 포스트백 규격을 공개 문서로 제공하지 않으며, 공개된 앱 이벤트 전송 규격도 Criteo와 제휴한 모바일 데이터 파트너를 대상으로 합니다. adstage가 Criteo와 제휴하면 이 항목이 열립니다. 매체사 포스트백의 매체 프리셋에도 Criteo는 없습니다.

Criteo 전용 트래킹 링크 템플릿도 아직 없습니다. 클릭을 adstage로 받으려면 커스텀 링크를 만들고 채널에 criteo를 넣어 주세요. 리포트에서 criteo.ads로 집계되어 비용과 같은 채널에 모입니다. 캠페인 이름을 Criteo 캠페인 이름과 똑같이 쓰면 비용과 클릭·전환이 같은 행으로 합쳐집니다.

7. 주의사항

아래 사항을 주의해 주세요.

Criteo와 adstage 간에 수치 차이가 발생할 수 있습니다. 집계 시점, 시간대, 통화 환산, 어트리뷰션 기준의 차이 때문입니다.
접근 권한은 허용한 사용자에게 묶여 있습니다. 담당자가 바뀌면 새 담당자가 다시 허용해 주세요.
Criteo API는 동의한 계정당 분당 10회로 요청을 제한하므로, 광고주를 여러 개 연동하면 수집이 순서대로 진행돼 시간이 더 걸릴 수 있습니다.

8. 문제 해결

광고주 선택 창이 비어 있거나 열리지 않을 때

광고주 선택 확인: 동의 화면에서 광고주를 선택하지 않고 승인하면 "공유된 Criteo 광고주가 없습니다"가 표시됨
권한 확인: 로그인한 Criteo 사용자가 광고주의 관리자(Admin)·비즈니스 매니저가 아니면 허용할 광고주가 보이지 않음
팝업 차단 확인: "Criteo 로그인 창이 차단되었습니다" 안내가 보이면 팝업을 허용한 뒤 다시 시도

상태가 실패일 때

요약 확인: 마우스를 올려 "인증 실패"가 보이면 접근이 만료·철회된 것이므로 Criteo에서 접근 허용으로 다시 허용
담당자 확인: 허용했던 사용자가 광고주에서 빠지거나 역할이 바뀌지 않았는지 확인
일시 오류: "매체 측 일시적 오류입니다. 자동으로 다시 시도합니다"는 조치 없이 다음 주기에 재시도됨

성공인데 데이터가 없을 때

집행 확인: Criteo에서 광고가 실제로 노출·과금되고 있는지 확인
수집 범위 확인: 수집 범위는 D-30 ~ D-1이므로 오늘 시작한 캠페인은 내일 수집부터 보임
경고 확인: ⚠️ 경고가 표시되면 연동 상태를 확인하고, 해결되지 않으면 adstage 고객지원팀에 문의

9. 자주 묻는 질문

Q. Criteo 콘솔에서 API 키를 만들어야 하나요?

아니요. 동의 화면에서 허용만 하면 됩니다. 키·토큰을 adstage에 입력하는 칸도 없습니다.

Q. 광고주가 여러 개인데 한 번에 연동할 수 있나요?

네. 동의 화면에서 여러 광고주를 공유하고, 광고주 선택 창에서 전체 선택하거나 필요한 것만 골라 확정하면 광고주마다 계정이 만들어집니다.

Q. 허용한 담당자가 퇴사하면 어떻게 되나요?

Criteo가 접근 권한을 폐기해 상태가 실패로 바뀝니다. 권한이 있는 다른 담당자가 Criteo에서 접근 허용을 다시 진행해 주세요.

Q. 어디에서 adstage의 접근을 철회하나요?

Criteo 문서 기준으로 Criteo 동의 대시보드에서 허용한 앱 목록·권한·날짜를 확인하고 철회할 수 있습니다. 메뉴 위치는 Criteo 담당자에게 문의해 주세요.

10. 참고 문서

Criteo API — OAuth 앱 Authorization Code 흐름 — 동의 URL, 접근 권한 유효기간(6개월), 폐기 조건
Criteo API — 권한 요청(Authorization Requests) — 승인할 수 있는 역할, Access request 화면, 접근 철회
Criteo API — 동의 URL 생성 — 광고주 관리자·비즈니스 매니저에게 동의 요청
Criteo Marketing Solutions — 캠페인 통계(Campaign Statistics) — 수집 지표 정의, 통화·시간대 파라미터
Criteo 모바일 엔드포인트 규격 — 모바일 데이터 파트너용 앱 이벤트 규격(전환 전송 미지원의 근거)