Ad Quality 원시 데이터 API

Ad Quality 원시 데이터 API를 통해 Android 앱에서 매출, 클릭률, 광고 소스, 광고 소재 ID, UX 패턴 등 노출 수준의 광고 품질 지표를 추출하여 BI 플랫폼 분석에 활용할 수 있습니다.

읽는 시간 1분

최근 업데이트: 3달 전

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을 선택하여 리포트를 다운로드합니다.

필드	설명	예제
`event_timestamp`	Bigint	`1657500000000`
`user_id`	문자열	`1834b456-b9ea-4811-a121-9afc165c1eb0`
`ad_unit`	문자열	`Interstitial`
`ad_source`	광고를 제공하는 네트워크 이름	`Google AdMob`
`dsp`	다음과 같은 항목이 있을 때의 dsp 이름	`TheTradeDesk`
`instance_name`	네트워크 인스턴스 이름	`DefaultRewarded`
`country`	ISO 3166-1 Alpha-2 기준, 2자리 국가 코드	`US`
`us_state`	노출이 발생한 상태 코드	`OR`
`device_model`	문자열	`SM-A127M`
`os_version`	문자열	`18.3.1`
`sdk_version`	문자열	`5.17.0`
`app_version`	문자열	`2.8.9`
`advertiser`	광고주 이름	`Project Makeover`
`advertiser_id`	문자열	`com.bgg.jump`
`advertiser_type`	게임에 표시된 광고주 유형을 나타내는 필드로, iOS 스토어 ID, Android 패키지 이름, 브랜드 등 다양한 정보 포함	`package_name`
`click`	1은 클릭이 발생했음을, 0은 클릭이 없었음을 나타내는 정수	`1`
`click_type`	문자열, 이와 관련된 UX 패턴: Ad Quality 용어집 (qClick, proximity_click, auto_click, early_click, hasty_click, 기타)	`auto_click,proximity_click`
`click_ts`	Bigint, 클라이언트 타임스탬프(UTC 기준)	`1657450000000`
`video_completed`	동영상 광고 소재 유형과 관련되어 있으며, 1은 동영상이 완전히 재생된 경우, 0은 완료되지 않은 경우를 나타내는 정수	`1`
`video_completed_ts`	Bigint	`1657450000000`
`revenue`	사용자가 생성한 매출(USD).	`0.5`
`category`	앱 스토어 또는 Google Play 내 광고주의 앱 카테고리	`Casual`
`content_rating`	미국 Apple/Google 앱 스토어 평점	`{"US":"Everyone"}`
creative_type	주요 광고 소재 유형: 플레이어블/동영상/이미지	`playable`
`creative_id`	문자열, Ad Quality 광고 소재 ID	`6c3d78bfe7c74d805c01b13b44e6e1ecff16544c`
`appstore_url` (현재 필드 이름: `url` )	문자열	`https://www.ubereats.com/?utm_campaign=CM2176745-display-doubleclick_42_-99_CR-National_e_all_bra_cpm_es_Eater%7CCR%7CEatsDemandIIYTBumper-L2R0ED22-PO481364&utm_medium=display-programmatic&utm_source=dbm`
`video_urls`	문자열 배열	`https://www.youtube.com/watch?v=rdahaLbmxOw`
end_card_urls	문자열 배열	`https://v.ssacdn.com/demand-creatives/assets/videos/m29ateosecjmkxt2xamf.mp4`
`icon_urls`	문자열	`https://lh3.googleusercontent.com/y3iFaRQsuLPIiWnCX_Yg7j2IGWiKtnFFbsQPBwRWxIFszsV_xnZYE5VT7d1udxRqQSCPxn_cyw=w256-h256`
`image_urls`	문자열 배열	`https://i.ytimg.com/vi/Pv8H5ceSeF0/hqdefault.jpg`
`imp_num`	사용자의 배열 내 노출 번호. 배너 및 네이티브의 경우 값: `-1`	`3`
`ad_closed`	`1` 은 광고가 종료된 이벤트가 수신된 경우를, `0` 은 광고가 종료되지 않았음을 의미하는 정수	`0`
`ad_closed_ts`	Bigint	`1657450000000`
`developer`	문자열, 노출이 발생한 광고주의 개발자	`Supersonic`
`ad_source_sdk_version`	문자열	`5.17.0`

기술 자료

Development

User Acquisition

Monetization

산업 분야