Assurance の設定

モバイルアプリでAdobe Experience Platform Assurance を設定する方法を説明します。

Assurance (旧称:プロジェクトグリフォン)は、モバイルアプリでデータを収集したりエクスペリエンスを提供したりする方法の検査、配達確認、シミュレートおよび検証を支援することを目的としています。

Assurance は、Adobe Experience Platform Mobile SDK で生成された生の SDK イベントを調べるのに役立ちます。 SDK で収集されたすべてのイベントは、検査に使用できます。 SDK イベントは、時間順に並べ替えられたリスト表示で読み込まれます。 各イベントには、詳細を提供する詳細ビューがあります。 SDK 設定、データ要素、共有状態、SDK 拡張機能のバージョンを参照するための追加のビューも提供されます。 Assurance について詳しくは、製品ドキュメントを参照してください。

前提条件

  • SDK がインストールおよび設定された状態で、アプリが正常にセットアップされました。

学習目標

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

  • 組織がアクセス権を持っていることを確認します(持っていない場合はリクエストします)。
  • ベース URL を設定します。
  • iOS固有の必須コードを追加します。
  • セッションに接続します。

アクセスを確認

組織が Assurance へのアクセス権を持っていることを確認します。 ユーザーとして、Adobe Experience Platformのプロファイルに追加される必要があります。 詳しくは、Assurance ガイドの ユーザーアクセスを参照してください。

実装方法

前のレッスンで完了した SDK の一般的なインストールに加えて、iOSでは、アプリの Assurance セッションを開始するために、以下の追加も必要です。

  1. Xcode のプロジェクトナビゲーターで Luma > Luma > SceneDelegate に移動します。

  2. 次のコードを func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext> に追加します。

    code language-swift
    // Called when the app in background is opened with a deep link.
    if let deepLinkURL = URLContexts.first?.url {
        // Start the Assurance session
        Assurance.startSession(url: deepLinkURL)
    }
    

    このコードは、アプリがバックグラウンドにあり、ディープリンクを使用して開かれたときに、アシュランスセッションを開始します。

詳しくは、 こちらを参照してください。

バンドル識別子の定義

アプリに一意のバンドル ID を指定する必要があります。

  1. Xcode でプロジェクトを開きます。

  2. プロジェクト ナビゲータで [Luma] を選択します。

  3. Luma ターゲットを選択します。

  4. 署名と機能」タブを選択します。

  5. バンドル識別子 を定義します。

    note important
    IMPORTANT
    各バンドル ID は一意である必要があるので、unique バンドル ID を使用し、com.adobe.luma.tutorial.swiftui バンドル ID を置き換えてください。 通常は、バンドル ID 文字列(com.organization.brand.uniqueidentifier など)に逆 DNS 形式を使用します。 たとえば、このチュートリアルの完成バージョンでは com.adobe.luma.tutorial.swiftui を使用します。

    Xcode 署名機能 {modal="regular"}

ベース URL の設定

  1. Xcode のプロジェクトに移動します。

  2. プロジェクト ナビゲータで [Luma] を選択します。

  3. Luma ターゲットを選択します。

  4. 情報」タブを選択します。

  5. ベース URL を追加するには、下にスクロールして URL タイプ を表示し、「+」ボタンを選択します。

  6. 識別子 を任意のバンドル識別子に設定し、任意の URL スキーム を設定します。

    assurance url

    note important
    IMPORTANT
    各バンドル ID は一意である必要があるので、unique バンドル ID を使用し、com.adobe.luma.tutorial.swiftui バンドル ID を置き換えてください。 通常は、バンドル ID 文字列(com.organization.brand.uniqueidentifier など)に逆 DNS 形式を使用します。 バンドル識別子の定義で使用したのと同じバンドル識別子を使用できます。
    同様に、一意の URL スキームを使用し、既に提供されている lumatutorialswiftui を一意の URL スキームに置き換えます。

iOSの URL スキームについて詳しくは、Appleのドキュメントを参照してください。

Assurance は、ブラウザーまたは QR コードを介して URL を開くことで機能します。 この URL は、アプリを開くベース URL で始まり、追加のパラメーターが含まれています。 これらの一意のパラメーターは、セッションへの接続に使用されます。

セッションへの接続

Xcode で:

  1. Play を使用して、シミュレータまたは Xcode の物理デバイスでアプリを構築または再構築して実行します。

    note tip
    TIP
    必要に応じて、特に予期しない結果が発生した場合に、ビルドを「クリーンアップ」する必要がある場合があります。 これを行うには、Xcode 製品 メニューから「ビルドフォルダーをクリーンアップ…」を選択します。
  2. Luma アプリが場所を使用することを許可する ダイアログで、「アプリの使用中に許可 を選択し す。

    {width="300"}

  3. Luma アプリ」が通知を送信したい ダイアログで、「許可」を選択します。

    {width="300"}

  4. 続行…」を選択し、アプリがアクティビティを追跡できるようにします。

    {width="300"}

  5. 「Luma アプリ」が他社のアプリや web サイトをまたいだアクティビティを追跡することを許可する」ダイアログで許可」を選択します。

    {width="300"}

ブラウザーで以下を実行します。

  1. データ収集 UI に移動します。

  2. 左パネルから「Assurance」を選択します。

  3. セッションを作成 を選択します。

  4. 開始 を選択します。

  5. Luma Mobile App Session などの セッション名ベース URL を指定します。これは、Xcode で入力した URL スキームであり、:// の後に続きます。例:lumatutorialswiftui://

  6. 次へ」を選択します。
    assurance 作成セッション

  7. 新規セッションを作成 モーダルダイアログで、次の操作を行います。

    物理デバイスを使用している場合:

    • QR コードをスキャン」を選択します。 アプリを開くには、物理デバイスのカメラを使用して QR コードをスキャンし、リンクをタップします。

      assurance qa コード

    シミュレーターを使用する場合:

    1. リンクをコピー を選択します。

    2. コピー を使用してディープリンクをコピーし、ディープリンクを使用してシミュレーターの Safari でアプリを開きます。

      アシュランスコピーリンク

  8. アプリが読み込まれると、手順 7 に示すように、PIN を入力するよう求めるモーダルダイアログが表示されます。

    {width="300"}

    PIN を入力し、「接続」を選択します。

  9. 接続に成功した場合は、次のように表示されます。

    • Assurance アイコンがアプリの上に浮かんでいます。

      {width="300"}

    • Assurance UI を使用して行われる次を示すExperience Cloudの更新。

      1. アプリから発生するエクスペリエンスイベント。

      2. 選択したイベントの詳細。

      3. デバイスとタイムライン。

        assurance イベント

課題が発生した場合は、 技術ドキュメントおよび 一般ドキュメントを確認してください。

拡張機能の検証

アプリが最新の拡張機能を使用しているかどうかを確認するには:

  1. 設定 を選択します。

  2. 123 拡張機能バージョン ​ の場合は ![ 追加] を選択します。

  3. 保存」を選択します。

    拡張機能のバージョンの設定

  4. 123 拡張機能のバージョン を選択すると、使用可能な最新の拡張機能と、お使いのバージョンのアプリで使用されている拡張機能の概要が表示されます。

    拡張機能のバージョン

  5. 拡張機能のバージョン(例:Messaging および Optimize)を更新するには、パッケージの依存関係 (例:AEPMessaging)からパッケージ(拡張機能)を選択し、コンテキストメニューから「パッケージを更新」を選択します。 Xcode はパッケージの依存関係を更新します。

NOTE
Xcode で拡張機能(パッケージ)を更新したら、現在のセッションを閉じて削除し、 セッションへの接続および 拡張機能の検証のすべての手順を繰り返して、Assurance が新しい Assurance セッションで正しい拡張機能を適切に報告していることを確認します。
SUCCESS
これで、チュートリアルの残りの部分で Assurance を使用するようにアプリを設定しました。
Adobe Experience Platform Mobile SDK の学習に時間を費やしていただき、ありがとうございます。 ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League コミュニティ ディスカッションの投稿でお知らせください

次のトピック:同意の実装

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