AppsFlyer Android SDKリリースノート

推奨

マーケター デベロッパー

最終更新日： 2024年11月28日 03:38

概要：Android SDKの最新の変更点の概要については、このSDKリリースノートをご確認ください。より包括的な詳細を求める開発者は、AppsFlyer公式デベロッパーハブのAndroidリリースノートを確認してください。

Android SDK V6

デベロッパー向けAndroid SDK実装ガイド

バージョン	リリース日	備考
6.15.2	2024-10-10	安定性の改善と修正 Privacy Sandbox Attribution APIに関連する内部アップデート
6.15.1	2024-08-28	バージョンアップグレード： targetSDKVersion: v34 Gradle: v8.7 Java: v17
6.15.0	2024-07-31	広告収益データをAppsFlyerに送信するメソッド `logAdRevenue` を追加しました。注記！：このバージョンから、AdRevenue Connectorは使用しないでください。すでに実装されている場合は、コネクターを削除し、メソッド `logAdRevenue` に置き換える必要があります。詳細はこちら
6.14.2	2024-06-10	UnityでビルドされたアプリのMeta Install Referrerの取得に関する問題を修正しました。
6.14.1	2024-05-29	SDK のメンテナンス
6.14.0	2024-04-18	最新のPurchase Validationフローに対応しました（この機能は現在クローズドベータ版です）。詳細はこちら Huawei Referrerの統合を更新しました。詳細はこちらを参照してください。
6.13.1	2024-04-03	SDKメンテナンス
6.13.0	2024-02-08	Googleの新しいEU同意ポリシー (DMA) のサポートを追加しました
6.12.6	2024-01-29	SDKメンテナンス
6.12.5	2023-12-18	ESP 解決フローのディープリンクコールバックに`original_link`パラメーターを追加しました。
6.12.4	2023-10-25	Dexguard がバージョン 9.4.16 に更新され、SDK の安定性が向上しました。
6.12.3	2023-08-31	SDKメンテナンス
6.12.2	2023-08-02	Android 8.1.0, および Android 11の一部のデバイスでアプリがクラッシュする可能性があったバグを修正しました。
6.12.1	2023-06-29	クロスプロモーションで Play Store の立ち上げが遅れる問題を修正しました。一部のデバイスでアプリがクラッシュするバグを修正しました。
6.12.0	2023-06-28	非推奨 - バージョン 6.12.1 を使用してください。
6.11.2	2023-06-29	一部のデバイスでアプリがクラッシュするバグを修正しました。
6.11.1	2023-06-06	非推奨 - バージョン 6.12.1 を使用してください。 SDK の初期化後にアプリがクラッシュすることがある不具合を修正しました。
6.11.0	2023-05-16	SDK が Google Play リファラを取得しようとしたときに、一部のデバイスでアプリがフリーズすることがある問題を修正しました。
6.10.3	2023-04-25	SDKメンテナンス
6.10.1	2023-03-01	SDK 初期化時に Samsung デバイスのアプリが閉じることがある問題を修正しました。この問題は、SDK V6.6.0以降のアプリに影響しました。
6.10.0	2023-02-13	SDK と AppsFlyer サーバー間の通信のための新しい AppsFlyer ドメイン。空白または Null 値が送信されるときの setHost API が変更されました。詳細はこちら
6.9.4	2022-12-6	広告収益 SDK コネクタから広告収益イベントを送信する際に、コンバージョンリスナーへの呼び出しがトリガーされる問題を修正しました。広告収益 SDK コネクタから広告収益イベントを送信する際に、アプリがフリーズすることがある問題を修正しました。
6.9.3	2022-11-28	コンバージョンデータの取得 (GCD) の内部リクエスト構造を更新しました。注記：応答データは変わりません。アプリのコンバージョンリスナーが null に設定されている場合に SDK が GCD リクエストをトリガーする問題を修正しました。
6.9.2	2022-10-02	validateAndLogInAppPurchase API を使用した購入検証のリクエスト遅延に関連する問題を修正しました。
6.9.1	2022-09-19	SDKメンテナンス
6.9.0	2022-09-12	Xiaomi GetApps Store リファラのサポートが追加されましたアプリ内広告収益レポートの内部APIを更新しました。このバージョン以降では、汎用広告収益SDKコネクタのみがサポートされます。
6.8.2	2022-08-29	V6.7.0 で導入された SDK のキャッシュメカニズムで、キャッシュされたイベントが複数回送信されるという重大な問題を修正しました。
6.8.1 （非推奨）	2022-08-24	（非推奨）。V6.8.2をご利用ください。
6.8.0 （非推奨）	2022-07-18	（非推奨）。V6.8.2をご利用ください。 SDK から`enableLocationCollection` API を削除しました。アプリは、ユーザーの位置データを API I経由で直接 SDK に渡すことで、引き続きユーザーの位置データをレポートできます。 `com.google.android.gms.permission.AD_ID`SDK のへの`AndroidManifest.xml`権限を追加しました。詳しくはこちらをご覧ください。 R8 を使用した最適化と難読化に関連する問題を修正しました。
6.7.0 （非推奨）	2022-06-19	（非推奨）。V6.8.2をご利用ください。 SDK が AppsFlyer サーバーへのリクエストを処理する方法を変更しました。この変更に伴い、アプリ初回起動（コンバージョン）のレポートリクエストが、アプリ内イベントやその他の種類の要求よりも優先されます。詳しくはこちらをご覧ください。新しいAPI：携帯電話ネットワークに関する情報 (通信事業者名、事業者名) の収集をオプトアウトします。
6.6.1	2022-05-16	SDKメンテナンス
6.6.0	2022-05-01	ダイレクトディープリンクフロー（既存ユーザー）向けのUDL `onDeepLinking`コールバックにパラメーターを追加しました。詳細はこちら。`onDeepLinking`
6.5.4	2022-03-23	SDKメンテナンス
6.5.3	2022-03-09	バグ修正：英語以外の文字が含まれるユーザー招待リンクの作成に関する問題を修正しました。
6.5.2	2022-01-26	UDL でディファードディープリンクの URL を処理する際の問題を修正しました。 DexGuard 9.2へアップデートリファクタリングと内部変更。
6.5.1	2021-12-29	チャネルオプション付きの外部ストアを使用するアプリの、UDL によるディープリンク処理
6.5.0	2021-12-07	リファクタリングと内部変更。
6.4.3	2021-11-14	`LinkGenerator` を使用した`V6.4.2`で導入された、URL パラメーターが欠落したリンクの作成を引き起こすバグを修正しました。
6.4.2	2021-10-24	以下が修正されました： `pid`のパラメータが、`LinkGenerator`によって生成されたカスタム URL に2回付与されてしまう事象。 `LinkGenerator`を使ってカスタム URI スキームを作成する際に、`af_dp`の値に余分な`/` が追加されてしまう事象。アプリがどちらか片方のみの収集をトリガーした際に、IMEI と Android ID の両方を取得してしまう事象。
6.4.1	2021-10-17	V3.5.4より前のバージョンの Gradle を使用した際の、コンパイルエラーを解決しました。
6.4.0	2021-09-12	新しい API：は、SDK がデータ共有から除外するパートナーを構成できます。このバージョン以降、および `setSharingFilter` は廃止されました。
6.3.2 廃止：2024/08/31	2021-06-06	新しい API：`setDisableAdvertisingIdentifiers`
6.3.1 廃止：2024/08/31	2021-05-26	新しい API：`performOnDeepLinking` `stop`を呼び出す前や、を呼び出した後でも`start`User Invite APIstartをトリガーする機能を追加不具合の修正：`waitForCustomerUserIdsetCustomerUserId`を呼び出した後でもへの呼び出しがリリースされない問題を修正
6.3.0 廃止：2024/08/31	2021-04-29	不具合の修正：アプリ内イベントの送信リクエストが失敗`onConversionDataFail`した際に、の間違った呼び出しの修正バグ修正：モーションセンサーメトリックの収集(不正検知用) 不具合の修正：UDLに関する難読化の修正 OneLink API の技術的なアップデート
6.2.3 廃止：2024/08/31	2021-03-04	SDKメンテナンス
6.2.0 廃止：2024/08/31	2021-02-07	新しい API：`setPartnerData`
6.1.4 廃止：2024/08/31	2021-01-12	DexGuard V9 のサポートを追加
6.1.3 廃止：2024/08/31	2020-12-24	新しい API：`addPushNotificationDeepLinkPath`addPushNotificationDeepLinkPath(可動インク対応)
6.1.1 廃止：2024/08/31	2020-12-03	Samsung の Galaxy Store リファラのサポートを追加しましたマイナーなバグ修正とパフォーマンス改善。
6.1.0 廃止：2024/08/31	2020-11-09	Unified deep linking APIのサポートを追加
6.0.1 廃止：2024/08/31	2020-10-28	SDKメンテナンス
6.0.0 廃止：2024/08/31	2020-10-14	SDKの機能やAPIに大きな変更があり、サポートが終了したものやメソッド名の変更も含まれています。詳細はこちら

Android V6.0.0リリースノート

メソッドが削除/非推奨または名前が変更されました

削除/非推奨となったメソッド

次のメソッドが SDK から削除されました：

sendDeepLinkData
trackAppLaunch
setPluginDeepLinkData
setConsumeAFDeepLinks
setHostName

メソッドの名前が変更されました

API 名（V6 以前）	現在の API 名（V6 以降）
stopTracking	ストップ
setCustomerIdAndTrack	setCustomerIdAndLogSession
startTracking	開始
trackLocation	logLocation
reportTrackSession	logSession
trackEvent	logEvent
setDeviceTrackingDisabled	anonymizeUser
validateAndTrackInAppPurchase	validateAndLogInAppPurchase
isStopTracking	isStopped
trackAndOpenStore	logAndOpenStore
trackCrossPromoteImpression	logCrossPromoteImpression
trackInvite	logInvite

名前が変更されたインターフェイス

インターフェイス名 (V6 より前)	現在のインタフェース名 (V6 以降)
AppsFlyerTrackingRequestListener	AppsFlyerRequestListener

非推奨のバージョン

Android SDK V5 リリースノート

バージョン	リリース日	メンテナンスのみ	備考
5.4.6	2020-11-09		Huawei AppGalleryリファラを新たにサポートしました。
5.4.4	2020-10-01		ESP からの複数のリダイレクトを処理するための SDK のサポートが追加されました不具合の修正とメンテナンス
5.4.3	2020-07-30		拡張されたログおよびデバッグ機能不具合の修正とメンテナンス Google インストールリファラ V2 のサポート
5.4.1	2020-06-30		広告主が、連携済みパートナー／ネットワークとのデータの共有を制御できるようになりました詳細はこちら不具合の修正とメンテナンス
5.4.0	2020-06-03		OAID の自動収集を完全にサポートマルチリファラのサポート：SDK は Huawei と Google のリファラを収集することができます SDKパフォーマンスの向上不具合の修正とメンテナンス
5.3.0	2020-04-27		onAppOpenAttribution メソッドを使用して、最新のダイレクトディープリンク変換データにいつでもアクセスできますクロスプロモーションのインプレッションに使用できる追加パラメーター不具合の修正：Windows での a と b のファイル名に関する問題を修正ユーザーが特定のアクティビティにディープリンクされている場合でもアトリビューションデータを取得する sendDeepLinkData メソッドは非推奨となり、startTracking() メソッドが使用されるようになりました
5.2.0	6.0.0		任意のアクティビティで SDK の初期化を許可拡張されたセキュリティ、ログおよびデバッグ機能不具合の修正とメンテナンス
5.1.2	2020-02-19	はい
5.1.1	2020-01-23	はい
5.1.0	2020-01-06		Google のターゲット API レベルの要件に従って、Android 9（API レベル28）にターゲット設定 Protect360 クライアント向けに不正防止保護機能の改善 OAIDを収集するためのオプションモジュール（中国国内向け）- XiaomiとHuawei（https://github.com/AppsFlyerSDK/appsflyer-oaid 参照）。 ESP で setOneLinkCustomDomain を使用した際の安定性の改善
5.0.2	2019-12-23
5.0.1	2019-12-12
5.0.0	2019-11-12	不具合の修正とメンテナンス SDKの機能やAPIに大きな変更があり、サポートが終了したものやメソッド名の変更も含まれています。詳細はこちら

Android V5.0.0 リリースノート

SDK レスポンスタイムの向上

SDK V5.0.0 以降、オーガニックインストールの GCD レスポンスタイムが改善されました。

削除または改名されたメソッド

メソッド名の変更

インストールコンバージョンデータメソッドの名前が Android と iOS で同じになりました。これは、次の処理を行うメソッドに影響します。

インストール時のコンバージョンデータ
データが利用できない場合はエラーになります

SDK V5 以前の Android 名	SDK V5 以前の iOS 名	標準化された名前
`onInstallConversionDataLoaded`	`onConversionDataReceived`	`onConversionDataSuccess`
`onInstallConversionFailure`	`onConversionDataRequestFailure`	`onConversionDataFail`

削除されたメソッド

以下のメソッドは、以前の SDK バージョンでは廃止されました。今後は SDK から削除されます。

Android

setGCMProjectID (String projectNumber)
setGCMProjectNumber (String projectNumber）
setGCMProjectNumber (Context context, String projectNumber)
enableUninstallTracking (String senderId)
setAppUserId (String id)
setUserEmail (String email)
setCollectFingerPrint (boolean isCollect)
getAttributionId (ContentResolver contentResolver)
FirebaseInstanceIdListener class (instance of FirebaseInstanceIdService)

iOS

loadConversionDataWithDelegate: (id<AppsFlyerTrackerDelegate>)delegate
setHost:(NSString *)host

コンバージョンデータ取得形式の変更

このバージョンでは、インストールまたはアプリ起動のたびに、SDK はメディアソースやキャンペーン名などのコンバージョンデータ (GCD) を含むマップオブジェクトを返します。以前の SDK バージョンでは、GCD は値を持つパラメーターのみを返しました。

このバージョン以降、値を持たないパラメーターも含めて、すべてのパラメータが返されます。値を持たないパラメーターには、null と値が返されます。

例

次の URL をクリックしたあとにインストールします。

https://app.appsflyer.com/com.sample.app?pid=super_media_source&c=awesome_campaign
  &campaign_id=1234&af_sub1=promo

レスポンスは次の通りです。

   {
      "install_time": "2019-11-11 15:00:59.828",
      "media_source": "super_media_source",
      "orig_cost": "0.0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8c",
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "cost_cents_USD": "0",
      "iscache": "true",
      "click_time": "2019-11-11 15:00:35.102",
      "campaign": "awesome_campaign",
      "campaign_id": "1234",
  }

   {
      "adgroup": null,
      "campaign": "awesome_campaign",
      "media_source": "super_media_source",
      "adset_id": null,
      "campaign_id": 1234,
      "iscache": true,
      "install_time": "2019-11-11 15:00:59.828",
      "adgroup_id": null,
      "af_sub5": null,
      "click_time": "2019-11-11 15:00:35.102",
      "agency": null,
      "cost_cents_USD": "0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8",
      "adset": null,
      "af_sub3": null,
      "af_siteid": null,
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "af_cpi": null,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "retargeting_conversion_type": "none"
  }

GCD は、データに関係なく同じ構造を返します。パラメータが空の場合、GCD には null 値が含まれます。これにより、開発者は特定のパラメータの有無にかかわらず、GCD 処理ロジックを調整しなくても GCD を処理しやすくなります。シナリオ別のコンバージョンデータについては、こちらをご覧ください。

Android V4.0.0 リリースノート

バージョン	リリース日	備考
4.11.0	10-22-2019	次のデバッグ機能向上のためのログ改善： ESP ブランドリンクの解決 onInstallConversionData と onAppOpenAttribution 不具合の修正とメンテナンス
4.10.3	09-15-2019	不具合の修正とメンテナンス Open Advertiser ID (OAID) のサポート 4.10.2
4.10.1	07-01-2019	不具合の修正とメンテナンス
4.10.0	05-14-2019	ProGuard を使用する開発者向けの SDK の改善不具合の修正とメンテナンス
4.9.0	03-17-2019	別のユニバーサルリンクでラップされた OneLink を解決するための setResolveDeepLinkURLs API 以前のペイロードの破棄されたプッシュ通知記録に同じ pid が含まれ、メモリに残っていた場合の、プッシュ通知の記録を修正しました。 af_county から af_countryまでのタイプミスを修正不具合の修正とメンテナンス
4.8.20	02-13-2019	携帯電話プロバイダーのゼロレーティング機能の向上不具合の修正とメンテナンス
4.8.19	12-26-2018	メソッド`waitForCustomerUserId()`が`generateLink`を中断する問題を修正しました不具合の修正とメンテナンス
4.8.18	11-11-2018	トランポリンアクティビティによるディープリンクの問題を修正バックグラウンドとフォアグラウンド間を移動するときのリエンゲージメント精度を向上しました不具合の修正とメンテナンス
4.8.17	11-02-2018	ProGuard とのコンフリクトに関して、アプリ起動データが失われる可能性がある問題を修正しました。この問題は SDK バージョン4.8.16のみに影響します。
4.8.16	10-31-2018	不具合の修正とメンテナンス
4.8.15	08-27-2018	追加の SDK イベント：サブスクライブ、トライアルの開始、広告のクリック、広告の表示不具合の修正とメンテナンス
4.8.14	07-31-2018	AF_STORE 値を動的に設定するための、setOutOfStore および getOutOfStore API が追加されました AppsFlyer がトラッキングリクエストサーバーを正常に受信したことを確認するための`onTrackingRequestFailure`と`onTrackingRequestSuccess` API を追加しました。
4.8.13	06-20-2018	setImeiData API を通じて明示的に IMEI を渡した場合に、IMEI が欠落するエッジケースの不具合を修正不具合の修正とメンテナンス
4.8.12	05-27-2018	Robolectric を使用する JUnit テスト使用時のアプリのクラッシュを修正不具合の修正とメンテナンス
4.8.11	05-02-2018	不具合の修正とメンテナンス
4.8.10	04-26-2018	`setPreinstallAttribution` API を追加不具合の修正とメンテナンス
4.8.9	04-02-2018	GooglePlayServices がデバイスに存在せず、そのデバイス上で GAID を取得できない場合にのみ、IMEI を収集します不具合の修正とメンテナンス
4.8.8	03-11-2018	customerUserID が提供されるまで SDK の初期化を遅らせるための API を追加不具合の修正とメンテナンス
4.8.7	01-25-2018	`isStopTracking` API が全ての SDK アクティビティを停止します `af_content`イベントパラメータ
4.8.5	11-29-2017	新しい Google リファラ API のサポートコンテキストを受け取る新しい init メソッド
4.8.4	11-14-2017	getConversionData `is_first_launch`に、アプリケーションの初回起動かどうかを示すフラグを追加しました。このフラグを使用すると、開発者は、起動ごとに返される getConversionData コールバック応答内でアプリの最初の起動を簡単に識別できます。is_first_launchに指定できる値は "true "または "false" 不具合の修正とメンテナンス
4.8.3	09-27-2017	getConversionData で http リファラデータのサポートが追加されました
4.8.2	09-19-2017	複数のアクティビティにディープリンクするアプリの sendDeepLinkData(this) に修正を追加
4.8.1	09-17-2017	SDK 初期化前に呼び出されるアプリ内イベントに対する保護の強化
4.8.0	09-03-2017	ユーザー招待 API クロスプロモーション API カスタムのセッション間隔携帯電話プロバイダーのゼロレーティング機能をサポート追加イベントパラメーター af_projected_revenue 不具合の修正とメンテナンス追加の init メソッドが導入されました ‐ AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4	06-28-2017	複数の ScheduledExecutorService のシャットダウンの処理が改善されました
4.7.3	06-06-2017	mParticle 統合の機能強化
4.7.2	05-22-2017	マイナーなメモリリークの問題を修正アンインストール計測の精度の向上アンインストール計測に影響する ProGaurd 警告を修正不具合の修正とメンテナンス
4.7.1	02-22-2017	ProGuard によってトリガーされる警告を修正しました
4.7.0	02-13-2017	追加イベントパラメーター Firebase ベースのアンインストール計測のサポート不具合の修正とメンテナンス

参照：

AppsFlyer SDK のバージョンコントロールポリシー