場所を使用

アプリで Places ジオロケーションサービスを使用する方法について説明します。

Adobe Experience Platform Data Collection Places Service は、位置認識を持つモバイルアプリで位置コンテキストを理解できる位置情報サービスです。 このサービスは、柔軟な目標地点 (POI) データベースに加えて、豊富で使いやすい SDK インターフェイスを使用しています。

前提条件

  • パッケージの依存関係はすべて、Xcode プロジェクトに配置されます。
  • AppDelegate に登録された拡張機能。
  • 開発 appId を使用するように MobileCore を設定しました。
  • SDK が読み込まれました。
  • 上記の変更を含むアプリが正常にビルドされ、実行されました。

学習内容

このレッスンでは、次の操作を行います

  • Places サービスで目標地点を定義する方法を説明します。
  • Places 拡張機能でタグプロパティを更新します。
  • スキーマを更新して位置情報イベントをキャプチャします。
  • アシュランスで設定を検証します。
  • アプリを更新して、Places 拡張機能を登録します。
  • アプリに Places サービスから位置情報トラッキングを実装します。

セットアップ

Places サービスをアプリ内および Mobile SDK 内で動作させるには、いくつかの設定をおこなう必要があります。

場所を定義

Places サービスで目標地点を定義します。

  1. データ収集 UI で、「 」を選択します。 場所.
  2. 選択 その他 .
  3. コンテキストメニューから、「 」を選択します。 ライブラリを管理.
    ライブラリの管理
  4. Adobe Analytics の ライブラリを管理 ダイアログ、選択 新規.
  5. Adobe Analytics の ライブラリを作成 ダイアログを入力 名前 ​例: Luma.
  6. 選択 確認.
    ライブラリを作成
  7. を閉じるには、以下を実行します。 ライブラリを管理 ダイアログ、選択 閉じる.
  8. 戻る POI 管理 ​を選択します。 POI をインポート.
  9. 選択 開始 (内) 場所を読み込み ダイアログ。
  10. 選択 Luma ライブラリのリストから、
  11. 次へ」を選択します。
    ライブラリを選択
  12. をダウンロードします。 Luma POI ZIP ファイル コンピュータ上の場所に抽出します。
  13. Adobe Analytics の 場所を読み込み ダイアログで、抽出した luma_pois.csv ~について申し出る CSV ファイルを選択 — ファイルをドラッグ&ドロップします. 次のようになります。 検証成功 - CSV ファイルが正常に検証されました.
  14. 選択 読み込みを開始. 次のようになります。 成功 - 6 個の新しい POI が正常に追加されました.
  15. 完了」を選択します。
  16. In POI 管理 ​を探すと、6 つの新しい Luma ストアがリストに追加されています。 切り替え可能な リスト リストと マップ マップビュー。
    場所リスト .

Places 拡張機能のインストール

  1. に移動します。 タグ モバイルタグプロパティを見つけて、プロパティを開きます。

  2. 選択 拡張機能.

  3. 選択 カタログ.

  4. を検索します。 場所 拡張子。

  5. 拡張機能をインストールします。

    判定拡張機能の追加

  6. Adobe Analytics の 拡張機能のインストール ダイアログ:

    1. 選択 Luma から ライブラリを選択 リスト。

    2. 作業用ライブラリが選択されていることを確認します(例: )。 初期ビルド.

    3. 選択 ライブラリに保存してビルドする から ライブラリに保存.

      Places 拡張機能のインストール .

  7. ライブラリが再構築されました。

スキーマの検証

スキーマが スキーマを作成は、POI および位置情報データを収集するために必要なフィールドグループとクラスを組み込みます。

  1. データ収集インターフェイスに移動して、「 」を選択します。 スキーマ をクリックします。
  2. 選択 参照 上部のバーから。
  3. スキーマを選択して開きます。
  4. スキーマエディターで、「 」を選択します。 消費者エクスペリエンスイベント.
  5. 次のように表示されます。 placeContext オブジェクトを、POI の操作と位置情報データを取り込むためのオブジェクトとフィールドで指定します。
    スキーマの場所 .

タグプロパティを更新する

タグの Places 拡張機能は、位置情報イベントを監視する機能を提供し、これらのイベントに基づいてアクションをトリガー化できます。 この機能を使用して、アプリケーションに実装する必要のある API コーディングを最小限に抑えることができます。

データ要素

最初に複数のデータ要素を作成します。

  1. データ収集 UI でタグプロパティに移動します。

  2. 選択 データ要素 をクリックします。

  3. データ要素を追加」を選択します。

  4. Adobe Analytics の データ要素を作成 画面(例: ) Name - Entered.

  5. 選択 場所 から 拡張 リスト。

  6. 選択 名前 から データ要素タイプ リスト。

  7. 選択 現在の POI underthen TARGET.

  8. 選択 ライブラリに保存.
    データ要素

  9. 次の表の情報を使用して手順 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

    次のリストのデータ要素が必要です。

    データ要素のリスト

ルール

次に、これらのデータ要素を使用するルールを定義します。

  1. タグプロパティで、「 」を選択します。 ルール をクリックします。

  2. 選択 ルールを追加.

  3. Adobe Analytics の ルールを作成 画面で、ルールの名前を入力します。例: POI - Entry.

  4. 選択 追加 underthen イベント.

    1. 選択 場所 から 拡張 リストと選択 POI を入力 から イベントタイプ リスト。

    2. 変更を保持」を選択します。

      タグイベント .

  5. 選択 追加 underthen アクション.

    1. 選択 Mobile Core から 拡張 リスト、選択 データを添付 から アクションタイプ リスト。 このアクションは、ペイロードデータを添付します。

    2. 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 のデータ要素プレースホルダー値を選択するには、 データ . ポップアップダイアログでは、作成したデータ要素を選択できます。

    3. 変更を保持」を選択します。

      タグアクション

  6. 選択 追加 の横 Mobile Core — データを添付 アクション。

    1. 選択 Adobe Experience Platform Edge Network から 拡張 リストと選択 イベントを Edge ネットワークに転送する. このアクションは、イベントと追加のペイロードデータが Platform Edge ネットワークに確実に転送されるようにします。
    2. 変更を保持」を選択します。
  7. ルールを保存するには、「 ライブラリに保存.

    ルール

別のルールを作成しましょう

  1. Adobe Analytics の ルールを作成 画面で、ルールの名前を入力します。例: POI - Exit.

  2. 選択 追加 underthen イベント.

    1. 選択 場所 から 拡張 リストと選択 出口 POI から イベントタイプ リスト。
    2. 変更を保持」を選択します。
  3. 選択 追加 underthen アクション.

    1. 選択 Mobile Core から 拡張 リスト、選択 データを添付 から アクションタイプ リスト。

    2. 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%%}"
                      }
                  }
              }
          }
      }
      
    3. 変更を保持」を選択します。

  4. 選択 追加 の横 Mobile Core — データを添付 アクション。

    1. 選択 Adobe Experience Platform Edge Network から 拡張 リストと選択 イベントを Edge ネットワークに転送する.
    2. 変更を保持」を選択します。
  5. ルールを保存するには、「 ライブラリに保存.

    ルール

タグ内のすべての変更が確実に公開されるようにするには

  1. 選択 初期ビルド をビルドするライブラリとして使用します。
  2. 選択 ビルド.
    ライブラリの作成

アシュランスでの設定の検証

アシュランスで設定を検証するには、次の手順に従います。

  1. Assurance UI に移動します。
  2. 左側のパネルでまだ使用できない場合は、「 」を選択します。 設定 左側のパネルで、「 」を選択します。 追加 次の イベント および マップとシミュレーション underthen PLACES SERVICE.
  3. 保存」を選択します。
  4. 選択 マップとシミュレーション をクリックします。
  5. マップを POI の 1 つの場所に移動します。
  6. 選択 ギア POI の負荷をシミュレートします。 POI は、円とピンを使用して識別されます。
  7. POI を選択します。
  8. ポップアップから、 ギア エントリイベントをシミュレート.
    エントリイベントをシミュレート
  9. 選択 イベント 左側のパネルから、シミュレーションしたイベントが表示されます。
    AJO 判定の検証

アプリに Places を実装します

前のレッスンで説明したように、モバイルタグ拡張機能のインストールでは設定のみが提供されます。 次に、Places SDK をインストールして登録する必要があります。 これらの手順が明確でない場合は、 SDK のインストール 」セクションに入力します。

NOTE
以下を完了した場合、 SDK のインストール 」セクションに移動した場合は、Places SDK が既にインストールされているので、この手順をスキップできます。
  1. Xcode で、 AEP Places は、パッケージの依存関係にパッケージのリストに追加されます。 詳しくは、 Swift Package Manager.

  2. に移動します。 Luma > Luma > AppDelegate 」をクリックします。

  3. 確認 AEPPlaces は、インポートのリストの一部です。

    code language-swift
    import AEPPlaces
    
  4. 確認 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
    ]
    
  5. に移動します。 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 サービスに通信します。

  6. に移動します。 Luma > Luma > Views > Location > GeofenceSheet Xcode のプロジェクトナビゲーター内。

    1. 「入力」ボタンに、次のコードを入力します。
    code language-swift
    // Simulate geofence entry event
    Task {
        await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
    }
    
    1. 「終了」ボタンに、次のコードを入力します。
    code language-swift
    // Simulate geofence exit event
    Task {
        await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region)
    }
    

アプリを使用した検証

  1. デバイスまたはシミュレーターでアプリを開きます。

  2. 次に移動: 場所 タブをクリックします。

  3. マップを移動(ドラッグ)して、青い中央の円が POI の 1 つ(例:ロンドン)の上にあることを確認します。

  4. タップ+--------------+ | img-md | +==============+ | w-20 | +--------------+ | | +--------------+カテゴリと名前が、ピン付きの赤い位置のラベルに表示されるまでです。

  5. POI のラベルをタップすると、 近くの POI シート。

    img-md
    w-300
  6. を押します。 入口 または 終了 ボタンを使用して、アプリからのジオフェンスエントリおよびジオフェンスの終了イベントをシミュレートします。

    img-md
    w-300
  7. Assurance UI にイベントが表示されます。

次の手順

これで、アプリ内の位置情報機能に機能を追加するためのすべてのツールが用意できました。 イベントを Edge ネットワークに転送したとき、アプリを次のように設定したら、 Experience Platformに設定すると、アプリで使用されているプロファイルに対してエクスペリエンスイベントが表示されます。

このチュートリアルのJourney Optimizerの節では、エクスペリエンスイベントを使用してジャーニーをトリガー化できます ( プッシュ通知 および アプリ内メッセージ (Journey Optimizer))。 例えば、アプリユーザーが物理ストアのジオフェンスに入ったときに、製品プロモーションを含むプッシュ通知をアプリユーザーに送信する通常の例です。

アプリの機能の実装は、主に Places サービス、タグプロパティで定義したデータ要素およびルールによって実行されています。 そのため、アプリ内のコードを最小限に抑えます。 または、 Edge.sendEvent API( イベント (詳しくは、を参照)、 placeContext オブジェクト。

SUCCESS
これで、Experience PlatformMobile SDK の Places 拡張機能を使用して、アプリの位置情報サービスを有効にしました。
Adobe Experience Platform Mobile SDK の学習に時間を割いていただき、ありがとうございます。 ご質問がある場合、一般的なフィードバックを共有する場合、または今後のコンテンツに関する提案がある場合は、このドキュメントで共有します Experience Leagueコミュニティディスカッション投稿.

次へ: データをAdobe Analyticsにマッピング

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b