Skip to content

docs: correct KDoc for attributionMethod, LinkFortyConfig and the setup example - #22

Merged
onamfc merged 3 commits into
mainfrom
chore/kdoc-accuracy
Oct 28, 2026
Merged

onamfc merged 3 commits into
mainfrom
chore/kdoc-accuracy

Conversation

@onamfc

@onamfc onamfc commented Oct 27, 2026

Copy link
Copy Markdown
Member

Builds on #21. This PR targets docs/readme-accuracy; once #21 merges it will retarget to main.

Comments and docs only. No code changes.

Changes

  • DeepLinkData.attributionMethod / InstallResponse.attributionMethod: the KDoc listed only "fingerprint" (and "none"). Core also returns "install_referrer" when the Play install referrer names the click, and SDK 1.8.0 sends that referrer. matchedFactors is documented to include ["install_referrer"] in that case.
  • LinkFortyConfig: apiKey was described as "for LinkForty Cloud authentication", and appToken as "Optional… Recommended". Now apiKey is described as needed only for createLink(): it is sent as a Bearer token when set, and it is a secret. appToken is described as required on the hosted service and not needed by a self-hosted Core server. baseURL names https://api.linkforty.com and the HTTP-allowed local hosts. The organic-install example said "App Store"; it now says "Play Store".
  • LinkForty class example: go.yourdomain.com + apiKey is replaced with https://api.linkforty.com + appToken, matching the README.
  • Wording: "Cloud" in DeviceFingerprint.kt and AttributionManager.kt comments, README.md, llms.txt, e2e/README.md and the 1.2.0 CHANGELOG entry now describes the hosted service generically. A ticket reference is dropped from a test comment.

Verified

./gradlew :sdk:compileReleaseKotlin :sdk:testDebugUnitTest succeeds: 205 unit tests, 0 failures.

… llms.txt

- Initialize against the hosted API host (https://api.linkforty.com) with an
  appToken, which the hosted service requires; apiKey is only for createLink()
  and is a secret.
- Add a config field table, the Maven Central repository, and the coroutine
  requirement for initialize() and the tracking calls.
- App Links: android:exported="true" and launchMode="singleTask" in the
  manifest sample, setIntent() in onNewIntent, how assetlinks.json is served,
  the Play App Signing fingerprint, and pm verify-app-links / get-app-links.
- createLink(): against a Core server the fallback POST /api/links needs an
  originalUrl the SDK doesn't send.
- Privacy: replace "probabilistic fingerprinting only / no persistent IDs" with
  what the code does (Play install referrer, stored install ID), list the data
  each request sends and the install referrer permission the dependency adds.
- API.md: attributionMethod can be "install_referrer"; appToken/apiKey wording.
- llms.txt: version 1.1.0 -> 1.8.0, drop the GitHub Packages repository (the
  SDK is on Maven Central), fix the hosted base URL and the claim that all
  methods work identically on a self-hosted server.
…up example

- DeepLinkData and InstallResponse: attributionMethod can be
  "install_referrer", and matchedFactors is ["install_referrer"] then.
- LinkFortyConfig: the app token is required on the hosted service; the
  API key is needed only for createLink and is a secret.
- LinkForty class example: use https://api.linkforty.com with an appToken.
- Describe the hosted service generically in comments, README, llms.txt,
  e2e/README and an older CHANGELOG entry, and drop a ticket reference
  from a test comment.
@onamfc
onamfc changed the base branch from docs/readme-accuracy to main October 28, 2026 06:40
@onamfc
onamfc merged commit c6f1ed6 into main Oct 28, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants