Firebase App Indexing — 앱 콘텐츠 색인의 본질과 작동 원리

Firebase App Indexing이란

Firebase App Indexing은 모바일 앱 콘텐츠를 Google 검색 크롤러가 액세스할 수 있게 하는 Google 기술로, Google이 웹 페이지를 색인하는 것과 같은 방식으로 앱 화면을 색인할 수 있습니다. 앱 콘텐츠가 색인되면 사용자는 Google Search, Google Assistant 또는 Google Lens에서 이를 찾아 웹 페이지를 거치지 않고 원하는 앱 화면으로 한 번의 클릭으로 직접 이동할 수 있습니다.

모바일 콘텐츠 색인 원리

Google은 자동 색인과 Firebase App Indexing API의 두 가지 메커니즘을 통해 앱을 색인합니다. 자동 색인은 Google Play Services를 통해 Android에서 작동합니다. 앱이 설치된 경우 Google은 딥 링크가 있는 콘텐츠를 자동으로 색인합니다. API 색인을 통해 개발자는 Firebase App Indexing API를 사용하여 색인된 페이지를 업데이트하거나 제거함으로써 검색에 표시되는 콘텐츠를 프로그래밍 방식으로 제어할 수 있습니다.

앱 색인이 필요한 이유

앱 색인은 여러 가지 작업을 해결합니다: Google 검색에서 신규 사용자 유치 (검색 결과는 카드로 앱 콘텐츠 표시). 참여도 향상 — 기존 사용자는 기기 검색을 통해 원하는 콘텐츠를 더 빠르게 찾습니다. 설치 증가 — Google 검색은 콘텐츠에 대한 딥 링크를 표시하고, 앱이 설치되지 않은 경우 설치 링크를 표시합니다. App Indexing은 Google Assistant에서 앱 가시성도 향상시켜 음성 검색 중에 앱 열기를 제안할 수 있습니다.

앱 콘텐츠 색인 작동 방식

색인 프로세스는 Google이 앱의 URI 스키마를 발견하면서 시작됩니다. Android의 경우 Google은 Google Play Store (API 수준, intent-filter, URI 스키마)의 정보를 사용하여 앱 맵을 구축합니다. iOS의 경우 색인은 Spotlight Integration 및 CSSearchableIndex를 통해 수행됩니다. Google이 앱 콘텐츠를 색인할 때 URI (예: myapp://product/123)를 웹 URL (있는 경우)과 연결하고 이 쌍을 검색 색인에 저장합니다.

앱과 웹사이트 연결

올바른 색인을 위해 Google은 앱과 웹사이트 간의 관계를 이해해야 합니다. Digital Asset Links는 웹사이트에 업로드되는 JSON 파일로, 모바일 앱이 사이트 소유자에 속함을 확인합니다. assetlinks.json 파일은 도메인 루트에 배치되며 앱의 서명 인증서 SHA256 지문을 포함합니다. Google은 검색 결과에 앱 열기 버튼을 표시하기 전에 이 연결을 확인합니다.

// https://yourapp.com/.well-known/assetlinks.json
[
    {
        "relation": ["delegate_permission/common.handle_all_urls"],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.myapp",
            "sha256_cert_fingerprints": [
                "14:6D:E9:92:..."
            ]
        }
    }
]

색인 소스

Google은 여러 소스에서 색인할 콘텐츠를 받습니다: Google Play Store (URI 스키마가 포함된 게시된 앱 목록), Android App Links (Android 6.0+에서 확인된 HTTP 스키마), Firebase App Indexing API (프로그래밍 방식 색인 업데이트), 앱이 설치된 기기에서 Google Play Services를 통한 자동 색인. 각 소스는 전체 색인을 보완하여 앱 콘텐츠를 검색에 최대한 액세스 가능하게 만듭니다.

Google Play Services를 통한 자동 색인

Google Play Services는 앱이 올바른 URI 스키마와 intent-filter를 사용하는 경우 Android에 설치된 앱의 콘텐츠를 자동으로 색인합니다. 이 메커니즘은 VIEW 작업에 대한 intent-filter를 앱에서 스캔하고 앱에서 사용되는 URI를 수집합니다. 이 프로세스는 완전 자동이며 개발자의 추가 코드가 필요하지 않습니다 — 매니페스트에서 딥 링크를 올바르게 구성하기만 하면 됩니다.

자동으로 색인되는 URI

Google은 특정 기준을 충족하는 URI를 자동으로 색인합니다: URI는 VIEW 작업이 있는 intent-filter를 통해 액세스 가능해야 하며, Android App Links의 경우 스키마는 HTTP/HTTPS여야 합니다. 사용자 정의 스키마가 있는 URI (myapp://)도 색인되지만 앱이 설치된 경우에만 가능합니다. 자동 색인은 인증 페이지나 사용자의 개인 데이터로 연결되는 URI에는 적용되지 않습니다.

자동 색인의 제한 사항

자동 색인에는 몇 가지 제한 사항이 있습니다: 색인이 즉시 업데이트되지 않고 몇 시간에서 며칠의 지연이 있습니다. 앱 API 수준 — 자동 색인에는 minSdkVersion 23 이상이 필요합니다. HTTP/HTTPS 스키마가 없는 URI는 앱이 설치된 기기에서만 색인됩니다. 색인 속도를 높이고 웹 버전이 없는 콘텐츠를 추가하려면 Firebase App Indexing API를 사용하는 것이 좋습니다.

Firebase App Indexing API

Firebase App Indexing API는 개발자가 프로그래밍 방식으로 앱의 색인된 콘텐츠를 관리할 수 있는 Google HTTP API입니다. API는 Google 색인에 URI 페이지를 추가, 업데이트 및 제거하는 요청을 수락합니다. 자동 색인과 달리 API는 즉시 작동합니다: 호출 후 Google은 몇 분 내에 검색 결과에서 새 URI를 고려하기 시작합니다.

Firebase App Indexing API 요청 형식

Firebase App Indexing API에 대한 요청에는 URI, 제목, 설명 및 선택적 이미지가 포함된 페이지 객체가 포함됩니다. 각 URI는 Google 검색을 통해 찾을 수 있는 별도의 페이지로 처리됩니다. API는 Firebase Service Account를 통한 OAuth 2.0 인증을 사용합니다. URI의 대량 추가를 위해 단일 요청에서 최대 1000페이지의 일괄 처리가 지원됩니다.

import com.google.firebase.appindexing.FirebaseAppIndex;
import com.google.firebase.appindexing.Indexable;
import com.google.firebase.appindexing.builders.Indexables;

public class AppIndexingHelper {
    public static void indexProduct(String productId,
            String name, String price) {
        Indexable product = Indexables.newSimpleBuilder(name)
            .setUrl("myapp://product/" + productId)
            .setDescription("가격: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("인덱스", "확인"))
            .addOnFailureListener(e ->
                Log.e("인덱스", "오류", e));
    }

    public static void removeProduct(String productId) {
        FirebaseAppIndex.getInstance()
            .remove("myapp://product/" + productId);
    }
}

콘텐츠 업데이트 및 제거

앱 콘텐츠가 변경되면 Firebase App Indexing API를 통해 Google 색인을 업데이트해야 합니다. 오래된 콘텐츠 제거도 중요합니다: URI가 더 이상 존재하지 않거나 404로 연결되는 경우 색인에서 제거해야 합니다. Firebase App Indexing은 앱에서 콘텐츠가 변경되어도 자동으로 제거하지 않습니다 — 개발자는 현재 콘텐츠 상태와 색인을 동기화할 책임이 있습니다. 데이터 변경 (제품, 기사, 프로필 추가, 편집 또는 삭제) 시마다 API를 호출하는 것이 좋습니다.

Android에서 App Indexing 설정

Android에서 Firebase App Indexing 설정에는 여러 단계가 포함됩니다: Firebase SDK 추가, build.gradle에 app-indexing 종속성 추가, Android App Links 구성, URI 처리를 위한 서비스 생성. Firebase App Indexing의 최소 API 버전은 23입니다. SDK 구성 후 앱은 Google Play Services를 통해 Google에 색인 데이터를 자동으로 보내기 시작합니다.

종속성 및 구성 추가

Firebase App Indexing의 경우 앱 모듈의 build.gradle에 com.google.firebase:firebase-appindexing 종속성과 google-services 플러그인을 추가해야 합니다. Firebase는 앱이 요구 사항 (minSdkVersion 23+, HTTP/HTTPS 스키마가 있는 intent-filter 존재, 확인을 위한 Android App Links 사용)을 충족하는 경우 Google Play Services를 통해 색인 데이터를 자동으로 처리합니다. 사용자 정의 스키마가 있는 URI의 경우 추가 구성이 필요합니다.

// build.gradle (모듈: app)
plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}

android {
    defaultConfig { minSdkVersion 24 }
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0')
    implementation 'com.google.firebase:firebase-appindexing'
}

Android App Links 및 확인

Android App Links는 Google이 앱에 속하는 것으로 확인하는 HTTP/HTTPS 링크입니다. 확인은 Digital Asset Links를 통해 수행됩니다: assetlinks.json 파일이 웹사이트에 업로드됩니다. 확인 후 Android는 도메인의 모든 링크를 App Links로 자동 처리하며, 사용자에게 링크를 열 앱을 묻지 않습니다. 이는 올바른 앱 콘텐츠 색인을 위한 필수 조건입니다.

색인 확인

구성 후 앱 콘텐츠가 실제로 색인되고 있는지 확인해야 합니다. Firebase Console의 App Indexing 섹션에는 통계가 표시됩니다: 색인된 URI 수, 검색 노출 수 및 클릭 수. 자세한 확인을 위해 Google Search Console을 사용하면 색인 오류 및 권장 사항이 표시됩니다. Google에서 site:https://your-app.page.link를 검색하여 앱의 색인된 페이지를 볼 수도 있습니다.

색인 모범 사례

효과적인 앱 색인을 위해서는 몇 가지 주요 사례를 따라야 합니다. 색인하려는 모든 URI는 실제 콘텐츠로 연결되어야 합니다 — 플레이스홀더, 빈 화면 또는 오류 페이지가 없어야 합니다. 공개 콘텐츠만 색인하고 인증이 필요한 페이지는 색인하지 않는 것이 좋습니다. 각 URI는 사용자의 언어로 읽을 수 있는 이름과 설명이 있어야 합니다.

색인할 내용

사용자가 Google에서 검색하는 콘텐츠를 색인하세요: 제품 카드, 기사, 프로필, 메뉴 카테고리, 레시피, 이벤트. 개인 데이터, 설정, 장바구니, 주문 내역 또는 기타 개인 데이터가 포함된 페이지는 색인하지 마세요. 동적 콘텐츠 (뉴스 피드, 개인화된 선택)의 경우 Firebase App Indexing API를 사용하여 새 URI가 생성될 때 추가하고 삭제될 때 제거하세요.

검색 최적화

색인된 각 URI에는 검색 결과에 대한 의미 있는 제목, 설명 및 미리보기 이미지가 있어야 합니다. 제목과 설명에 실제 사용자 검색어와 일치하는 키워드를 사용하세요. 이미지의 경우 1200x1200 px 정사각형 형식을 사용하고 공개 URL을 통해 액세스할 수 있는지 확인하세요. 콘텐츠를 정기적으로 업데이트하세요: Google은 검색에서 새 페이지를 더 자주 표시합니다.