Package 

Class CommonUtils

    • Method Summary

      Modifier and Type Method Description
      static void getAdId(Context context) Google Advertising ID (GAID)를 비동기적으로 가져와 SharedPreferences에 저장합니다.GAID를 가져올 수 없거나 광고 추적이 제한된 경우, UUID를 생성하여 대신 저장합니다.이 작업은 네트워크 요청을 포함할 수 있으므로 AsyncTask를 사용하여 백그라운드 스레드에서 실행됩니다.
      static void setUserAgent(Context context) WebView의 사용자 에이전트(User-Agent) 문자열을 가져와 SharedPreferences에 저장합니다.사용자 에이전트는 광고 요청 시 서버에서 클라이언트 환경을 식별하는 데 사용될 수 있습니다.
      static String getAppVersion(Context _context) 애플리케이션의 버전 이름(versionName)을 가져옵니다.예: "1.0.
      static String getAdid(Context _context) SharedPreferences에 저장된 광고 ID (ADID 또는 대체 UUID)를 가져옵니다.
      static String getParameter(String url, String _param) 주어진 URL 문자열에서 특정 쿼리 파라미터의 값을 추출합니다.예: "http://example.com?id=123&name=test" 에서 "id" 파라미터를 추출하면 "123"을 반환합니다.
      static String getHtml(String _url) 주어진 URL로부터 HTML 컨텐츠를 동기적으로 가져옵니다.이 메소드는 네트워크 요청을 수행하므로, 메인 스레드에서 직접 호출하면 ANR(Application Not Responding)을유발할 수 있습니다.
      static String getTelecom(Context _context) 디바이스의 현재 통신사(네트워크 사업자) 이름을 가져옵니다.예: "SKTelecom", "KT", "LGU+"READ_PHONE_STATE 권한이 필요할 수 있습니다 (API 레벨에 따라 다름).
      static String getCommaNumeric(String str) 숫자 문자열을 3자리마다 콤마(,)를 추가하고 "원" 단위를 붙여 포맷팅합니다.예: "10000" -> "10,000원"입력 문자열이 숫자로 변환될 수 없는 경우 원본 문자열을 그대로 반환합니다.
      static String getManPlusParam(Context context) ManPlus 광고 네트워크 요청에 필요한 추가 파라미터 문자열을 생성합니다.이 파라미터에는 광고 ID, OS 정보, 앱 정보 등이 포함됩니다.
      static String getApplicationName(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 void sendAdSDKImpression(Context mContext, String mScriptNo, String target, String unitId)
      static void sendImpressTrackersEvent(Context context, AdDataModel adDataModel) 광고 노출(Impression) 트래킹 URL들을 전송합니다.광고가 사용자에게 보여졌을 때 호출되며, AdDataModel에 포함된 모든 노출 트래커 URL로 HTTP GET 요청을 보냅니다.
      static void sendImpressTrackersEvent(Context context, ArrayList<String> impTrackers)
      static void sendImpressTrackersTest(Context context)
      static void sendClickTrackersEvent(Context context, AdDataModel adDataModel) 광고 클릭(Click) 트래킹 URL들을 전송합니다.사용자가 광고를 클릭했을 때 호출되며, AdDataModel에 포함된 모든 클릭 트래커 URL로 HTTP GET 요청을 보냅니다.
      static void sendClickTrackersEvent(Context context, ArrayList<String> clickTrackers)
      static void sendInterstitialData(Context context, String sessionId, String type, String zone, boolean isFull, String styleCode, String advrtsPrdtCode)
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 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 - 애플리케이션 컨텍스트.
      • sendImpressTrackersEvent

         static void sendImpressTrackersEvent(Context context, AdDataModel adDataModel)

        광고 노출(Impression) 트래킹 URL들을 전송합니다.광고가 사용자에게 보여졌을 때 호출되며, AdDataModel에 포함된 모든 노출 트래커 URL로 HTTP GET 요청을 보냅니다.

        Parameters:
        context - 애플리케이션 컨텍스트.
        adDataModel - 노출 트래커 URL 목록을 포함하는 광고 데이터 모델.
      • sendClickTrackersEvent

         static void sendClickTrackersEvent(Context context, AdDataModel adDataModel)

        광고 클릭(Click) 트래킹 URL들을 전송합니다.사용자가 광고를 클릭했을 때 호출되며, AdDataModel에 포함된 모든 클릭 트래커 URL로 HTTP GET 요청을 보냅니다.

        Parameters:
        context - 애플리케이션 컨텍스트.
        adDataModel - 클릭 트래커 URL 목록을 포함하는 광고 데이터 모델.