Skip to content

mParticle by Rokt

mParticle の顧客データプラットフォームは、データの有効活用を支援します。熟練したマーケターは、mParticle でグローススタック全体のデータのオーケストレーションを行い、カスタマージャーニーの重要なタイミングで適切なアクションを取ることができます。

Braze と mParticle の統合により、2つのシステム間の情報の流れをシームレスにコントロールできます。

  • Braze キャンペーンとキャンバスのセグメンテーションのために、mParticle のオーディエンスを Braze に同期する。
  • 2つのプラットフォーム間でデータを共有する。これは mParticle キット統合とサーバー間統合によって実現できます。
  • Currents を介して Braze ユーザーインタラクションを mParticle に送信し、グローススタック全体でアクションに活用する。

前提条件

統合

オーディエンス

Braze と mParticle のパートナーシップを利用して統合を構成し、mParticle のオーディエンスを直接 Braze にインポートしてリターゲティングを行い、1つのシステムから別のシステムへのデータの完全なループを作成します。

設定した統合はすべてデータポイントを記録します。Braze データポイントの詳細についてご質問があれば、Braze アカウントマネージャーがお答えします。

オーディエンスの転送

mParticle は、コホートメンバーシップ属性を設定するための3つの方法を提供しており、「Send Segments As」構成設定によって制御されます。各オプションの処理については、次のセクションを参照してください。

単一文字列属性

mParticle は、SegmentMembership という単一のカスタム属性を作成します。この属性の値は、ユーザーに一致するカンマ区切りの mParticle オーディエンス ID の文字列です。これらのオーディエンス ID は、mParticle ダッシュボードの Audiences で確認できます。

例えば、mParticle のオーディエンス「Ibiza dreamers」のオーディエンス ID が「11036」の場合、フィルター SegmentMembership — matches regex — 11036 でこれらのユーザーをセグメント化できます。

これは mParticle のデフォルトオプションですが、ほとんどのユーザーは Braze でセグメントを作成する際のフィルタリング体験のために単一配列属性を使用することを選択します。

mParticle セグメントのメンバーシップ

単一配列属性

mParticle は、各ユーザーに対して Braze に SegmentMembershipArray という単一のカスタム配列属性を作成します。この属性の値は、ユーザーに一致する mParticle オーディエンス ID の配列です。

たとえば、ユーザーが「13053」、「13052」、および「13051」というオーディエンス ID を持つ3つの mParticle オーディエンスのメンバーである場合、フィルター SegmentMembershipArray — includes value — 13051 でそれらのオーディエンスの1つに一致するユーザーをセグメント化できます。

セグメントごとに1つの属性

mParticle は、ユーザーが属する各オーディエンスに対してブール値のカスタム属性を作成します。たとえば、「Possible Parisians」という mParticle オーディエンスの場合、フィルター In Possible Parisians - equals - true でこれらのユーザーをセグメント化できます。

mParticle カスタム属性

単一配列属性と単一文字列属性の両方

mParticle は、単一配列属性と単一文字列属性の両方で説明されているとおりに属性を送信します。

単一配列属性とセグメントごとに1つの属性の両方

mParticle は、単一配列属性とセグメントごとに1つの属性の両方で説明されているとおりに属性を送信します。

単一文字列属性とセグメントごとに1つの属性の両方

mParticle は、単一文字列属性とセグメントごとに1つの属性の両方で説明されているとおりに属性を送信します。

単一配列属性、単一文字列属性、およびセグメントごとに1つの属性

mParticle は、単一配列属性、単一文字列属性、およびセグメントごとに1つの属性で説明されているとおりに属性を送信します。

ステップ 1:mParticle でオーディエンスを作成する

mParticle でオーディエンスを作成するには:

  1. Audiences > Single Workspace > + New Audience に移動します。
  2. オーディエンスの出力先として Braze を接続するには、次のフィールドを指定する必要があります:
  1. 最後にオーディエンスを Save します。

数分以内にオーディエンスが Braze に同期され始めます。オーディエンスのメンバーシップは、external_ids が設定されているユーザー（つまり匿名ユーザーではないユーザー）に対してのみ更新されます。Braze mParticle オーディエンスの作成の詳細については、mParticle の構成設定に関するドキュメントを参照してください。

ステップ 2:Braze でユーザーをセグメント化する

Braze でこれらのユーザーのセグメントを作成するには、Engagement の下の Segments に移動し、セグメントに名前を付けます。以下は、Send segments as で選択したオプションに応じた2つのセグメントの例です。各オプションの詳細については、オーディエンスの転送を参照してください。

  • 単一配列属性: SegmentMembershipArray をフィルターとして選択します。次に、「includes value」オプションを使用して目的のオーディエンス ID を入力します。「includes value」とオーディエンス ID が設定されている mParticle セグメントフィルター「SegmentMembershipArray」。

  • セグメントごとに1つの属性: カスタム属性をフィルターとして選択します。次に、「equals」オプションを使用し、適切なロジックを選択します。mParticle セグメントフィルター「in possible parisians」を「equals」と「true」に設定。

保存すると、キャンバスやキャンペーンの作成時にターゲットユーザーのステップでこのセグメントを参照できます。

接続の無効化と削除

mParticle は Braze で直接セグメントを管理しないため、対応する mParticle オーディエンス接続が削除または無効化されても、セグメントは削除されません。この場合、mParticle は各ユーザーからオーディエンスを除去するために Braze のオーディエンスユーザー属性を更新しません。

削除前に Braze ユーザーからオーディエンスを除去するには、オーディエンスフィルターを調整してオーディエンスのサイズを強制的に0にしてから、オーディエンスを削除します。オーディエンスの計算が完了して0人のユーザーが返された後に、オーディエンスを削除します。その後、オーディエンスメンバーシップが Braze で更新され、単一属性オプションの場合は false に、配列形式の場合はオーディエンス ID が削除されます。

データマッピング

データは、mParticle を介してモバイルおよび Web アプリを Braze に接続したい場合、埋め込みキット統合を使用して Braze にマッピングできます。また、サーバー間 API 統合を使用して、サーバー側のデータを Braze に転送することもできます。

どのアプローチを選択する場合でも、Braze を出力として設定する必要があります。

Braze の出力設定を構成する

mParticle で、Setup > Outputs > Add Outputs と進み、Braze を選択して Braze キット設定を開きます。完了したら Save します。

埋め込みキット統合

mParticle と Braze の SDK は、埋め込みキット統合を通じてアプリケーション上に存在します。ただし、直接の Braze 統合とは異なり、mParticle が Braze SDK のメソッドのほとんどの呼び出しを処理します。ユーザーデータのトラッキングに使用する mParticle メソッドは、Braze SDK メソッドに自動的にマッピングされます。

mParticle の Android、iOS、Web 用 SDK のこれらのマッピングはオープンソースであり、mParticle の GitHub ページで確認できます。

埋め込みキット SDK 統合により、Braze のフルスイート機能（プッシュ、アプリ内メッセージ、および関連するすべてのメッセージ分析トラッキング）を利用できます。

ステップ 1:mParticle SDK を統合する

プラットフォームのニーズに基づいて、適切な mParticle SDK をアプリに統合します。

ステップ 2:mParticle の Braze イベントキット統合を完了する

この mParticle 統合のために Braze SDK を Web サイトやアプリに直接含める必要はありませんが、アプリから Braze にデータを転送するために次の mParticle Appboy Kit をインストールする必要があります。

mParticle の Braze イベントキット統合ガイドでは、メッセージングのニーズ（プッシュ、位置情報の追跡など）に基づくカスタムの mParticle および Braze 調整手順を説明しています。

ステップ 3:Braze 出力の接続設定

mParticle で、Connections > Connect > [希望のプラットフォーム] > Connect Output に移動し、出力として Braze を追加します。次に、Save を選択します。

すべての接続設定がすべてのプラットフォームおよび統合タイプに適用されるわけではありません。接続設定とそれらが適用されるプラットフォームの内訳については、mParticle のドキュメントを参照してください。

サーバー API 統合

mParticle のサーバーサイド SDK（例: Ruby、Python など）を使用している場合に、バックエンドデータを Braze にルーティングするためのアドオンです。Braze でこのサーバー間統合を設定するには、mParticle のドキュメントの説明に従ってください。

Braze 出力の接続設定

mParticle で、Connections > Connect > [希望のプラットフォーム] > Connect Output に移動し、出力として Braze を追加します。完了したら Save します。

すべての接続設定がすべてのプラットフォームおよび統合タイプに適用されるわけではありません。接続設定とそれらが適用されるプラットフォームの内訳については、mParticle のドキュメントを参照してください。

「Enriched User Attributes」または「Enriched User Identities」を有効にする前に、これらの設定がデータポイント使用量にどのように影響するかを把握するためにデータポイント超過を確認することをお勧めします。

データマッピングの詳細

データタイプ

両方のプラットフォーム間ですべてのデータタイプがサポートされているわけではありません。

  • カスタムイベントプロパティは、文字列、数値、ブール値、または日付オブジェクトをサポートします。配列やネストされたオブジェクトはサポートされていません。
  • カスタム属性は、文字列、数値、ブール値、日付オブジェクト、配列をサポートしますが、オブジェクトやネストされたオブジェクトはサポートしません。

データマッピング

ユーザー ID マッピング

各 mParticle 出力について、external_id として Braze に送信する外部 ID タイプを選択できます。デフォルト値は顧客 ID ですが、MPID などの別の ID を Braze に external_id として送信するようにマッピングすることもできます。顧客 ID 以外の識別子を選択すると、Braze でのデータ送信方法に影響を与える可能性があることに注意してください。

例えば、MPID を Braze の external_id にマッピングすると、次のような影響があります:

  • MPID が割り当てられるタイミングの性質上、すべてのユーザーはセッション開始時に external_id が割り当てられます。
  • MPID と external_id のデータタイプが異なるため、Currents の設定で追加のマッピングが必要になる場合があります。

消去リクエスト（データ主体リクエスト）の転送

Braze へ消去リクエストを転送するには、Braze へのデータ主体リクエスト出力を設定します。消去リクエストを Braze に転送するには、mParticle のドキュメントの説明に従ってください。

潜在的なデータポイントの超過

Enriched User Attributes

ユーザー属性/ID の Enrich を有効にする（サーバー間のみ）

mParticle 接続設定では、Braze は Include Enriched User Attributes をオフにすることを推奨します。有効にすると、mParticle は、既存のプロファイルから利用可能なすべてのユーザー属性（標準属性、カスタム属性、計算された属性など）を各ログイベントで Braze に転送します。これは、mParticle が毎回同じ変更されていない属性を Braze に送信するため、データポイントを大量に消費する結果となります。

例えば、ユーザーが最初のセッションで名、姓、電話番号を追加し、その後ニュースレターに登録して同じ情報とメールを追加した場合、ニュースレター登録イベントがトリガーされます:

  • オンの場合（デフォルト）、5つのデータポイントが発生します（サインアップイベント、メールアドレス、名、姓、電話番号）。
  • オフの場合、2つのデータポイントが発生します（サインアップイベントとメールアドレス）。

Enriched User Attributes をオフにする際の考慮事項

Include Enriched User Attributes をオフにする際に注意すべき点がいくつかあります:

  1. サーバー間統合は mParticle イベント API を使用してイベントを Braze に送信します。各リクエストはイベントによってトリガーされます。メールアドレスの更新など、ユーザー属性が変更されても、特定のイベント（プロファイル更新カスタムイベントなど）に関連付けられていない場合、新しい値は、ユーザーによってトリガーされる次のイベントのペイロードで「enriched attribute」として Braze などの出力に渡されるだけです。Include Enriched User Attributes がオフになっている場合、特定のイベントに関連付けられていないこの新しい属性値は Braze に渡されません。
    • これを解決するために、更新された特定のユーザー属性のみを Braze に送信する別の「ユーザー属性更新」イベントを作成することをお勧めします。このアプローチでは、「ユーザー属性更新」イベントに対して追加のデータポイントを記録することになりますが、この機能を有効にしてすべての呼び出しですべてのユーザー属性を送信するよりもデータポイント使用量ははるかに少なくなります。
  2. 計算された属性は enriched user attribute として Braze に渡されるため、「Enriched User Attributes」がオフになると、これらは Braze に渡されなくなります。「Enriched User Attributes」がオフの場合に計算された属性を Braze に転送するには、すべての属性をプッシュすることなく計算された属性フィードを利用できます。計算された属性が変更されると、フィードが Braze にダウンストリームの更新を送信します。

トラブルシューティング

Braze イベントキットを使用した iOS プッシュ通知のトラブルシューティング

iOS で Braze イベントキット（埋め込みキット統合）を使用しているときにプッシュ通知が機能しない場合は、以下を確認してください:

  1. プッシュトークンの転送: mParticle がプッシュトークンを Braze に転送していることを確認します。mParticle ダッシュボードで、Braze キット接続でプッシュが有効になっていること、および Braze ダッシュボードで正しい Apple プッシュ認証情報が設定されていることを確認してください。
  2. キットの初期化順序: Braze キットは、アプリがプッシュ権限を要求する前に初期化される必要があります。キットがアクティブになる前にプッシュ権限が要求された場合、プッシュトークンが Braze に転送されない可能性があります。mParticle SDK がアプリのライフサイクルの早い段階で開始されていることを確認してください。
  3. メソッドスウィズリング: mParticle Apple キットは、メソッドスウィズリングを使用してプッシュトークンを自動的に転送し、プッシュ通知イベントを処理します。スウィズリングを無効にしている場合や、別の SDK が干渉している場合、プッシュトークンが Braze に届かない可能性があります。mParticle 設定でスウィズリングが有効になっていることを確認してください。
  4. 手動トークン処理: プッシュトークンを手動で管理している場合（例: application:didRegisterForRemoteNotificationsWithDeviceToken: を実装している場合）、プッシュ通知トークンプロパティに割り当てることでトークンを mParticle に渡していることを確認してください。例: MParticle.sharedInstance().pushNotificationToken = deviceToken。キットがそれを Braze に転送します。
  5. 環境の不一致: APN 認証情報の環境（開発 vs. 本番）がアプリのビルドと一致していることを確認してください。詳細については、iOS プッシュのトラブルシューティングを参照してください。

Braze に不要または重複するデータを送信する

Braze は、値が変更されていない場合でも、属性が Braze に渡されるたびにデータポイントをカウントします。このため、Braze 内でアクションを実行するために必要なデータのみを転送し、属性の差分のみが渡されるようにすることをお勧めします。
Github   GitHub でこのページを編集
New Stuff!