Ad Quality 원시 데이터 API
Ad Quality 원시 데이터 API를 통해 Android 앱에서 매출, 클릭률, 광고 소스, 광고 소재 ID, UX 패턴 등 노출 수준의 광고 품질 지표를 추출하여 BI 플랫폼 분석에 활용할 수 있습니다.
읽는 시간 1분최근 업데이트: 2일 전
Ad Quality 원시 데이터 API를 사용하면 Ad Quality에서 노출 수준의 데이터를 가져와 내부 BI 플랫폼에서 활용할 수 있습니다.
참고
원시 데이터 API에 액세스하려면 세일즈 담당자에게 문의하십시오.
API 사용 방법
- Ad Quality 원시 데이터를 가져오려면 다음 단계를 완료해야 합니다.
- 리포트를 다운로드하는 URL 링크를 반환하는 API 요청을 만듭니다.
- 제공된 링크를 클릭하여 리포트를 다운로드합니다.
- 각 API 호출은 개별 앱과 한 가지 날짜에 대한 호출이어야 합니다.
- 각 날짜의 데이터는 14일 동안 저장되어 확인할 수 있습니다.
- 예: 1월 1일 데이터는 1월 14일까지 이용 가능합니다.
- 특정 날짜 데이터는 다음 날 오전 8시(UTC 기준)부터 확인할 수 있습니다. 이 시간 이후에만 API를 호출하십시오.
- 예: 1월 1일 데이터는 1월 2일 오전 8시(UTC 기준) 이후에만 이용 가능합니다.
- 데이터는 이용 가능하게 된 후 2일간 계속 업데이트됩니다. 그 이후에는 업데이트되지 않습니다.
- 예: 1월 1일 데이터는 1월 2일과 1월 3일에 업데이트됩니다. 1월 3일 이후에는 데이터가 업데이트되지 않습니다.
- 날짜 및 앱 키는 리포트(파일)마다 고유하므로 포함되지 않습니다.
리포트 URL을 위한 API 요청
유효한 API 요청 시 요청한 파일의 링크가 반환됩니다.참고
이 파일은 1시간 동안만 다운로드 가능합니다.
인증 유형
Bearer API 인증메서드
GET https://ad-quality.soomla.com/api/rawdata/v1?필수 파라미터
이름 | 유형 | 설명 |
|---|---|---|
| date | 문자열 | YYYY-MM-DD(UTC 시간대) |
| appKey | 문자열 | 애플리케이션 키(플랫폼에서 확인 가능) |
요청 예시 URL
request 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"}
필드 정의
이 표는 Ad Quality 원시 데이터를 가져온 후 리포트에 표시되는 필드를 보여 줍니다. 각 필드별로 설명과 예시를 확인할 수 있습니다. 앞서 진행한 단계로 가져온 URL을 선택하여 리포트를 다운로드합니다.필드 | 설명 | 예제 |
|---|---|---|
| Bigint | |
| 문자열 | |
| 문자열 | |
| 광고를 제공하는 네트워크 이름 | |
| 다음과 같은 항목이 있을 때의 dsp 이름 | |
| 네트워크 인스턴스 이름 | |
| ISO 3166-1 Alpha-2 기준, 2자리 국가 코드 | |
| 노출이 발생한 상태 코드 | |
| 문자열 | |
| 문자열 | |
| 문자열 | |
| 문자열 | |
| 광고주 이름 | |
| 문자열 | |
| 게임에 표시된 광고주 유형을 나타내는 필드로, iOS 스토어 ID, Android 패키지 이름, 브랜드 등 다양한 정보 포함 | |
| 1은 클릭이 발생했음을, 0은 클릭이 없었음을 나타내는 정수 | |
| 문자열, 이와 관련된 UX 패턴: Ad Quality 용어집 (qClick, 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 | |
| 문자열, 노출이 발생한 광고주의 개발자 | |
| 문자열 | |