Adobe Experience Platform Mobile SDK のインストール
モバイルアプリにAdobe Experience Platform Mobile SDK を実装する方法について説明します。
前提条件
- タグライブラリが正常に構築され、 前のレッスン.
- からの開発環境ファイル ID モバイルインストール手順.
- 空の サンプルアプリ.
- の使用経験 Xcode.
学習内容
このレッスンでは、次の操作を実行します。
- Swift パッケージマネージャーを使用して、必要な SDK をプロジェクトに追加します。
- 拡張機能を登録します。
Swift Package Manager
CocoaPods と POD ファイルを使用する代わりに、 SDK のインストール手順の生成) を使用して、Xcode のネイティブ Swift パッケージマネージャーを使用して個々のパッケージを追加します。 Xcode プロジェクトには、すべてのパッケージの依存関係が既に追加されています。 Xcode パッケージの依存関係 画面は次のようになります。
{zoomable="yes"}
Xcode では、 ファイル > パッケージを追加… をクリックしてパッケージを追加します。 次の表に、パッケージの追加に使用する URL へのリンクを示します。 また、リンクから、各パッケージの詳細情報にアクセスできます。
The AEPCore
, AEPServices
、および AEPIdentity
拡張機能は、Adobe Experience Platform SDK の基盤を表します。SDK を使用するすべてのアプリには、これらを含める必要があります。 これらのモジュールには、すべての SDK 拡張機能で必要となる機能とサービスの共通セットが含まれています。
AEPCore
には、Event Hub の実装が含まれています。 イベントハブは、アプリと SDK の間でイベントを配信する際に使用されるメカニズムです。 イベントハブは、拡張機能間でのデータの共有にも使用されます。AEPServices
は、ネットワーク、ディスクアクセス、データベース管理など、プラットフォームのサポートに必要な再利用可能な実装をいくつか提供します。AEPIdentity
は、Adobe Experience Platform ID サービスとの統合を実装しています。AEPSignal
は、マーケターがアプリに「シグナル」を送信して、外部の宛先にデータを送信したり、URL を開いたりできるAdobe Experience Platform SDK シグナル拡張機能を表します。AEPLifecycle
は、アプリケーションのインストールまたはアップグレード情報、アプリケーションの起動とセッション情報、デバイス情報、アプリケーション開発者が提供する追加のコンテキストデータなど、アプリケーションのライフサイクル指標を収集するのに役立つAdobe Experience Platform SDK の Lifecycle 拡張機能を表します。
AEPEdge
) を使用すると、モバイルアプリケーションからAdobe Edge Network にデータを送信できます。 この拡張機能を使用すると、Adobe Experience Cloud機能をより堅牢な方法で実装し、1 回のAdobe呼び出しで複数のネットワークソリューションを提供し、同時にこの情報をAdobe Experience Platformに転送できます。Edge Network モバイル拡張機能は、Adobe Experience Platform SDK の拡張機能で、
AEPCore
および AEPServices
イベント処理用の拡張機能、および AEPEdgeIdentity
id を取得するための拡張(ECID など)。AEPEdgeIdentity
) を使用すると、Adobe Experience Platform SDK と Edge Network 拡張機能を使用する際に、モバイルアプリケーションからユーザー ID データを処理できます。AEPConsent
) は、Adobe Experience Platform SDK と Edge Network 拡張機能を使用する際に、モバイルアプリケーションから同意設定の収集を有効にします。AEPUserProfile
) は、Adobe Experience Platform SDK のユーザープロファイルを管理する拡張機能です。AEPPlaces
) を使用すると、Places インターフェイスおよびAdobeデータ収集Adobeルールで定義された位置情報イベントを追跡できます。AEPMessaging
) を使用すると、プッシュ通知トークンとプッシュ通知クリックスルーフィードバックをAdobe Experience Platformに送信できます。AEPOptimize
) は、Adobe TargetまたはAdobe Journey OptimizerOffer decisioningを使用してAdobe Experience Platform Mobile SDK でリアルタイムのパーソナライゼーションワークフローを有効にする API を提供します。 必要な情報 AEPCore
および AEPEdge
パーソナライゼーションクエリイベントを Experience Edge ネットワークに送信する拡張機能です。AEPAssurance
) を使用して、モバイルアプリでデータを収集したりエクスペリエンスを提供する方法を調査、配達確認、シミュレーションおよび検証できます。 この拡張機能を使用すると、アプリでアシュランスを有効にできます。拡張機能のインポート
Xcode で、に移動します。 Luma > Luma > AppDelegate 次のインポートがこのソースファイルに含まれていることを確認します。
// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance
同じ操作を次にも実行します。 Luma > Luma > Utils > MobileSDK.
AppDelegate を更新
に移動します。 Luma > Luma > AppDelegate 」をクリックします。
-
次を
@AppStorage
値YOUR_ENVIRONMENT_ID_GOES_HERE
対象:environmentFileId
を、のタグから取得した開発環境ファイル ID 値に追加します。 SDK のインストール手順の生成.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
次のコードを
application(_, didFinishLaunchingWithOptions)
関数に置き換えます。code language-swift // Define extensions let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ] // Register extensions MobileCore.registerExtensions(extensions, { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)") MobileCore.configureWith(appId: self.environmentFileId) // set this to false or comment it when deploying to TestFlight (default is false), // set this to true when testing on your device. MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true]) if appState != .background { // only start lifecycle if the application is not in the background MobileCore.lifecycleStart(additionalContextData: nil) } // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(.unknown) })
上記のコードでは、次の処理をおこないます。
- 必要な拡張機能を登録します。
- タグプロパティ設定を使用するように MobileCore および他の拡張機能を設定します。
- デバッグログを有効にします。 詳細およびオプションについては、 Adobe Experience Platform Mobile SDK ドキュメント.
- ライフサイクル監視を開始します。 詳しくは、 ライフサイクル 詳しくは、チュートリアルの手順を参照してください。
- デフォルトの同意を不明に設定します。 詳しくは、 同意 詳しくは、チュートリアルの手順を参照してください。
MobileCore.configureWith(appId: self.environmentFileId)
と appId
基準: environmentFileId
作成するタグ環境(開発、ステージングまたは実稼動)から。次へ: アシュランスの設定