-
public class CommonUtils
-
-
Method Summary
Modifier and Type Method Description static voidgetAdId(Context context)Google Advertising ID (GAID)를 비동기적으로 가져와 SharedPreferences에 저장합니다.GAID를 가져올 수 없거나 광고 추적이 제한된 경우, UUID를 생성하여 대신 저장합니다.이 작업은 네트워크 요청을 포함할 수 있으므로 AsyncTask를 사용하여 백그라운드 스레드에서 실행됩니다. static voidsetUserAgent(Context context)WebView의 사용자 에이전트(User-Agent) 문자열을 가져와 SharedPreferences에 저장합니다.사용자 에이전트는 광고 요청 시 서버에서 클라이언트 환경을 식별하는 데 사용될 수 있습니다. static StringgetAppVersion(Context _context)애플리케이션의 버전 이름(versionName)을 가져옵니다.예: "1.0. static StringgetAdid(Context _context)SharedPreferences에 저장된 광고 ID (ADID 또는 대체 UUID)를 가져옵니다. static StringgetParameter(String url, String _param)주어진 URL 문자열에서 특정 쿼리 파라미터의 값을 추출합니다.예: "http://example.com?id=123&name=test" 에서 "id" 파라미터를 추출하면 "123"을 반환합니다. static StringgetHtml(String _url)주어진 URL로부터 HTML 컨텐츠를 동기적으로 가져옵니다.이 메소드는 네트워크 요청을 수행하므로, 메인 스레드에서 직접 호출하면 ANR(Application Not Responding)을유발할 수 있습니다. static StringgetTelecom(Context _context)디바이스의 현재 통신사(네트워크 사업자) 이름을 가져옵니다.예: "SKTelecom", "KT", "LGU+"READ_PHONE_STATE 권한이 필요할 수 있습니다 (API 레벨에 따라 다름). static StringgetCommaNumeric(String str)숫자 문자열을 3자리마다 콤마(,)를 추가하고 "원" 단위를 붙여 포맷팅합니다.예: "10000" -> "10,000원"입력 문자열이 숫자로 변환될 수 없는 경우 원본 문자열을 그대로 반환합니다. static StringgetManPlusParam(Context context)ManPlus 광고 네트워크 요청에 필요한 추가 파라미터 문자열을 생성합니다.이 파라미터에는 광고 ID, OS 정보, 앱 정보 등이 포함됩니다. static StringgetApplicationName(Context context)애플리케이션의 표시 이름(label)을 가져옵니다.AndroidManifest.xml의 application 태그에 정의된 android:label 값을 반환합니다. static Map<String, String>setAGHeaders(Context context)광고 요청 시 User-Agent Client Hints (UA-CH) 관련 HTTP 헤더를 생성합니다.UA-CH는 기존의 User-Agent 문자열을 대체하거나 보강하여 더 구조화되고 개인 정보 보호적인 방식으로클라이언트 정보를 서버에 제공하는 메커니즘입니다.생성되는 헤더에는 Chrome 버전, 플랫폼 정보, 아키텍처, 모델명 등이 포함될 수 있습니다. static voidsendAdSDKImpression(Context mContext, String mScriptNo, String target, String unitId)static voidsendImpressTrackersEvent(Context context, AdDataModel adDataModel)광고 노출(Impression) 트래킹 URL들을 전송합니다.광고가 사용자에게 보여졌을 때 호출되며, AdDataModel에 포함된 모든 노출 트래커 URL로 HTTP GET 요청을 보냅니다. static voidsendImpressTrackersEvent(Context context, ArrayList<String> impTrackers)static voidsendImpressTrackersTest(Context context)static voidsendClickTrackersEvent(Context context, AdDataModel adDataModel)광고 클릭(Click) 트래킹 URL들을 전송합니다.사용자가 광고를 클릭했을 때 호출되며, AdDataModel에 포함된 모든 클릭 트래커 URL로 HTTP GET 요청을 보냅니다. static voidsendClickTrackersEvent(Context context, ArrayList<String> clickTrackers)static voidsendInterstitialData(Context context, String sessionId, String type, String zone, boolean isFull, String styleCode, String advrtsPrdtCode)-
-
Method Detail
-
getAdId
static void getAdId(Context context)
Google Advertising ID (GAID)를 비동기적으로 가져와 SharedPreferences에 저장합니다.GAID를 가져올 수 없거나 광고 추적이 제한된 경우, UUID를 생성하여 대신 저장합니다.이 작업은 네트워크 요청을 포함할 수 있으므로 AsyncTask를 사용하여 백그라운드 스레드에서 실행됩니다.
- Parameters:
context- 애플리케이션 컨텍스트.
-
setUserAgent
static void setUserAgent(Context context)
WebView의 사용자 에이전트(User-Agent) 문자열을 가져와 SharedPreferences에 저장합니다.사용자 에이전트는 광고 요청 시 서버에서 클라이언트 환경을 식별하는 데 사용될 수 있습니다.
- Parameters:
context- 애플리케이션 컨텍스트.
-
getAppVersion
static String getAppVersion(Context _context)
애플리케이션의 버전 이름(versionName)을 가져옵니다.예: "1.0.0"
- Parameters:
_context- 애플리케이션 컨텍스트.
-
getAdid
static String getAdid(Context _context)
SharedPreferences에 저장된 광고 ID (ADID 또는 대체 UUID)를 가져옵니다.
- Parameters:
_context- 애플리케이션 컨텍스트.
-
getParameter
static String getParameter(String url, String _param)
주어진 URL 문자열에서 특정 쿼리 파라미터의 값을 추출합니다.예: "http://example.com?id=123&name=test" 에서 "id" 파라미터를 추출하면 "123"을 반환합니다.
- Parameters:
url- 파라미터를 추출할 전체 URL 문자열._param- 추출할 쿼리 파라미터의 이름.
-
getHtml
static String getHtml(String _url)
주어진 URL로부터 HTML 컨텐츠를 동기적으로 가져옵니다.이 메소드는 네트워크 요청을 수행하므로, 메인 스레드에서 직접 호출하면 ANR(Application Not Responding)을유발할 수 있습니다. 반드시 백그라운드 스레드에서 실행해야 합니다.
- Parameters:
_url- HTML 컨텐츠를 가져올 URL.
-
getTelecom
static String getTelecom(Context _context)
디바이스의 현재 통신사(네트워크 사업자) 이름을 가져옵니다.예: "SKTelecom", "KT", "LGU+"READ_PHONE_STATE 권한이 필요할 수 있습니다 (API 레벨에 따라 다름).
- Parameters:
_context- 애플리케이션 컨텍스트.
-
getCommaNumeric
static String getCommaNumeric(String str)
숫자 문자열을 3자리마다 콤마(,)를 추가하고 "원" 단위를 붙여 포맷팅합니다.예: "10000" -> "10,000원"입력 문자열이 숫자로 변환될 수 없는 경우 원본 문자열을 그대로 반환합니다.
- Parameters:
str- 포맷팅할 숫자 문자열.
-
getManPlusParam
static String getManPlusParam(Context context)
ManPlus 광고 네트워크 요청에 필요한 추가 파라미터 문자열을 생성합니다.이 파라미터에는 광고 ID, OS 정보, 앱 정보 등이 포함됩니다.
- Parameters:
context- 애플리케이션 컨텍스트.
-
getApplicationName
static String getApplicationName(Context context)
애플리케이션의 표시 이름(label)을 가져옵니다.AndroidManifest.xml의 application 태그에 정의된 android:label 값을 반환합니다.
- Parameters:
context- 애플리케이션 컨텍스트.
-
setAGHeaders
static Map<String, String> setAGHeaders(Context context)
광고 요청 시 User-Agent Client Hints (UA-CH) 관련 HTTP 헤더를 생성합니다.UA-CH는 기존의 User-Agent 문자열을 대체하거나 보강하여 더 구조화되고 개인 정보 보호적인 방식으로클라이언트 정보를 서버에 제공하는 메커니즘입니다.생성되는 헤더에는 Chrome 버전, 플랫폼 정보, 아키텍처, 모델명 등이 포함될 수 있습니다.
- Parameters:
context- 애플리케이션 컨텍스트.
-
sendAdSDKImpression
static void sendAdSDKImpression(Context mContext, String mScriptNo, String target, String unitId)
-
sendImpressTrackersEvent
static void sendImpressTrackersEvent(Context context, AdDataModel adDataModel)
광고 노출(Impression) 트래킹 URL들을 전송합니다.광고가 사용자에게 보여졌을 때 호출되며, AdDataModel에 포함된 모든 노출 트래커 URL로 HTTP GET 요청을 보냅니다.
- Parameters:
context- 애플리케이션 컨텍스트.adDataModel- 노출 트래커 URL 목록을 포함하는 광고 데이터 모델.
-
sendImpressTrackersEvent
static void sendImpressTrackersEvent(Context context, ArrayList<String> impTrackers)
-
sendImpressTrackersTest
static void sendImpressTrackersTest(Context context)
-
sendClickTrackersEvent
static void sendClickTrackersEvent(Context context, AdDataModel adDataModel)
광고 클릭(Click) 트래킹 URL들을 전송합니다.사용자가 광고를 클릭했을 때 호출되며, AdDataModel에 포함된 모든 클릭 트래커 URL로 HTTP GET 요청을 보냅니다.
- Parameters:
context- 애플리케이션 컨텍스트.adDataModel- 클릭 트래커 URL 목록을 포함하는 광고 데이터 모델.
-
sendClickTrackersEvent
static void sendClickTrackersEvent(Context context, ArrayList<String> clickTrackers)
-
-
-
-