앱 (앱 구성) FAQ

앱 구성 페이지(설정 > 앱, SETTINGS > Apps)는 마케팅 중인 모든 앱의 최신 목록을 보관할 수 있는 곳입니다. Singular는 앱별로 세분화된 분석 보고서를 제공하기 위해 이 목록이 반드시 필요합니다.

FAQ

문제 해결

여러 플랫폼에 동일한 앱 사이트를 사용하면 어떻게 되나요?

하나의 앱에 대해 여러 플랫폼에 동일한 앱 사이트를 사용하는 경우 보고서에서 앱 이름이 동일하고 설정도 동일합니다. 각 앱 사이트에 대해 다른 번들 ID를 사용하는 것이 좋습니다.

그러나 여러 플랫폼에 대해 동일한 앱 사이트가 있는 경우 각 플랫폼마다 다른 트래킹 링크를 사용하는 경우 캠페인 URL을 사용하여 보고서에서 앱 사이트를 구분할 수 있습니다. 사용자 수준 데이터에서는 앱 버전 값을 사용하여 앱을 구분할 수 있습니다.

모바일 앱이 아닌 웹 자산/랜딩 페이지를 마케팅하는 경우 어떻게 해야 하나요?

웹사이트, 온라인 스토어, 랜딩 페이지 등을 마케팅하는 경우에도 앱 페이지에서 추가해야 합니다:

  1. 앱 페이지에서 Add New App을 클릭합니다 .
  2. 플랫폼의 경우 "웹"을 선택합니다.
  3. 페이지의 URL 또는 웹사이트의 기본 도메인을 입력합니다.

image2.gif

기본 사항

앱 구성 페이지란 무엇인가요?

앱 구성 페이지에서는 마케팅 중인 모든 앱의 최신 목록을 보관할 수 있습니다. 앱별로 세분화된 정확한 분석 보고서를 제공하려면 이 목록이 필요합니다.

앱 이름이 중요한 이유는 무엇인가요?

싱귤러는 앱 이름을 사용하여 광고 네트워크의 통계를 올바른 앱에 매핑하므로 앱별로 세분화된 통계를 제공할 수 있습니다.

싱귤러의 앱 이름이 애드 네트워크 데이터에 표시된 앱 이름과 일치하지 않는 경우, 데이터를 올바른 앱에 매핑하는 다른 방법이 있지만 이 문제를 피하는 것이 가장 좋습니다.

자세한 내용은 매핑되지 않은 데이터 FAQ를 참조하세요.

앱 사이트란 무엇이며 앱과 어떻게 다른가요?

싱귤러 용어로 앱은 "Google" 또는 "Instagram"과 같이 최종 사용자가 알고 있는 앱 제목입니다.

앱 사이트는 iOS 또는 Android와 같이 특정 플랫폼에 특화된 앱의 버전입니다. 앱 사이트는 플랫폼의 앱 스토어에 URL이 있기 때문에 앱 사이트라고 불립니다.

앱에는 앱을 사용할 수 있는 각 플랫폼에 대해 하나씩 여러 개의 앱 사이트가 포함되는 경우가 많습니다. 예를 들어, 여기에는 두 개의 앱 사이트로 정의된 하나의 앱이 있습니다:

image1.png

스토어 URL이란 무엇인가요?

스토어 URL은 사용자가 Apple 앱 스토어 또는 Google Play와 같은 특정 앱 스토어에서 앱을 다운로드하기 위해 이동하는 곳입니다. 예를 들어

https://itunes.apple.com/il/app/exampleapp/idXXXXXXXX
번들 식별자(Bundle Identifier)란 무엇인가요?

번들 식별자는 앱 개발자가 사용하는 내부 식별자입니다(예: "com.myapp"). 앱이 특정 플랫폼의 앱 스토어에 아직 출시되지 않은 경우에도 앱 사이트를 추가하고 당분간 앱의 내부 번들 식별자로 정의할 수 있습니다.

테스트 앱과 라이브 앱이란 무엇인가요?

참고: 이 프리미엄 기능은 Enterprise 고객만 사용할 수 있습니다.

Enterprise 고객의 경우 앱 페이지는 라이브 앱과 테스트 앱의 두 탭으로 나뉩니다. 앱 또는 앱 사이트를 추가할 때 먼저 추가할 탭을 선택할 수 있습니다.

탭을 사용하여 어떤 앱이 출시되어 마케팅 중이고 어떤 앱이 아직 출시되지 않았는지 추적할 수 있습니다.

테스트 앱은 Singular 플랫폼의 어느 곳에서도 드롭다운 목록이나 필터에 포함되지 않습니다. 또한 이러한 앱의 파트너 구성 설정은 편집할 수 없으며 파트너 구성(Partner Configuration) 페이지에 "사용할 수 없음"으로 표시됩니다.

앱 사이트 옆의 빨간색/녹색 점은 무엇을 의미하나요?

녹색 앱 사이트는 플랫폼의 앱 스토어에 라이브 상태입니다.

빨간색 앱 사이트는 아직 라이브 상태가 아닙니다.

앱 새로 고침 버튼은 어떤 기능을 하나요?

참고: 이 섹션은 싱귤러 어트리뷰션 서비스 고객에게만 적용됩니다.

이 버튼을 클릭하면 싱귤러가 새 앱에 대한 최근 SDK 이벤트를 확인하여 앱 페이지의 목록에 추가합니다.

팁: 싱귤러 어트리뷰션 서비스 고객인 경우, 싱귤러는 2시간마다 새로운 앱에 대한 SDK 이벤트를 확인하여 앱 목록을 새로 고칩니다. 따라서 앱 페이지를 열 때마다 표시되는 앱 목록은 대부분 최신 상태입니다. 하지만 지난 2시간 이내에 활성화된 앱이 목록에 포함되었는지 확인하려면 앱 새로 고침을 클릭하여 지금 바로 추가 확인을 수행하세요.

앱 추가하기

앱은 어떻게 목록에 추가하나요?

새 앱은 두 가지 방법으로 목록에 추가됩니다:

  1. 자동: 트래커(Singular 트래커 또는 타사 MMP)에 적어도 하나의 설치 또는 이벤트를 포함하여 이 앱에 대한 데이터가 있는 경우. 앱이 앱 스토어에 있는지 확인하고, 있다면 페이지에 추가합니다.
  2. 수동: 새 앱 추가또는 사이트 추가를 클릭하고 앱 세부 정보를 입력합니다.
수동으로 앱을 목록에 추가하려면 어떻게 해야 하나요?

수동으로 앱을 추가하려면다음과 같이 하세요:

  1. Singular 플랫폼에서 설정 > 앱 구성(App Configuration)으로 이동합니다.
  2. 새 앱 추가(Add New App)을 클릭합니다.

    new_app.gif

  3. 표시되는 양식에 앱 이름을 입력한 다음 특정 앱 사이트의 세부 정보를 입력할 수 있는 공간이 있습니다.

    먼저 앱 이름을 입력합니다. 네트워크 보고서에 표시된 대로 정확하게 이름을 입력하세요. 대문자와 소문자, 공백, 전체 단어와 약어 등에 주의하세요. 네트워크 보고서에서 앱 이름이 약간 달라서 Singular가 이를 인식하지 못하면 분석 보고서에 '매핑되지 않은 데이터'가 표시될 수 있습니다.

    Screen_Shot_2021-07-12_at_15.29.53.png

  4. 이제 첫 번째 앱 사이트의 세부 정보를 입력합니다. OS의 경우, 옵션 중 하나를 선택합니다.

    Screen_Shot_2021-07-12_at_15.04.49.png

  5. 스토어 URL또는 번들 ID로앱 사이트를 식별합니다:

    • 앱이 앱 스토어에 라이브 상태인 경우 스토어 URL을 선택하고 앱 스토어에 있는 앱의 URL을 붙여넣습니다.

      Screen_Shot_2021-07-12_at_15.22.07.png

    • 앱이 아직 라이브 상태가 아닌 경우 번들 ID를 선택하고 앱의 내부 번들 식별자(예: com.appname)를 입력합니다.

      Screen_Shot_2021-07-12_at_15.22.40.png

      팁: Apple 앱 스토어에 검토를 위해 앱을 제출했다면 아직 출시되지 않았더라도 스토어 URL이 이미 있는 것입니다. 사이트 퍼블릭 ID 입력란에 스토어 URL을 추가하는 것이 좋습니다. 이렇게 하면 앱이 출시되면 Singular에서 해당 URL을 사용할 수 있습니다.

      Screen_Shot_2021-07-12_at_15.20.43.png

  6. 저장을 클릭합니다.
  7. 앱이 여러 플랫폼과 앱 스토어에 표시되는 경우 사이트 추가를 선택합니다. 각 스토어에 대해 다른 앱 사이트를 추가합니다.

Android 앱과 iOS 앱을 동일한 앱 아래에 '앱 사이트'로 추가해야 하는 이유는 무엇인가요?

image1.png

서로 다른 플랫폼에 대해 동일한 앱의 모든 버전을 함께 유지하면, 싱귤러가 애드 네트워크 데이터를 이해하고 앱, 플랫폼 또는 앱과 플랫폼 모두별로 세분화할 수 있는 보고서를 제공하는 데 도움이 됩니다.

또한 앱 페이지에서는 동일한 이름을 가진 두 개의 개별 앱을 추가할 수 없습니다. 따라서 각 버전을 별도의 앱으로 추가하려는 경우 다른 이름을 지정해야 하며, 이로 인해 보고서에서 데이터 누락 및 기타 문제가 발생할 수 있습니다(Singular가 앱의 데이터를 올바른 앱에 매핑하지 못할 수 있기 때문). 자세한 내용은 매핑되지 않은 데이터 FAQ를 참조하세요.

앱 스토어에 아직 출시되지 않은 앱을 추가하려면 어떻게 해야 하나요?

'번들 ID'로 앱을 식별하여 추가할 수 있습니다.

앱 스토어에 출시되기 전에 앱을 추가하려면 다음과 같이 하세요:

  1. 앱 페이지에서 새 앱 추가를 클릭하고 앱 이름을 입력합니다(참고: 앱 페이지에서 이미 다른 버전의 앱을 만든 경우 새 앱을 완전히 새로운 앱이 아닌 새 앱 사이트로 추가합니다).
  2. 적절한 플랫폼을 선택합니다.
  3. 다음을 사용하여 앱 추가에서 번들 ID를 선택하고 앱의 번들 ID를 입력합니다. 앱 개발자가 사용하는 내부 식별자입니다.

    Screen_Shot_2021-07-12_at_15.22.40.png

  4. iOS 앱의 경우: 이미 앱 스토어에 앱을 제출했다면 앱의 스토어 URL을 받았을 것입니다(앱이 아직 해당 URL에 게시되지 않았더라도). 사이트 퍼브릭 ID 아래에 입력합니다. 이렇게 하면 Singular가 앱에 데이터를 올바르게 매핑하는 데 도움이 됩니다.

    Screen_Shot_2021-07-12_at_15.20.43.png

앱 스토어에 출시되기 전에 앱을 추가했는데 출시 후 업데이트하려면 어떻게 해야 하나요?

그럴 필요가 없습니다. 싱귤러가 앱 상태를 자동으로 업데이트합니다(iOS 및 Android 앱의 경우). 하루에 두 번씩 앱을 검토하고 번들 ID를 사용하여 Apple App Store 또는 Google Play에 앱이 출시되었는지 확인합니다.

테스트 앱을 라이브 앱으로 전환하거나 그 반대로 전환하려면 어떻게 해야 하나요?

앱 사이트가 라이브 앱에서 자동으로 생성되었지만 싱글의 드롭다운 목록 및 보고서 필터에 표시되지 않도록 하려면 테스트 앱으로 이동할 수 있습니다.

테스트 앱에서 앱 사이트를 설정한 경우 준비가 되면 라이브 앱으로 이동할 수 있습니다.

탭 간에 앱 사이트를 이동하려면 오른쪽 상단의 메뉴 아이콘을 클릭하고 테스트 앱 으로 이동 또는 라이브 앱으로 이동을 클릭합니다.

move_to_test.gif

싱글로 어트리뷰션 추적을 위한 앱 구성하기

참고: 이 섹션은 싱귤러의 어트리뷰션 서비스 고객에게만 적용됩니다.

싱귤러로 캠페인을 실행하기 전에 앱에 어떤 설정을 구성해야 하나요?

싱귤러 SDK를 앱에 연동한 후(싱귤러 어트리뷰션 시작 방법 지침에 따라), 앱 구성 페이지에서 앱에 몇 가지 새로운 설정을 사용할 수 있습니다.

새 설정을 확인하려면 SDK가 이벤트를 Singular로 전송하고 있는지 확인한 다음 앱으로 이동하여 고급 설정 토글을 클릭합니다.

설정은 다음과 같습니다:

  • 대상 URL
  • 추적 제거
  • 딥링크 URL
  • iOS 유니버설 앱 링크
대상 URL(Destination URL)이란 무엇이며 어떻게 구성하나요?

앱의 스토어 URL 외에 추적 링크에 대한 대체 목적지를 하나 이상 설정할 수 있습니다. 이렇게 하면 앱에 대한 추적 링크를 생성할 때 이러한 대상을 타겟으로 선택할 수 있습니다.

이 기능은 예를 들어 사용자 지정 랜딩 페이지가 있거나 앱 스토어 A/B 테스트 솔루션을 사용하는 경우에 유용합니다.

새 대상 URL을 생성하려면 다음과 같이 하세요:

  1. 앱을 선택한 다음 구성하려는 앱 사이트를 선택합니다.
  2. 대상 URL옆의 + 기호를 클릭하고 새 대상 URL을 입력합니다.
  3. 저장을 클릭합니다.
언인스톨 트래킹(Uninstall Tracking)은 어떻게 구성하나요?

앱 언인스톨을 트래킹하도록 Singular SDK를 설정한 경우, App Uninstall Tracking 아래의 앱 페이지에 입력해야 하는 특수 자격 증명을 획득한 것입니다.

이 자격 증명을 통해 Singular는 앱 제거를 추적할 수 있습니다.

자세한 내용은 iOS 앱 제거 추적 시작하기 및 안드로이드 앱 언인스톨 트래킹 시작하기를 참조하세요.

'인액티비티 윈도우(Inactivity Window)'란 무엇인가요?

인액티비티 기간이란 사용자가 비활성 상태여야 리인게이지먼트 어트리뷰션에 참여할 수 있는 자격이 박탈되는 기간을 결정하는 설정입니다. 자세한 내용은 리인게이트먼트란 무엇인가요? 및 새 세션이 리인게이지먼트로 간주되기 전에 사용자가 얼마나 오래 인액티브 상태여야 하나요?

'최소 세션 간격(Minimum Session Interval)'이란 무엇인가요?

최소 세션 간격은 앱이 수신한 세션을 처리하기 위한 세션 사이의 최소 시간입니다. 5분~24시간의 값이 지원되며 기본값은 12시간입니다. 이 메커니즘은 Singular에서 처리되는 반복 세션의 수를 제한합니다. 예를 들어 앱의 '최소 세션 간격'이 1시간인 경우 동작은 다음과 같습니다:

또한 다음과 같이 핵심 기능을 트리거하는 세션은 이 기능에서 제외됩니다:

  • 딥링크 세션, 디퍼드 딥링크 및 짧은 링크 해상도
  • 설치 세션
  • 구성된 비활성 창에서 재참여할 수 있는 세션
  • 사용자 지정 사용자 ID 또는 글로벌 속성 업데이트
  • SDK 테스트 콘솔
  • SKAdNetwork 전환 모델 업데이트

'최소 세션 간격'은 싱귤러 리텐션 보고에 영향을 미치지 않습니다. 단일 리텐션은 24시간을 기준으로 계산되므로( 리텐션 FAQ 참조), 매 24시간 동안 적어도 하나의 세션이 처리되는 한 사용자의 리텐션이 기록됩니다.

2023년 5월 8일부터 적용됩니다:

  • 기존의 모든 통합 앱은 동작에 변화가 없으며 최소 세션 간격이 0(꺼짐)입니다.
  • 새로 추가되고 통합된 모든 앱의 기본 최소 세션 간격은 12시간입니다. 간격 값은 앱 설정 페이지에서 각 앱에 대해 수정할 수 있습니다.

매핑 키 사용

참고: 이 베타 기능은 아직 모든 고객에게 제공되지 않습니다. 사용해 보고 싶다면 고객 성공 매니저에게 문의하세요.

매핑 키란 무엇인가요?

매핑 키는 일반적으로 앱 이름보다 짧고 간단한 고유 코드로, 앱 구성 페이지에서 앱 사이트에 대해 정의할 수 있으며 광고 네트워크의 캠페인 이름에도 삽입할 수 있습니다. 이렇게 하면 싱귤러가 광고 네트워크 보고서에서 캠페인 데이터를 읽을 때 캠페인을 올바른 앱과 연결하고 캠페인 데이터가 처리되어 보고서에 포함되도록 할 수 있습니다.

싱귤러가 각 캠페인을 앱에 매핑하는 것이 중요한 이유는 무엇인가요?

광고 네트워크에서 데이터를 가져올 때, 각 광고 캠페인이 속한 앱 및 앱의 플랫폼 (안드로이드, iOS 등)과 연결하여 각 앱에 대한 정확한 마케팅 지표를 제공하려면, 각 광고 캠페인을 앱과 연결해야 합니다.

앱과 플랫폼을 알지 못하면 Singular는 캠페인 데이터를 처리할 수 없으며, 해당 캠페인은 보고서에 표시되지 않습니다.

경우에 따라 네트워크에서 앱 사이트 퍼블릭 ID 또는 앱 이름 + 플랫폼을 네트워크 보고서의 필드로 제공하면 문제가 해결됩니다.

그 외의 많은 경우, 싱귤러는 계정의 앱 목록을 검토하고 캠페인 이름에서 앱 이름과 플랫폼을 찾아내어 캠페인 이름에서 앱과 플랫폼을 유추할 수 있습니다. 따라서 광고 네트워크 보고서의 캠페인 이름에 표시되는 앱 이름과 싱귤러의 앱 이름이 일치하는 것이 중요합니다.

mapping_key1.png

매핑 키는 언제 사용해야 하나요?

원칙적으로, 싱귤러의 앱 이름이 광고 네트워크에 정의되어 캠페인 이름에 표시되는 앱 이름과 일치하는지 확인하는 것이 좋습니다. 이는 캠페인이 싱귤러에서 앱에 올바르게 매핑되는지 확인하는 가장 쉬운 방법입니다. 이름이 일치하지 않는 경우, 일반적으로 싱귤러에서 앱 이름을 편집하거나 광고 네트워크와 협력하여 네트워크 측에서 캠페인 이름을 변경해야 합니다.

그러나 모든 플랫폼에서 이름을 일치시키기 어려운 경우도 있습니다. 예를 들어,

  • 캠페인 이름은 영어로 되어 있지만 싱글 앱의 이름은 중국어 또는 한국어와 같은 다른 알파벳으로 되어 있는 경우.
  • 앱의 이름이 애플 앱스토어와 구글 플레이스토어에서 약간 다르며, 그에 따라 캠페인 이름도 다릅니다.

이러한 경우 매핑 키를 사용하여 캠페인이 매핑되었는지 확인할 수 있습니다.

매핑 키를 추가하려면 어떻게 해야 하나요?

매핑 키를 추가하려면 다음과 같이 하세요:

  1. 앱 구성 페이지에서 매핑되지 않은 캠페인이 있는 앱을 찾습니다.
  2. 해당 앱 사이트를 열어 편집합니다.
  3. 매핑 키 필드에 문자열을 입력합니다.
  4. 광고 네트워크와 협력하여 매핑되지 않은 캠페인의 이름에 동일한 문자열을 추가합니다. 매핑 키를 공백, 밑줄, 구두점 등의 표준 구분 기호로 캠페인 이름의 나머지 부분과 구분해야 합니다.

mapping_key2.png

예를 들어 "장난감 곰"이라는 앱이 있고 이 앱의 캠페인 이름이 "Teddy Bear iOS FR DE SP"라고 가정해 보겠습니다. Singular가 캠페인을 앱에 매핑할 수 있도록 하려면 다음과 같이 하세요:

  1. 싱귤러에서 앱 사이트를 편집하고 매핑 키(예: "TB111")를 추가합니다.
  2. 애드 네트워크와 협력하여 캠페인의 이름을 "테디베어 iOS FR DE SP TB111"로 변경합니다.

이제 싱귤러가 해당 캠페인을 앱 사이트와 연관된 캠페인으로 인식합니다.

매핑 키 문자열은 어떻게 선택해야 하나요? 키 길이에 제한이 있나요?

제한이 있습니다:

  • 키는 4자 이상이어야 합니다.
  • 키는 앱 사이트에만 고유해야 합니다(다른 앱 사이트에 동일한 키를 부여하지 마세요).
  • 캠페인 이름에서 공백, 밑줄, 구두점 등의 표준 구분 기호를 사용하여 키를 나머지 이름과 구분합니다.
  • 키워드에는 _, ?, !, %, &, $, |, /, +, -, [, ], (, ) 및 "*", "_", ". ", " ," 등의 잠재적 구분자를 포함하거나 식별되지 않는 키워드를 사용할 수 없습니다. 예를 들어, "MT_Android" 라는 키워드는 "MT_Android_1"이라는 캠페인을 식별하지 못합니다.

추가 권장사항:

  • 나중에 실수를 방지하려면 다른 앱의 이름과 일치하는 키를 사용하지 마세요. 예를 들어, "Jewel Rush" 및 "Jewel Rush 2" 앱이 있는 경우 "jewelrush" 키를 사용하지 마세요.
  • 영문자와 숫자만 사용하는 것이 좋습니다.