Djúptenglar

Kixo Deep Links senda hvern og einn á besta tiltæka áfangastað. Ef appið er uppsett opnar sami merkti HTTPS-tengillinn réttan skjá í appinu. Annars getur hann opnað vefsíðuna þína, App Store eða varaleið í Google Play. Stýrikerfið sér um staðfesta opnun appsins; ef tengillinn endar í vafra notar Kixo þá varaleið sem er vistuð fyrir tengilinn.

Hvernig tengill opnast

Notaðu nákvæmlega merkta hýsilinn

Hýsill Kixo-tengils tilheyrir einu verkefni og lítur út eins og yourbrand.kixo.cc. Þróunarverkefni geta notað aðra endingarhluta sem Kixo stýrir. Afritaðu alltaf allan hýsilinn úr mælaborðinu.

Vefur og QR-handoff

Web SDK greinir sjálfkrafa lendingu af Kixo-tengli. Notaðu getLinkData() aðeins þegar vefsíðan þín þarf uppleyst herferðarsamhengi eða sérsniðnar breytur í eigin leiðarstýringu.

const link = Kixo.getLinkData();

if (link?.params.product_id) {
  // URL values are user-controlled. Allowlist them before routing.
  router.openProduct(link.params.product_id);
}

Bjóða „Open in app“ á farsímavef

Sendu alla opinberu tengilsslóðina sem Kixo skilar. Borðinn birtist aðeins á farsímavef og lætur Kixo-tengilinn velja á milli uppsetts apps, verslunar eða vefáfangastaðar.

Kixo.showSmartBanner({
  linkId: 'YOUR_KIXO_LINK_ID',
  linkUrl: 'https://YOUR_EXACT_KIXO_HOST/link/YOUR_LINK_SLUG',
  title: 'Continue in the app',
});

Halda áfram lotu á tölvu með QR-kóða

Ef QR-kóði birtist á vefsíðunni þinni skaltu láta Kixo búa til handoff fyrir tengil sem þegar er til, í stað þess að setja saman URL sjálf(ur). Kixo notar app- og vefáfangastaðina sem eru vistaðir fyrir þann tengil.

const handoff = await Kixo.createQrHandoff({
  linkId: 'YOUR_KIXO_LINK_ID',
  params: {
    product_id: '42',
  },
});

qrCode.render(handoff.url);

Android App Links

Áður en þú breytir kóða skaltu vista Android pakkanafnið og öll SHA-256 fingraför fyrir undirritun appsins í Öpp og uppsetning. Ef Google Play undirritar útgáfuna skaltu líka bæta við fingrafarinu fyrir Play App Signing, auk allra fingrafara sem eru notuð í beinum eða innri smíðum.

1. Bættu hýslinum í manifestið

Settu þessa intent filter á það activity sem sér um leiðarstýringu appsins. Skiptu aðeins út staðgenglinum fyrir hýsil.

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:scheme="https"
            android:host="YOUR_EXACT_KIXO_HOST"
            android:pathPrefix="/link/" />
    </intent-filter>
</activity>

2. Áframsendu hlýjar opnanir

Kixo SDK les App Link við kalda ræsingu. Þegar Android endurnýtir activity sem er þegar til staðar skaltu senda nýja intent áfram svo hlý opnun fari sömu leið fyrir rakningu og leiðarstýringu.

import android.content.Intent
import io.kixo.sdk.Kixo

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    setIntent(intent)
    intent.dataString?.let { url ->
        Kixo.handleDeepLink(url, source = "applink")
    }
}

3. Staðfestu Android

Settu appið upp aftur eftir breytingu á manifest, láttu síðan Android staðfesta hýsilinn og skoðaðu niðurstöðuna.

adb shell pm verify-app-links --re-verify YOUR_ANDROID_PACKAGE
adb shell pm get-app-links YOUR_ANDROID_PACKAGE

# The exact host should be "verified".
adb shell am start -W \
  -a android.intent.action.VIEW \
  -d "https://YOUR_EXACT_KIXO_HOST/link/YOUR_LINK_SLUG"

iOS Universal Links

Vistaðu bundle ID appsins og Apple team ID í Öpp og uppsetning. Í Xcode skaltu virkja Associated Domains capability á sama app target og í sömu signing configuration og notuð er fyrir uppsettu smíðina.

1. Bættu við viðeigandi léni

applinks:YOUR_EXACT_KIXO_HOST

2. Áframsendu kalda og hlýja tengla

Veldu þann lífsferil sem appið notar. Bæði dæmin skila uppleysta áfangastaðnum í þitt eigið leiðarkerfi; Kixo kemur ekki í stað leiðarstýringar appsins.

import Kixo

WindowGroup {
    ContentView()
        .onKixoDeepLink { link in
            guard link.phase == .resolved else { return }
            router.open(link.targetPath ?? link.path)
        }
}

3. Staðfestu iOS

1. Eyddu appinu af tækinu og settu síðan upp undirritaða smíð.
2. Opnaðu raunverulegan Kixo-tengil úr Notes, Messages eða Safari. Ekki láta eina prófið felast í að líma hann í veffangastikuna í Safari.
3. Staðfestu að köld opnun fari á réttan skjá.
4. Láttu appið vera opið, pikkaðu aftur á tengilinn og staðfestu hlýja opnun.
5. Staðfestu að opnun tengilsins birtist í Kixo.

Hafðu leiðarstýringuna inni í appinu

Kixo-tengill getur innihaldið áfangastað eins og /products/42. Varpaðu þekktum slóðum á eigin skjái og haltu óbreyttum aðgangsheimildum appsins. Ekki nota uppleysta gildið sem almennan URL-opnara.

Kixo.setDeferredDeepLinkListener { link ->
    if (link?.phase != KixoDeepLinkPhase.RESOLVED) return@setDeferredDeepLinkListener
    when {
        link.targetUrl?.startsWith("/products/") == true ->
            router.openProduct(link.targetUrl.substringAfterLast("/"))
        link.targetUrl == "/account" ->
            router.openAccount()
    }
}

Gefðu þetta kóðaaðstoðarmanni

Skiptu út staðgenglunum fimm með gildum úr Verkefnisstillingar → Forrit og uppsetning og Djúpir tenglar og límdu síðan allan textann inn í Codex, Claude Code, Cursor, Windsurf eða annan kóðaaðstoðarmann.

Add Kixo Deep Links to this app.

Project values:
- Kixo branded host: YOUR_EXACT_KIXO_HOST
- Android package name: YOUR_ANDROID_PACKAGE
- Android SHA-256 signing fingerprints: YOUR_ANDROID_FINGERPRINTS
- iOS bundle ID: YOUR_IOS_BUNDLE_ID
- Apple team ID: YOUR_APPLE_TEAM_ID

Requirements:
1. Use the exact branded host above. Do not replace it with kixo.cc, dixo.dev, a wildcard, or the website domain.
2. Keep the app's existing navigation. Kixo resolves and measures the link; the app decides which screen to show.
3. Android:
   - add an android:autoVerify App Links intent filter for https://YOUR_EXACT_KIXO_HOST/link/
   - keep the package name and every release signing fingerprint in Kixo Apps & setup
   - forward warm Activity.onNewIntent URLs to Kixo.handleDeepLink(url, source = "applink")
4. iOS:
   - add applinks:YOUR_EXACT_KIXO_HOST to the app target's Associated Domains entitlement
   - keep the bundle ID and Apple team ID in Kixo Apps & setup
   - for SwiftUI, attach .onKixoDeepLink to the root view
   - for UIKit scenes, forward cold connectionOptions and warm NSUserActivity callbacks to Kixo
5. Route only known in-app paths. Do not blindly open an arbitrary URL returned by a link.
6. Test a cold open and a warm open on a physical device or emulator. Confirm the app opens directly and the link open appears in Kixo.

Return:
- the files changed
- the exact host configured in each platform
- cold-open and warm-open test results
- anything still requiring a dashboard or signing-account change

Gátlisti fyrir útgáfu

• Nákvæmi Kixo-hýsillinn er til staðar í uppsetningu fyrir Android og iOS.
• Android sýnir hýsilinn sem staðfestan fyrir útgáfupakkanum.
• Undirritunarfingraför útgáfunnar eru vistuð í Kixo.
• iOS entitlement er til staðar í undirrituðu app-smíðinni.
• Kaldar og hlýjar opnanir fara á réttan skjá.
• Varaleið á vef eða í verslun virkar án þess að appið sé uppsett.
• Opnun tengilsins birtist í Kixo-greiningu.

Tengdir leiðarvísar

• Android SDK
• iOS SDK
• AI-kóðunaraðstoð