경고: Google Play 인스턴트를 더 이상 사용할 수 없습니다. 2025년 12월부터는 Google Play를 통해 인스턴트 앱을 게시할 수 없으며 모든 Google Play 서비스 인스턴트 API가 더 이상 작동하지 않습니다. 사용자에게 더 이상 어떤 메커니즘을 통해서도 Play에서 인스턴트 앱이 제공되지 않습니다.
이 변경사항은 개발자 의견과 Google Play 인스턴트 도입 이후 생태계를 개선하기 위한 Google의 지속적인 투자를 기반으로 이루어집니다.
사용자 증가를 목표로 계속 최적화하려면 개발자가 딥 링크를 사용하여 사용자를 일반 앱 또는 게임으로 안내하는 것이 좋습니다. 이렇게 하면 관련이 있는 경우 사용자를 특정 여정이나 기능으로 리디렉션할 수 있습니다.
인스턴트 앱이건 설치된 앱이건 성공 여부를 추적하는 것은 모든 개발자에게 중요한 일입니다. Fabric Answers, Localytics, Mixpanel 등 몇 가지 분석 라이브러리는 Google Play 인스턴트와 호환됩니다.
현재 분석 솔루션이 나열되지 않거나 Google Play 인스턴트에서 작동하지 않는다면 Firebase용 Google 애널리틱스를 원격 분석 솔루션으로 사용하는 것을 고려해 보세요. 이 페이지에서는 인스턴트 앱 프로젝트에 Firebase용 Google 애널리틱스를 설정하는 방법을 설명합니다.
설치한 앱과 인스턴트 앱은 패키지 이름을 공유하기 때문에 각 앱에서 수집한 이벤트와 데이터를 구별할 수 있어야 합니다. 애널리틱스에서 인스턴트 앱과 설치된 앱을 구별하려면 인스턴트 앱의 값이 'instant'이고 설치된 앱의 값이 'installed'인 app_type 사용자 속성을 설정해야 합니다.
valSTATUS_INSTALLED="installed"valSTATUS_INSTANT="instant"valANALYTICS_USER_PROP="app_type"privatelateinitvarfirebaseAnalytics:FirebaseAnalyticsprotectedfunonCreate(savedInstanceState:Bundle?){...firebaseAnalytics=FirebaseAnalytics.getInstance(this)// Determine the current app context, either installed or instant, then// set the corresponding user property for Google Analytics.if(InstantApps.getPackageManagerCompat(this).isInstantApp()){firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP,STATUS_INSTANT)}else{firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP,STATUS_INSTALLED)}}
자바
finalStringSTATUS_INSTALLED="installed";finalStringSTATUS_INSTANT="instant";finalStringANALYTICS_USER_PROP="app_type";privateFirebaseAnalyticsfirebaseAnalytics;@OverrideprotectedvoidonCreate(BundlesavedInstanceState){...firebaseAnalytics=FirebaseAnalytics.getInstance(this);// Determine the current app context, either installed or instant, then// set the corresponding user property for Google Analytics.if(InstantApps.getPackageManagerCompat(this).isInstantApp()){firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP,STATUS_INSTANT);}else{firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP,STATUS_INSTALLED);}}
app_type 사용자 속성을 설정하면 애널리틱스 콘솔의 이벤트 탭에서 이벤트를 선택한 후 app_type 값을 기준으로 이벤트를 필터링할 수 있습니다. 이로써 얻은 데이터 추정을 통해 인스턴트 앱 또는 설치된 앱에 지정된 이벤트의 수를 알 수 있습니다.
Firebase용 Google 애널리틱스에서 이벤트를 기록하고 보는 방법에 관한 자세한 내용은 이벤트 기록을 참고하세요.
애널리틱스 이벤트 해석
애널리틱스를 사용하면 인스턴트 앱에 매우 유용한 다양한 측정항목을 추적할 수 있습니다. 다음 표에서는 애널리틱스의 상응하는 이벤트의 이름이나 속성을 비롯하여 인스턴트 앱과 관련된 측정항목을 설명합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Add Google Analytics for Firebase to your instant app\n\n**Warning:** Google Play Instant will no longer be available. Starting December 2025,\nInstant Apps cannot be published through Google Play, and all\n[Google Play services Instant APIs](https://developers.google.com/android/reference/com/google/android/gms/instantapps/package-summary)\nwill no longer work. Users will no longer be served Instant Apps by Play using any\nmechanism.\n\nWe're making this change based on developer feedback and our continuous investments\nto improve the ecosystem since the introduction of Google Play Instant.\n\nTo continue optimizing for user growth, we encourage developers to refer users to\ntheir regular app or game, using [deeplinks](https://support.google.com/googleplay/android-developer/answer/12463044)\nto redirect them to specific journeys or features when relevant.\n\nTracking the success of an app, instant or installed, is important to each\ndeveloper. Several analytics libraries are compatible with\nGoogle Play Instant, including\n[Fabric Answers](https://fabric.io/kits/android/answers),\n[Localytics](https://docs.localytics.com/dev/android.html#android),\nand [Mixpanel](https://mixpanel.com/help/reference/android).\n\nIf your current analytics solution isn't listed or if you find that it doesn't\nwork with Google Play Instant, consider using Google Analytics for Firebase as\nyour telemetry solution. This page describes how to set up Google Analytics for Firebase\nin an instant app project.\n\nAdding Google Analytics for Firebase to an instant app project\n--------------------------------------------------------------\n\n1. Add the Firebase SDK to your app by following the instructions described in the [Getting started guide for Google Analytics for Firebase](https://firebase.google.com/docs/analytics/android/start/).\n2. Use the latest version of the google-services plugin.\n3. Place the `google-services.json` file in each module.\n4. Add the following line to each module's `build.gradle` file:\n\n \u003cbr /\u003e\n\n ### Groovy\n\n ```groovy\n // android { ... }\n // dependencies { ... }\n plugins {\n id 'com.google.gms.google-services'\n }\n ```\n\n ### Kotlin\n\n ```kotlin\n // android { ... }\n // dependencies { ... }\n plugins {\n id(\"com.google.gms.google-services\")\n }\n ```\n\n \u003cbr /\u003e\n\nOnce you have added Google Analytics for Firebase to your instant app project, you can\nuse the Google Analytics for Firebase APIs as you might in an installable app project.\n\nFor more information about how to use the Google Analytics for Firebase APIs, see\nthe\n[getting started documentation for Google Analytics for Firebase](https://firebase.google.com/docs/analytics/android/start/).\n\nDifferentiating between installed and instant app data\n------------------------------------------------------\n\nBecause both your installed and your instant app share a package name, you\nmay want to differentiate the events and data collected from each. To\ndifferentiate your instant and installed apps in Analytics, set\na `app_type` user property, with the value \"instant\" for the instant app and\n\"installed\" for the installed app.\n| **Note:** Both the instant app and the installed app need to implement the `app_type` user property. Further, you must publish the installed app that contains `app_type` before the instant app. Otherwise, Analytics logs installed app events to the instant app when users install the app.\n\nThe following code snippet shows an activity that gets an\nAnalytics instance and then sets a user property. Notice that\nthe code uses\n[`PackageManagerCompat.isInstantApp()`](https://developers.google.com/android/reference/com/google/android/gms/instantapps/PackageManagerCompat.html#isInstantApp())\nin the [onCreate(android.os.Bundle)](/reference/android/app/Activity#onCreate(android.os.Bundle))\nmethod to determine the app's context. \n\n### Kotlin\n\n```kotlin\nval STATUS_INSTALLED = \"installed\"\nval STATUS_INSTANT = \"instant\"\nval ANALYTICS_USER_PROP = \"app_type\"\n\nprivate lateinit var firebaseAnalytics: FirebaseAnalytics\n\nprotected fun onCreate(savedInstanceState: Bundle?) {\n ...\n\n firebaseAnalytics = FirebaseAnalytics.getInstance(this)\n\n // Determine the current app context, either installed or instant, then\n // set the corresponding user property for Google Analytics.\n if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {\n firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)\n } else {\n firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)\n }\n}\n```\n\n### Java\n\n```java\nfinal String STATUS_INSTALLED = \"installed\";\nfinal String STATUS_INSTANT = \"instant\";\nfinal String ANALYTICS_USER_PROP = \"app_type\";\n\nprivate FirebaseAnalytics firebaseAnalytics;\n\n@Override\nprotected void onCreate(Bundle savedInstanceState) {\n ...\n\n firebaseAnalytics = FirebaseAnalytics.getInstance(this);\n\n // Determine the current app context, either installed or instant, then\n // set the corresponding user property for Google Analytics.\n if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {\n firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);\n } else {\n firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);\n }\n\n}\n```\n\nOnce you set the `app_type` user property, you can select an event in the\nAnalytics console's **Events** tab and then filter the event by the\n`app_type` value. The resulting data projection gives you a count for the\nspecified event in your instant or installed app.\n\nFor more information about how to log and view events in Google Analytics for Firebase,\nsee [Log Events](https://firebase.google.com/docs/analytics/android/events).\n\nInterpreting Analytics events\n-----------------------------\n\nAnalytics allows you to track a variety of metrics valuable\nto an instant app. The following table describes relevant metrics for your\ninstant app, including the corresponding event name or property in\nAnalytics.\n\n| Name | Analytics value | Definition |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Visits | `session_start` | Session started. This event is automatically tracked. |\n| Physical purchases | [`Firebase.Event.ECOMMERCE_PURCHASE`](https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event.html#ECOMMERCE_PURCHASE) | Physical purchases. You must explicitly track this event in your code. |\n| Digital purchases | `in_app_purchase` | Digital in-app purchases. This event is automatically tracked. |\n| Time in app | `user_engagement` | Amount of time that the app spends in the foreground. This event is automatically tracked. |\n| Instant app context | `app_type` | Events raised from the app running in the instant or installed context. You must explicitly track this event in your code. See [Differentiating between installed and instant app data](#analytics-implement) above. |\n| Return visitors | `session_start.count` and `app_type` | Audience of users who visit twice or more. You must explicitly track the `app_type` event; `session_start` is tracked for you. See [Differentiating between installed and instant app data](#analytics-implement) above. |\n\nFor more information about the constants for events that you can collect in\nAnalytics, see\n[FirebaseAnalytics.Event](https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event.html)."]]
