イベントデータの追跡

モバイルアプリでイベントをトラッキングする方法を説明します。

Edge Network拡張機能は、エクスペリエンスイベントを Platform Edge Networkに送信する API を提供します。 エクスペリエンスイベントは、XDM ExperienceEvent スキーマ定義に準拠するデータを含むオブジェクトです。 より簡単に言えば、人物がモバイルアプリで何をしているかを取り込みます。 Platform Edge Networkによってデータが受信されると、Adobe AnalyticsやExperience Platformなどのデータストリームに設定されたアプリケーションやサービスに転送できます。 エクスペリエンスイベントについて詳しくは、製品ドキュメントを参照してください。

前提条件

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

学習目標

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

  • スキーマに基づいて XDM データを構造化する方法を理解します。
  • 標準フィールドグループに基づいて XDM イベントを送信します。
  • カスタムフィールドグループに基づいて XDM イベントを送信します。
  • XDM 購入イベントを送信します。
  • Assurance で検証します。

エクスペリエンスイベントの作成

Adobe Experience Platform Edge拡張機能は、以前に定義された XDM スキーマに従うイベントをAdobe Experience Platform Edge Networkに送信できます。

プロセスは次のようになります。

  1. 追跡しようとしているモバイルアプリインタラクションを特定します。

  2. スキーマをレビューし、適切なイベントを特定します。

  3. スキーマをレビューし、イベントの説明に使用するその他のフィールドを特定します。

  4. データオブジェクトを構築し、入力します。

  5. イベントを作成して送信します。

  6. 検証。

標準フィールドグループ

標準フィールドグループの場合、プロセスは次のようになります。

  • スキーマで、収集しようとしているイベントを識別します。 この例では、商品表示(productViews)イベントなど、コマースエクスペリエンスイベントを追跡します。

    製品表示スキーマ

  • アプリでエクスペリエンスイベントデータを含むオブジェクトを作成するには、次のようなコードを使用します。

    code language-swift
    var xdmData: [String: Any] = [
        "eventType": "commerce.productViews",
        "commerce": [
            "productViews": [
              "value": 1
            ]
        ]
    ]
    
    • eventType:発生したイベントを表し、可能な場合は 既知の値を使用します。
    • commerce.productViews.value:イベントの数値またはブール値。 ブール値(Adobe Analyticsでは「カウンター」)の場合、値は常に 1 に設定されます。 数値イベントまたは通貨イベントの場合、値は 1 を超える場合があります。
  • スキーマで、コマース製品表示イベントに関連付けられている追加データを特定します。 この例では、productListItems を含めます。これは、コマース関連のイベントで使用されるフィールドの標準セットです。

    製品リスト項目スキーマ

    • productListItems は配列なので、複数の製品を指定できます。
  • このデータを追加するには、xdmData オブジェクトを展開して補足データを含めます。

    code language-swift
    var xdmData: [String: Any] = [
        "eventType": "commerce.productViews",
            "commerce": [
            "productViews": [
                "value": 1
            ]
        ],
        "productListItems": [
            [
                "name":  productName,
                "SKU": sku,
                "priceTotal": priceString,
                "quantity": 1
            ]
        ]
    ]
    
  • これで、このデータ構造を使用して ExperienceEvent を作成できます。

    code language-swift
    let productViewEvent = ExperienceEvent(xdm: xdmData)
    
  • sendEvent API を使用して、イベントとデータを Platform Edge Networkに送信します。

    code language-swift
    Edge.sendEvent(experienceEvent: productViewEvent)
    

Edge.sendEvent API は AEP Mobile SDK で、MobileCore.trackAction および MobileCore.trackState API 呼び出しと同等です。 詳しくは、Analytics モバイル拡張機能からAdobe Experience Platform Edge Networkへの移行を参照してください。

次に、このコードを Xcode プロジェクトに実際に実装します。
アプリに様々なコマース製品関連のアクションがあり、ユーザーが実行したこれらのアクションに基づいてイベントを送信する場合:

  • 表示:ユーザーが特定の製品を表示すると発生します。
  • 買い物かごに追加:ユーザーがタップしたとき 製品の詳細画面に {width="20"} 示
  • 後で使用するために保存:ユーザーがタップした場合 製品の詳細画面に {width="15"} 示
  • 購入:ユーザーがタップした場合 製品の詳細画面に {width="20"} 示されます。

コマース関連のエクスペリエンスイベントの送信を再利用可能な方法で実装するには、専用の関数を使用します。

  1. Xcode プロジェクトナビゲーターで Luma/Luma/Utils/MobileSDK に移動し、func sendCommerceExperienceEvent(commerceEventType: String, product: Product) 関数に以下を追加します。

    code language-swift
    // Set up a data dictionary, create an experience event and send the event.
    let xdmData: [String: Any] = [
        "eventType": "commerce." + commerceEventType,
        "commerce": [
            commerceEventType: [
                "value": 1
            ]
        ],
        "productListItems": [
            [
                "name": product.name,
                "priceTotal": product.price,
                "SKU": product.sku
            ]
        ]
    ]
    
    let commerceExperienceEvent = ExperienceEvent(xdm: xdmData)
    Edge.sendEvent(experienceEvent: commerceExperienceEvent)
    

    この関数は、コマースエクスペリエンスイベントタイプと製品をパラメーターとして受け取ります。

    • 関数のパラメーターを使用して、XDM ペイロードをディクショナリとして設定します。
    • 辞書を使用してエクスペリエンスイベントを設定します。
    • Edge.sendEvent API を使用してエクスペリエンスイベントを送信します。
  2. Xcode プロジェクトナビゲーターで Luma/Luma/Views/Products/ProductView に移動し、sendCommerceExperienceEvent 関数に様々な呼び出しを追加します。

    1. .task のモディファイヤで、ATTrackingManager.trackingAuthorizationStatus のクロージャ内に配置します。 この .task 修飾子は、製品ビューが初期化されて表示されたときに呼び出されるので、その特定の時点で製品ビューイベントを送信します。

      code language-swift
      // Send productViews commerce experience event
      MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productViews", product: product)
      
    2. ボタンごとに( {width="15"}, {width="20"} と {width="20"})ツールバーで、関連する呼び出しを ATTrackingManager.trackingAuthorizationStatus == .authorized クロージャ内に追加します。

      1. の場合 {width="15"}:

        code language-swift
        // Send saveForLater commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "saveForLaters", product: product)
        
      2. の場合 {width="20"}:

        code language-swift
        // Send productListAdds commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productListAdds", product: product)
        
      3. の場合 {width="20"}:

        code language-swift
        // Send purchase commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "purchases", product: product)
        
TIP
Android™ 向けに開発している場合は、基盤のインターフェイスとして Map (java.util.Map)を使用して、XDM ペイロードを作成します。

カスタムフィールドグループ

画面のビュー数とインタラクションをアプリ自体で追跡するとします。 このタイプのイベントにカスタムフィールドグループを定義したことに注意してください。

  • スキーマで、収集しようとしているイベントを識別します。
    アプリインタラクションスキーマ

  • オブジェクトの作成を開始します。

    note note
    NOTE
    • 標準フィールドグループは、常にオブジェクトルートから始まります。

    • カスタムフィールドグループは、常にExperience Cloud組織に固有のオブジェクトの下で始まります(この例では _techmarketingdemos)。

    アプリインタラクションイベントの場合は、次のようなオブジェクトを作成します。

    code language-swift
    let xdmData: [String: Any] = [
      "eventType": "application.interaction",
      "_techmarketingdemos": [
        "appInformation": [
            "appInteraction": [
                "name": "login",
                "appAction": [
                    "value": 1
                    ]
                ]
            ]
        ]
    ]
    

    スクリーントラッキングイベントの場合、次のようなオブジェクトを作成します。

    code language-swift
    var xdmData: [String: Any] = [
      "eventType": "application.scene",
      "_techmarketingdemos": [
          "appInformation": [
              "appStateDetails": [
                  "screenType": "App",
                      "screenName": "luma: content: ios: us: en: login",
                      "screenView": [
                          "value": 1
                      ]
                  ]
              ]
          ]
    ]
    
  • これで、このデータ構造を使用して ExperienceEvent を作成できます。

    code language-swift
    let event = ExperienceEvent(xdm: xdmData)
    
  • イベントとデータを Platform Edge Networkに送信します。

    code language-swift
    Edge.sendEvent(experienceEvent: event)
    

ここでも、実際にこのコードを Xcode プロジェクトに実装します。

  1. 便宜上、MobileSDK で 2 つの関数を定義します。 Xcode プロジェクトナビゲーターで Luma/Luma/Utils/MobileSDK に移動します。

    1. アプリのインタラクション用の 1。 次のコードを func sendAppInteractionEvent(actionName: String) 関数に追加します。

      code language-swift
      // Set up a data dictionary, create an experience event and send the event.
      let xdmData: [String: Any] = [
          "eventType": "application.interaction",
          tenant : [
              "appInformation": [
                  "appInteraction": [
                      "name": actionName,
                      "appAction": [
                          "value": 1
                      ]
                  ]
              ]
          ]
      ]
      let appInteractionEvent = ExperienceEvent(xdm: xdmData)
      Edge.sendEvent(experienceEvent: appInteractionEvent)
      

      この関数は、アクション名をパラメーターとして使用します。

      • 関数のパラメーターを使用して、XDM ペイロードをディクショナリとして設定します。
      • 辞書を使用してエクスペリエンスイベントを設定します。
      • Edge.sendEvent API を使用してエクスペリエンスイベントを送信します。
    2. 1 つは画面トラッキング用です。 次のコードを func sendTrackScreenEvent(stateName: String) 関数に追加します。

      code language-swift
      // Set up a data dictionary, create an experience event and send the event.
      let xdmData: [String: Any] = [
          "eventType": "application.scene",
          tenant : [
              "appInformation": [
                  "appStateDetails": [
                      "screenType": "App",
                      "screenName": stateName,
                      "screenView": [
                          "value": 1
                      ]
                  ]
              ]
          ]
      ]
      let trackScreenEvent = ExperienceEvent(xdm: xdmData)
      Edge.sendEvent(experienceEvent: trackScreenEvent)
      

      この関数は、状態名をパラメーターとして使用します。

      • 関数のパラメーターを使用して、XDM ペイロードをディクショナリとして設定します。
      • 辞書を使用してエクスペリエンスイベントを設定します。
      • Edge.sendEvent API を使用してエクスペリエンスイベントを送信します。
  2. Luma/Luma/Views/General/LoginSheet に移動します。

    1. ログインボタンのクロージャーに次のハイライトされたコードを追加します。

      code language-swift
      // Send app interaction event
      MobileSDK.shared.sendAppInteractionEvent(actionName: "login")
      
    2. 次のハイライト表示されたコードを修飾子 onAppear 追加します。

      code language-swift
      // Send track screen event
      MobileSDK.shared.sendTrackScreenEvent(stateName: "luma: content: ios: us: en: login")
      

検証

  1. 設定手順の節を参照して、シミュレータまたはデバイスを Assurance に接続します。

    1. Assurance アイコンを左に移動します。

    2. タブバーで ホーム を選択し、ホーム画面に ECIDメールCRM ID が表示されていることを確認します。

    3. タブバーで「Products」を選択します。

    4. 商品を選択します。

    5. 選択 {width="15"}。

    6. 選択 {width="20"}。

    7. 選択 {width="15"}。

      {width="300"}

  2. Assurance UI で、com.adobe.edge.konductor ベンダーからの hitReceived イベントを探します。

  3. イベントを選択し、messages オブジェクトの XDM データを確認します。 または、「 コピー Raw イベントをコピー を使用し、好みのテキストエディターまたはコードエディターを使用してイベントを貼り付けて検査することもできます。

    データ収集の検証

次の手順

これで、アプリへのデータ収集の追加を開始するためのすべてのツールが用意できました。 ユーザーがアプリ内の製品とどのようにやり取りするかについて、より多くのインテリジェンスを追加でき、アプリのインタラクションおよび画面トラッキングコールをさらにアプリに追加できます。

  • 注文、チェックアウト、空のバスケットなどの機能をアプリに実装し、関連するコマースエクスペリエンスイベントをこの機能に追加します。
  • 適切なパラメーターを指定して sendAppInteractionEvent への呼び出しを繰り返し、ユーザーによる他のアプリのインタラクションを追跡します。
  • sendTrackScreenEvent への呼び出しを適切なパラメーターで繰り返し、ユーザーがアプリで表示した画面を追跡します。
TIP
その他の例については、 完成したアプリを確認してください。

Analytics と Platform へのイベントの送信

イベントを収集して Platform Edge Networkに送信したら、 データストリームで設定されたアプリケーションとサービスに送信されます。 後のレッスンでは、このデータを Adobe AnalyticsAdobe Experience PlatformAdobe Target やAdobe Journey Optimizerなどの他のAdobe Experience Cloud ソリューションにマッピングします。

SUCCESS
これで、Adobe Experience Platform Edge Networkとデータストリームで定義したすべてのサービスに対するコマース、アプリのインタラクション、画面トラッキングイベントを追跡するアプリを設定しました。
Adobe Experience Platform Mobile SDK の学習に時間を費やしていただき、ありがとうございます。 ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League コミュニティ ディスカッションの投稿でお知らせください。

次のトピック:WebViews の処理

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