광고 품질 원시 데이터 API
BI 플랫폼 분석용 Ad Quality Raw Data API 통해 Android 앱에서 매출, 클릭율, 광고 소스, 크리에이티브 ID, UX 패턴 등과 같은 노출 수준의 광고 품질 지표를 추출할 수 있습니다.
읽는 시간 7분최근 업데이트: 22일 전
광고 품질 원시 데이터 API 사용하면 광고 품질에서 노출 수준 데이터를 가져와 내부 BI 플랫폼에서 사용할 수 있습니다.
참고
원시 데이터 API 대한 액세스 권한은 세일즈 담당자에게 문의하십시오.
API 사용 방법
- 다음 단계를 완료하여 광고 품질 원시 데이터를 가져옵니다.
- 보고서를 다운로드할 URL 링크를 반환하는 API 요청 만들기
- 제공된 링크를 클릭하여 보고서를 다운로드합니다.
- 각 API 호출은 개별 앱과 단일 날짜에 대해 수행해야 합니다.
- 각 날짜의 데이터는 14일 동안 저장되고 사용할 수 있습니다.
- 예제: 1월 1일 데이터는 1월 14일까지 제공됩니다_
- 주어진 날짜에 대한 데이터는 UTC 기준 오전 8시부터 다음날에만 제공됩니다. 이 시간 이후에만 API 호출해야 합니다.
- 예제: 1월 1일 데이터는 UTC 기준 오전 8시 이후 1월 2일에만 제공됩니다_
- 데이터가 제공되면 2일 동안 계속 업데이트됩니다. 그 후에는 변경되지 않습니다.
- 예제: 1월 1일의 데이터는 1월 2일과 3일에 업데이트됩니다. 1월 3일 이후 데이터는 변경되지 않습니다_
- 날짜 및 앱 키는 리포트(파일)별로 고유하기 때문에 리포트에 포함되지 않습니다.
보고서 URL에 대한 API 요청
유효한 API 히트는 요청된 파일 링크를 반환합니다.
참고
파일은 한 시간 동안만 다운로드할 수 있습니다.
인증 유형
메서드
GET
필수 파라미터:
Name | Type | Description |
|---|---|---|
| 날짜 | 문자열 | YYYY-MM-DD(UTC 시간대) |
| appKey | 문자열 | 애플리케이션 키(플랫폼에서 확인) |
요청 예제 URL
요청 GET 'https://ad-quality.soomla.com/api/rawdata/v1?appKey=c0492d05&date=2022-07-12'``` ### Response Example URL##response-example-url```js{ "urls": [ "https://ad-quality-raw-data-api.s3.amazonaws.com/production/daily_dumps/2022-07-06/4/appkey%3Dc0492d05/20220707_070020_00066_jht7e_bucket-00000.gz?AWSAccessKeyId=ASIAZF2UTGTCQF2VSIVE&Expires=1657212469&Signature=u%2F2qOWmVw3iC2v21nqRYnOE443s%3D&x-amz-security-token=FwoGZXIvYXdzELv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDJtzCMfRJtv%2B7dCGjyLkAQX4BODoGx%2F92huTOXt86j31N1mrr2UvKuD9Qi5w1Kzu0B%2FfBrXlk4in64Z53Iy%2BOR1A5cGxvu25LObGXreMeCfdLz1S5p4WOM1ldmKgkWxYMvU01obpj3dvUXob4G1Gz13Uf5Go9B7THZlVV6g8Mhduk7zpIqYRmwYDCq4U2WBeN%2BKiJOT6Rf2SRDvpDXQJDW1bl%2FV4UfYFJUz8s%2B1HIVxmeVmrIzJVevD35Wjh4dGHuD0OTRSEL7NsTjzqtTZs7mUIWjqV2aJh8l8Rz%2BwG3d%2FGtgblKJ%2Fi3wE5X0xJjkQNJgm6WCiW1pqWBjIyuheodw%2FxNLedYFcSY7wuJa6iKhxdZQwumUZgp1TS0j2kfu8eSPe6D0jvsGhlpk4zYms%3D" ], "expiration": "2022-07-07 18:47:49"}
필드 정의
이 표에는 광고 품질 원시 데이터를 가져온 후 리포트에 표시되는 필드가 표시됩니다. 각각에 대한 설명과 포함할 내용의 예시를 볼 수 있습니다.
이전 단계를 사용하여 가져온 URL을 선택하여 리포트를 다운로드합니다.
필드 | Description | 예시 |
|---|---|---|
| Bigint | |
|
문자열
| |
|
문자열
| |
|
광고를 게재하는 네트워크 이름 | |
| dsp 이름이 있는 경우 | |
| 네트워크 인스턴스 이름 | |
| | |
| 어떤 노출이 발생했는지 지정하는 코드 | |
|
문자열
| |
|
문자열
| |
|
문자열
| |
|
문자열
| |
|
광고주 이름
| |
|
문자열
| |
| 게임에 표시되는 광고주 유형(iOS 스토어 ID, Android 패키지 이름, 브랜드 등)을 나타내는 필드 | |
| 1은 클릭이 발생했음을 나타내고 0은 클릭 없음을 나타내는 정수입니다. | |
| String, 이와 관련된 UX 패턴을 확인했나요?
Ad Quality 용어집
(q클릭, proximity_click, auto_click, early_click, hasty_click, 기타) | |
| Bigint, 클라이언트 타임스탬프(UTC 기준) | |
| 동영상 크리에이티브 타입에 적합합니다. 1은 동영상이 완료되었음을 나타내고 0은 완료되지 않았음을 나타냅니다. | |
| Bigint | |
| 사용자가 생성한 매출(USD). | |
| 앱 스토어 또는 Google Play 내 광고주의 앱 카테고리 | |
| 미국 Apple/Google 앱 스토어 평점 | |
| creative_type | 주요 광고 소재 유형: 플레이어블/동영상/이미지 | |
| 문자열, Ad Quality 광고 소재 ID | |
| 문자열 | |
| 문자열 배열 | |
| end_card_urls | 문자열 배열 | |
| 문자열 | |
| 문자열 배열 | |
| 사용자 순서의 노출 수입니다. 배너 및 네이티브의 경우 값: | |
| | |
| Bigint | |
| String, 노출이 있는 광고주의 개발자 | |
| 문자열 | |