場所を使用
アプリで Places ジオロケーションサービスを使用する方法について説明します。
Adobe Experience Platform Data Collection Places Service は、位置認識を持つモバイルアプリで位置コンテキストを理解できる位置情報サービスです。 このサービスは、柔軟な目標地点 (POI) データベースに加えて、豊富で使いやすい SDK インターフェイスを使用しています。
前提条件
- パッケージの依存関係はすべて、Xcode プロジェクトに配置されます。
- AppDelegate に登録された拡張機能。
- 開発 appId を使用するように MobileCore を設定しました。
- SDK が読み込まれました。
- 上記の変更を含むアプリが正常にビルドされ、実行されました。
学習内容
このレッスンでは、次の操作を行います
- Places サービスで目標地点を定義する方法を説明します。
- Places 拡張機能でタグプロパティを更新します。
- スキーマを更新して位置情報イベントをキャプチャします。
- アシュランスで設定を検証します。
- アプリを更新して、Places 拡張機能を登録します。
- アプリに Places サービスから位置情報トラッキングを実装します。
セットアップ
Places サービスをアプリ内および Mobile SDK 内で動作させるには、いくつかの設定をおこなう必要があります。
場所を定義
Places サービスで目標地点を定義します。
- データ収集 UI で、「 」を選択します。 場所.
- 選択 .
- コンテキストメニューから、「 」を選択します。 ライブラリを管理.
- Adobe Analytics の ライブラリを管理 ダイアログ、選択 新規.
- Adobe Analytics の ライブラリを作成 ダイアログを入力 名前 例:
Luma
. - 選択 確認.
- を閉じるには、以下を実行します。 ライブラリを管理 ダイアログ、選択 閉じる.
- 戻る POI 管理 を選択します。 POI をインポート.
- 選択 開始 (内) 場所を読み込み ダイアログ。
- 選択 Luma ライブラリのリストから、
- 「次へ」を選択します。
- をダウンロードします。 Luma POI ZIP ファイル コンピュータ上の場所に抽出します。
- Adobe Analytics の 場所を読み込み ダイアログで、抽出した
luma_pois.csv
~について申し出る CSV ファイルを選択 — ファイルをドラッグ&ドロップします. 次のようになります。 検証成功 - CSV ファイルが正常に検証されました. - 選択 読み込みを開始. 次のようになります。 成功 - 6 個の新しい POI が正常に追加されました.
- 「完了」を選択します。
- In POI 管理 を探すと、6 つの新しい Luma ストアがリストに追加されています。 切り替え可能な
リストと
マップビュー。
.
Places 拡張機能のインストール
-
に移動します。 タグ モバイルタグプロパティを見つけて、プロパティを開きます。
-
選択 拡張機能.
-
選択 カタログ.
-
を検索します。 場所 拡張子。
-
拡張機能をインストールします。
-
Adobe Analytics の 拡張機能のインストール ダイアログ:
-
選択 Luma から ライブラリを選択 リスト。
-
作業用ライブラリが選択されていることを確認します(例: )。 初期ビルド.
-
選択 ライブラリに保存してビルドする から ライブラリに保存.
.
-
-
ライブラリが再構築されました。
スキーマの検証
スキーマが スキーマを作成は、POI および位置情報データを収集するために必要なフィールドグループとクラスを組み込みます。
- データ収集インターフェイスに移動して、「 」を選択します。 スキーマ をクリックします。
- 選択 参照 上部のバーから。
- スキーマを選択して開きます。
- スキーマエディターで、「 」を選択します。 消費者エクスペリエンスイベント.
- 次のように表示されます。 placeContext オブジェクトを、POI の操作と位置情報データを取り込むためのオブジェクトとフィールドで指定します。
.
タグプロパティを更新する
タグの Places 拡張機能は、位置情報イベントを監視する機能を提供し、これらのイベントに基づいてアクションをトリガー化できます。 この機能を使用して、アプリケーションに実装する必要のある API コーディングを最小限に抑えることができます。
データ要素
最初に複数のデータ要素を作成します。
-
データ収集 UI でタグプロパティに移動します。
-
選択 データ要素 をクリックします。
-
「データ要素を追加」を選択します。
-
Adobe Analytics の データ要素を作成 画面(例: )
Name - Entered
. -
選択 場所 から 拡張 リスト。
-
選択 名前 から データ要素タイプ リスト。
-
選択 現在の POI underthen TARGET.
-
選択 ライブラリに保存.
-
次の表の情報を使用して手順 4 ~ 8 を繰り返し、追加のデータ要素を作成します。
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 名前 拡張機能 データ要素タイプ TARGET Name - Exited
Places 名前 前回の離脱 POI Category - Current
Places カテゴリ 現在の POI Category - Exited
Places カテゴリ 前回の離脱 POI City - Current
Places 市区町村 現在の POI City - Exited
Places 市区町村 前回の離脱 POI 次のリストのデータ要素が必要です。
ルール
次に、これらのデータ要素を使用するルールを定義します。
-
タグプロパティで、「 」を選択します。 ルール をクリックします。
-
選択 ルールを追加.
-
Adobe Analytics の ルールを作成 画面で、ルールの名前を入力します。例:
POI - Entry
. -
選択 underthen イベント.
-
選択 場所 から 拡張 リストと選択 POI を入力 から イベントタイプ リスト。
-
「変更を保持」を選択します。
.
-
-
選択 underthen アクション.
-
選択 Mobile Core から 拡張 リスト、選択 データを添付 から アクションタイプ リスト。 このアクションは、ペイロードデータを添付します。
-
Adobe Analytics の JSON ペイロード、次のペイロードを貼り付けます。
code language-json { "xdm": { "eventType": "location.entry", "placeContext": { "geo": { "city": "{%%City - Current%%}" }, "POIinteraction": { "poiDetail": { "name": "{%%Name - Current%%}", "category": "{%%Category - Current%%}" }, "poiEntries": { "value": 1 } } } } }
また、
{%% ... %%}
JSON のデータ要素プレースホルダー値を選択するには、 . ポップアップダイアログでは、作成したデータ要素を選択できます。 -
「変更を保持」を選択します。
-
-
選択 の横 Mobile Core — データを添付 アクション。
- 選択 Adobe Experience Platform Edge Network から 拡張 リストと選択 イベントを Edge ネットワークに転送する. このアクションは、イベントと追加のペイロードデータが Platform Edge ネットワークに確実に転送されるようにします。
- 「変更を保持」を選択します。
-
ルールを保存するには、「 ライブラリに保存.
別のルールを作成しましょう
-
Adobe Analytics の ルールを作成 画面で、ルールの名前を入力します。例:
POI - Exit
. -
選択 underthen イベント.
- 選択 場所 から 拡張 リストと選択 出口 POI から イベントタイプ リスト。
- 「変更を保持」を選択します。
-
選択 underthen アクション.
-
選択 Mobile Core から 拡張 リスト、選択 データを添付 から アクションタイプ リスト。
-
Adobe Analytics の JSON ペイロード、次のペイロードを貼り付けます。
code language-json { "xdm": { "eventType": "location.exit", "placeContext": { "geo": { "city": "{%%City - Exited%%}" }, "POIinteraction": { "poiExits": { "value": 1 }, "poiDetail": { "name": "{%%Name - Exited%%}", "category": "{%%Category - Exited%%}" } } } } }
-
「変更を保持」を選択します。
-
-
選択 の横 Mobile Core — データを添付 アクション。
- 選択 Adobe Experience Platform Edge Network から 拡張 リストと選択 イベントを Edge ネットワークに転送する.
- 「変更を保持」を選択します。
-
ルールを保存するには、「 ライブラリに保存.
タグ内のすべての変更が確実に公開されるようにするには
- 選択 初期ビルド をビルドするライブラリとして使用します。
- 選択 ビルド.
アシュランスでの設定の検証
アシュランスで設定を検証するには、次の手順に従います。
- Assurance UI に移動します。
- 左側のパネルでまだ使用できない場合は、「 」を選択します。 設定 左側のパネルで、「 」を選択します。 次の イベント および マップとシミュレーション underthen PLACES SERVICE.
- 「保存」を選択します。
- 選択 マップとシミュレーション をクリックします。
- マップを POI の 1 つの場所に移動します。
- 選択 POI の負荷をシミュレートします。 POI は、円とピンを使用して識別されます。
- POI を選択します。
- ポップアップから、
エントリイベントをシミュレート.
- 選択 イベント 左側のパネルから、シミュレーションしたイベントが表示されます。
アプリに Places を実装します
前のレッスンで説明したように、モバイルタグ拡張機能のインストールでは設定のみが提供されます。 次に、Places SDK をインストールして登録する必要があります。 これらの手順が明確でない場合は、 SDK のインストール 」セクションに入力します。
-
Xcode で、 AEP Places は、パッケージの依存関係にパッケージのリストに追加されます。 詳しくは、 Swift Package Manager.
-
に移動します。 Luma > Luma > AppDelegate 」をクリックします。
-
確認
AEPPlaces
は、インポートのリストの一部です。code language-swift import AEPPlaces
-
確認
Places.self
は、登録する拡張機能の配列の一部です。code language-swift 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 ]
-
に移動します。 Luma > Luma > Utils > MobileSDK Xcode プロジェクトナビゲーターで、
func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async
関数に置き換えます。 次のコードを追加します。code language-swift // Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)
この
Places.processRegionEvent
API は、位置情報を Places サービスに通信します。 -
に移動します。 Luma > Luma > Views > Location > GeofenceSheet Xcode のプロジェクトナビゲーター内。
- 「入力」ボタンに、次のコードを入力します。
code language-swift // Simulate geofence entry event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region) }
- 「終了」ボタンに、次のコードを入力します。
code language-swift // Simulate geofence exit event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region) }
アプリを使用した検証
-
デバイスまたはシミュレーターでアプリを開きます。
-
次に移動: 場所 タブをクリックします。
-
マップを移動(ドラッグ)して、青い中央の円が POI の 1 つ(例:ロンドン)の上にあることを確認します。
-
タップ+--------------+ | img-md | +==============+ | w-20 | +--------------+ | | +--------------+カテゴリと名前が、ピン付きの赤い位置のラベルに表示されるまでです。
-
POI のラベルをタップすると、 近くの POI シート。
img-md w-300 -
を押します。 入口 または 終了 ボタンを使用して、アプリからのジオフェンスエントリおよびジオフェンスの終了イベントをシミュレートします。
img-md w-300 -
Assurance UI にイベントが表示されます。
次の手順
これで、アプリ内の位置情報機能に機能を追加するためのすべてのツールが用意できました。 イベントを Edge ネットワークに転送したとき、アプリを次のように設定したら、 Experience Platformに設定すると、アプリで使用されているプロファイルに対してエクスペリエンスイベントが表示されます。
このチュートリアルのJourney Optimizerの節では、エクスペリエンスイベントを使用してジャーニーをトリガー化できます ( プッシュ通知 および アプリ内メッセージ (Journey Optimizer))。 例えば、アプリユーザーが物理ストアのジオフェンスに入ったときに、製品プロモーションを含むプッシュ通知をアプリユーザーに送信する通常の例です。
アプリの機能の実装は、主に Places サービス、タグプロパティで定義したデータ要素およびルールによって実行されています。 そのため、アプリ内のコードを最小限に抑えます。 または、 Edge.sendEvent
API( イベント (詳しくは、を参照)、 placeContext
オブジェクト。