アシュランスの設定

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

アシュランス(正式には Project Griffon と呼ばれます)は、データ収集やモバイルアプリでのエクスペリエンス提供の方法を調査、配達確認、シミュレーション、検証するのに役立つように設計されています。

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

前提条件

  • SDK を使用したアプリが正常にセットアップされ、設定されました。

学習内容

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

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

アクセスを確認

組織がアシュランスにアクセスできることを確認します。 ユーザーは、Adobe Experience Platformのプロファイルに追加される必要があります。 詳しくは、 ユーザーアクセス (アシュランスガイド)を参照してください。

実装方法

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

  1. に移動します。 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)
    }
    

    このコードは、アプリがバックグラウンドになっていて、ディープリンクを使用して開いたときに、保証セッションを開始します。

詳細はこちらをご覧ください ここ.

バンドル識別子を定義

アプリに一意のバンドル識別子を提供する必要があります。

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

  2. 選択 Luma をクリックします。

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

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

  5. を定義 バンドル識別子.

    note important
    IMPORTANT
    必ず ユニーク バンドル識別子を置き換えます。 com.adobe.luma.tutorial.swiftui バンドル識別子。各バンドル識別子は一意である必要があります。 通常、バンドル ID 文字列には逆引き DNS 形式を使用します ( 例: com.organization.brand.uniqueidentifier. このチュートリアルの完成版(例: )は、を使用します。 com.adobe.luma.tutorial.swiftui.

    Xcode 署名機能 {zoomable="yes"}

ベース URL の設定

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

  2. 選択 Luma をクリックします。

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

  4. を選択します。 情報 タブをクリックします。

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

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

    アシュアランス url

    note important
    IMPORTANT
    必ず ユニーク バンドル識別子を置き換えます。 com.adobe.luma.tutorial.swiftui バンドル識別子。各バンドル識別子は一意である必要があります。 通常、バンドル ID 文字列には逆引き DNS 形式を使用します ( 例: com.organization.brand.uniqueidentifier. 以前に使用したのと同じバンドル識別子を使用できます。 バンドル識別子を定義.
    同様に、一意の URL スキームを使用し、既に指定されている lumatutorialswiftui を使用して、一意の URL スキームを設定します。

iOSでの URL スキームについて詳しくは、 Appleドキュメント.

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

セッションへの接続

Xcode の場合:

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

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

    img-md
    w-300
  3. Adobe Analytics の 「Luma アプリ」が通知を送信します ダイアログ、選択 許可.

    img-md
    w-300
  4. 選択 続行… :アプリがアクティビティを追跡できるようにします。

    img-md
    w-300
  5. Adobe Analytics の 「Luma アプリ」で、他の会社のアプリや Web サイトをまたいでアクティビティを追跡できるようにします ダイアログ、選択 許可.

    img-md
    w-300

ブラウザーで、以下の操作を実行します。

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

  2. 選択 アシュランス をクリックします。

  3. 選択 セッションを作成.

  4. 選択 開始.

  5. 次を提供: セッション名 例: Luma Mobile App Session そして ベース URL:Xcode で入力した URL スキームで、その後に :// 例: lumatutorialswiftui://

  6. 次へ」を選択します。
    アシュランス作成セッション

  7. Adobe Analytics の 新しいセッションを作成 モーダルダイアログ:

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

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

      アシュランス qa コード

    シミュレーターを使用している場合は、次の手順に従います。

    1. 選択 リンクをコピー.

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

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

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

    img-md
    w-300

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

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

    • アプリの上に浮かぶアシュランスアイコン。

      img-md
      w-300
    • Assurance UI でのExperience Cloudの更新で、次の内容が表示されます。

      1. アプリからのエクスペリエンスイベント。

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

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

        アシュランスイベント

問題が発生した場合は、 技術 and general documentation.

拡張機能の検証

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

  1. 選択 設定.

  2. 選択 追加 対象: 123 拡張機能のバージョン.

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

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

  4. 選択 123 拡張機能のバージョン を参照して、利用可能な最新の拡張機能と、アプリのバージョンで使用される拡張機能の概要を確認してください。

    拡張機能のバージョン

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

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

次へ: 同意の実装

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