ガイド
Capacitor で Install Referrer を使用する方法
@capgo/capacitor-install-referrer の使い方
@capgo/capacitor-install-referrer Capacitor アプリ内のインストールアトリビューションシグナルを読み取ります。
Android の Google Play Install Referrer データと iOS の Apple AdServices アトリビューショントークンを、1つの API 経由で扱いたいときに使います。
インストール
bun add @capgo/capacitor-install-referrer
bunx cap sync
このプラグインで利用可能な機能
getReferrerAndroid または iOS のインストールアトリビューション詳細を返します。GetReferrer〜からの移行用の非推奨の互換性エイリアスです。cap-play-install-referrer.- Androidでは、Play referrer文字列、クリックタイムスタンプ、インストールタイムスタンプ、およびInstant Appフラグを取得できます。
- iOSでは、AdServicesアトリビューショントークンを返し、オプションでAppleのアトリビューションペイロードを取得可能です。
使用例
import { InstallReferrer } from '@capgo/capacitor-install-referrer';
const result = await InstallReferrer.getReferrer();
if (result.platform === 'android') {
console.log(result.referrer);
}
if (result.platform === 'ios') {
console.log(result.attributionToken);
}
Apple アトリビューション ペイロード
const result = await InstallReferrer.getReferrer({
fetchAppleAttribution: true,
appleAttributionRetryCount: 3,
appleAttributionRetryDelayMs: 5000,
});
console.log(result.appleAttribution);
プラットフォームに関する注意点
AndroidはGoogle Play Install Referrerサービスを使用するため、正確なリファラーデータの取得にはPlay Store経由のインストールが必要です。一方、iOSはApple AdServicesを使用します。これは、AppleがApp Storeにおいて汎用的なインストールリファラーを提供していないためです。
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-install-referrer/
- ドキュメント: /docs/plugins/install-referrer/
「@capgo/capacitor-install-referrer の使い方」から続ける
使用している場合 @capgo/capacitor-install-referrer の使い方 ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-install-referrer @capgo/capacitor-install-referrer の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。