ファイルセグメント

成長チームは、ユーザーやユーザーデータに関する独自の分析を行うことがよくあります。分析の後、成長チームはこれらのユーザーをキャンペーンに使用したり、さらなる分析を行いたいと考えるでしょう。

これらのユーザーはMoEngageにアップロードされ、ファイルセグメントとして使用できます。ファイルセグメントはユーザーのリストです。ファイルセグメントは、MoEngageキャンペーンや分析に使用できます。

ファイルセグメントは、あなたが自分の分析を通じて特定したかもしれないユーザーセグメントを作成し、ターゲットにする柔軟性を提供します。ユーザーを一意に識別するユーザー属性の1つを含むユーザーのリストをインポートできます。このユーザーのカスタムセグメントが作成されます。

ファイルセグメントを作成する

ステップ 1:

MoEngage ダッシュボード > セグメント > すべてのセグメント > +セグメント > ファイルセグメント

File_segment_1.gif

ステップ2:

  1. カスタムセグメント名と説明を提供してください。
  2. ユーザーリストが含まれているファイルを選択してください。CSVをアップロードするか、同じものへのURLを提供できます。
  3. リストで使用しているユーザー属性を選択してください。例えば、ユーザーの運転IDのリストがある場合は、ユーザー属性のドロップダウンから運転IDを選択してください。
  4. カスタムセグメントが作成された際にMoEngageが通知できるメールアドレスを1つ以上提供してください。

注意: メールを受信した後にセグメントが表示されない場合は、ページを更新して検索してください。

File_segment_3.gif

warning

ユーザー属性の値は、単一のユーザーを一意に識別する必要があります。属性値が複数のユーザーを特定する場合(例:属性が「ロンドン」という値を持つ都市は、多くのユーザーを持つ可能性があります。これらの複数のユーザーは、単一の属性にマッピングされ、セグメントの一部となり、他のユーザーがセグメントに含まれるのをブロックする可能性があります。

例えば、5通のメールをアップロードすると、最初のメールは3人のユーザー(A、B、C)に一致し、残りの4通のメールはそれぞれ1人のユーザー(D、E、F、G)に一致します。 この場合、システムはランダムに5人のユーザーを選択してファイルセグメントに追加します。

システムは、2,000の属性値のバッチで処理を行い、各バッチで最大2,000のユーザーをファイルセグメントに追加します。ユーザー属性値が少ない場合でも、より多くのユーザーをファイルセグメントに追加できます。たとえば、1,500のユーザー属性値が2,500のユーザーを生成する場合、システムはこれらの2,500のユーザーの中からランダムに2,000をファイルセグメントに追加します。

ファイル形式

MoEngageシステムにアップロードする前に、ファイルを確認してください。Ensure that -

  • ファイルには重複する値がありません。
  • ファイルには特殊文字が含まれていません。
  • ファイルには二重引用符がありません。
  • ファイルには空の行や空の列はありません。
  • ユーザー属性を含む単一の列を持つCSVファイルである必要があります。
  • ファイルサイズは64 MBを超えてはいけません。
    サンプルファイルリンク

カスタムセグメントの可用性

MoEngageシステムがファイルセグメントリクエストを受信すると、カスタムセグメントを作成します。カスタムセグメントを作成した後、システム ユーザーを処理し、それらのユーザーをカスタムセグメントに追加します。
したがって、カスタムセグメントは 利用可能 であり、ファイルが処理中である場合や、ファイル処理が失敗した場合にも利用可能です。ファイルセグメントが処理されると、そのステータス(完了または失敗のいずれか)がメールで通知されます。

場合に ファイルのアップロード/処理 失敗した場合、あなたは 同じカスタムセグメント名を使用してファイルを再アップロードできます システムは新しいユーザーを提供されたカスタムセグメントに追加します。 この機能により、既存のファイルカスタムセグメントに新しいユーザーを追加することも可能です。 この機能により、既存のファイルのカスタムセグメントに新しいユーザーを追加することもできます。

ファイルセグメント処理のステータスと警告

ファイルセグメントが完全に処理される前に使用することによる問題を防ぐために、MoEngageはUIに警告を提供します。これらの警告は、セグメントがまだ処理中であるか、いつ使用することが望ましいかを理解するのに役立ちます。
Screenshot 2025-05-19 at 3.16.56 PM.png

info

Information

次のページでこれらの警告が表示されます:

  • セグメントページを作成
  • ターゲットオーディエンス キャンペーン作成ページのセクション
  • ターゲットオーディエンス 分析ページのセクション

セグメント使用中の警告

別のセグメントを作成するために使用するため、キャンペーンをターゲットにしているときや分析中に、まだ処理中のファイルセグメントを選択すると、警告メッセージが表示されます。警告は以下の条件に基づいて表示されます:

  • 選択された単一のセグメントが処理中の場合 : "このセグメントでユーザーが更新されています - < カスタムセグメント名 >。このセグメントをキャンペーンで使用する前に、確認メールを受け取るまでお待ちいただくことをお勧めします。最新の更新情報をここで確認してください。
  • 別のセグメントにネストされたセグメントが処理中です : "これらのセグメントでユーザーが更新されています - < カスタムセグメント 1、カスタムセグメント 2、カスタムセグメント 3 の名前 >. これらのセグメントは、選択された親セグメントにネストされています。キャンペーンでセグメントを使用する前に、確認メールを受け取るまでお待ちいただくことをお勧めします。最新の更新情報については、ここをチェックしてください。"

ページを更新するか、セグメントを再選択して最新のステータスを確認してください。この警告は、キュー内の最後のファイルが正常に処理された後は表示されなくなります。

セグメント詳細ページの警告

カスタムセグメントの詳細ページに移動すると、現在更新中のセグメント(つまり、ファイルのアップロードがまだ処理中)の場合、次のような警告メッセージが表示されます: "このセグメントでユーザーが更新されています - < CS名リンク >。このセグメントをキャンペーンで使用する前に、確認メールを受信するまでお待ちいただくことをお勧めします。最新の更新情報をここでチェックしてください。"

ページを更新して、セグメントの最新のステータスを確認してください。ファイル処理が正常に完了すると、この警告は表示されなくなります。

ユーザーの可用性

ファイルセグメントには、MoEngageに存在するユーザーのみを含めることができます。MoEngageシステムに存在しないユーザーをアップロードした場合、そのユーザーは処理されず、ファイルセグメントの一部にはなりません。

新しいユーザーをMoEngageにアップロードし、それらのユーザーのファイルセグメントを作成するには、 ユーザーのインポート を参照してください。

ファイルセグメントを介してアップロードされたユーザーの総数は、1日に200万に制限されています。
(この制限はカスタマイズ可能です。制限を増やすにはサポートにお問い合わせください。)

ファイルセグメントを編集する

MoEngage ダッシュボードを介して既存のファイルセグメントを編集することが可能です 。MoEngage ダッシュボードでは、ファイルセグメントに対して以下のアクションを実行できます:

  1. ユーザーを追加: 既存のファイルセグメントに新しいユーザーのリストを追加できます。
  2. ユーザーの削除: 既存のファイルセグメントからユーザーのリストを削除できます。
  3. ユーザーを置き換える: 既存のファイルセグメント内のユーザーのリストを置き換えることができます。

ステップ 1:

Segment > All Segments ページから編集したいファイルセグメントに移動します。

ステップ2:

アクションタブから、[その他のアクション]の縦の省略記号をクリックし、[編集]オプションを選択します。

ステップ3:

  1. ファイルセグメントに対して実行したい編集アクションを選択してください:ユーザーを追加、ユーザーを削除、またはユーザーを置き換え。
  2. ユーザーリストを追加、削除、または置き換えるためのファイルを選択してください。CSVをアップロードするか、同じものへのURLを提供することができます。
  3. リストが使用しているユーザー属性を選択してください。たとえば、ユーザーのドライビングIDのリストがある場合は、ユーザー属性のドロップダウンからドライビングIDを選択します。
  4. MoEngageがカスタムセグメントの処理が完了した際に通知できるメールアドレスを1つ以上提供してください。

File_segment_4.gif

ファイルセグメントのすべての機能:セグメントの作成、ファイルセグメントからのユーザーの削除および置き換えは、 ファイルセグメントAPI を使用してアクセスすることもできます。

ファイルセグメントのアーカイブ/アーカイブ解除

ファイルセグメントは、MoEngageダッシュボードからアーカイブできます。

  1. 過去60日間に実行されていないファイルセグメントは、自動的にアーカイブされます。
  2. アーカイブされたファイルカスタムセグメントのすべてのユーザーは、アーカイブから30日後に削除されます。したがって、アーカイブ後30日で、アーカイブされたカスタムセグメントは0ユーザーを返します。

arrow_drop_down MoEngageのファイルセグメントとアップロードされたファイルのユーザー数が異なるのはなぜですか?

問題

アップロードされたファイルとMoEngageのファイルカスタムセグメント間でユーザー数に不一致があります。

説明

以下は、これらの違いの可能性のある理由です:

  • ゼロカウント
    • 提供された属性が間違っています: ファイルセグメントのアップロード中に選択された属性がファイルに提供された値と一致しません。 たとえば、選択された属性が 年齢 (ダブルデータ型)であるのに対し、ファイルに 名前 (文字列データ型)の値が含まれている場合、MoEngageに一致するユーザーが存在せず、ゼロカウントになります。
    • ファイルがダウンロードできません: 提供されたファイルURLがプライベートまたは期限切れの場合、MoEngageはファイルをダウンロードできず、カスタムセグメントにユーザーが追加されず、ゼロカウントになります。
    • 不適切なCSVコンテンツ: 値の前後にスペースがある、スペースのみの行、非UTF-8文字、二重引用符で囲まれた値、またはカンマで終わる値などの問題がゼロユーザー数を引き起こす可能性があります。
    • ファイル処理の遅延: ファイルをアップロードした後、ユーザーはすぐにはカスタムセグメントに追加されません。処理時間はファイル内の値の数に応じて増加します。アップロード後すぐにカスタムセグメントをクエリすると、ゼロカウントになる可能性があります。
  • ユーザー数が少ない
    • MoEngageのユーザー数が少ない: ファイルに記載された値がMoEngageの値と一致しない場合、それは考慮されず、ユーザー数が減少します。
    • 不適切なCSVコンテンツ: ゼロカウントのシナリオと同様に、CSVコンテンツの問題はユーザー数の減少につながる可能性があります。
    • ファイルアップロードがまだ処理中: ファイルアップロード直後にゼロユーザーのカスタムセグメントが作成されます。その後、ファイル処理中にユーザーが追加されます。処理中にセグメントをクエリすると、ユーザー数が少なく表示されることがあります。
  • より多くのカウント
    • 属性値が複数のユーザーと一致します: ファイルに提供された値がMoEngageの複数のユーザーと一致する場合、一致したすべてのユーザーがカスタムセグメントに追加され、結果としてユーザー数が増加します。

詳細については、 ファイルセグメント をお読みください。

arrow_drop_down CSVのアップロードがファイルセグメントに失敗する理由は何ですか?

問題

ファイルセグメントにCSVファイルをアップロードしているときに、次のエラーメッセージが表示されます:

エラーがあるようです。私たちはこれを修正するために取り組んでいます。

ソリューション

次の手順を実行します。

  1. ファイル形式の確認 :
    • ファイルがCSV形式であることを確認してください。
  2. ファイルサイズを確認してください :
    • ファイルサイズが64 MBを超えないことを確認してください。ファイルが許可されたサイズを超える場合は、アップロードする前にサイズを減らしてください。
  3. ユニーク識別子列を確認してください :
    • ファイルには、セグメントのユニーク識別子として指定された1つの列のみが含まれていることを確認してください。
    • ユニーク識別子 (UID) の使用を推奨します。
  4. 空の行と不要なデータを削除する :
    • ファイルの最後に空の行がないか確認してください。
    • 問題を引き起こす可能性のある不要または重複した値を削除してください。
  5. 属性データ型にレコード値を一致させる :
    • レコード値が指定されたデータ型と一致していることを確認してください。
  6. サポートされていない文字を避ける :
    • 値にサポートされていない文字を削除します。たとえば、特殊文字やダブルクォーテーション (") はサポートされていません。

詳細については、 ファイルセグメント をお読みください。

arrow_drop_down なぜサードパーティリンクのファイルセグメントへのアップロードが失敗するのか?

問題

ファイルセグメントにサードパーティリンクをアップロードしているときに、次のエラーメッセージが表示されます:

エラーが発生しているようです。私たちはこれを修正するために取り組んでいます。

ソリューション

次の手順を実行します。

  1. プライベートファイルのホワイトリストIP :
    • ファイルがプライベートの場合、関連するIPアドレスをホワイトリストに登録して、MoEngageにのみアクセスを許可します。
  2. ファイル形式を確認してください :
    • ファイルがCSV形式であることを確認してください。
  3. ファイルサイズを確認してください :
    • ファイルサイズが64 MBを超えないことを確認してください。許可された制限を超える場合は、アップロードする前にサイズを減らしてください。
  4. 一意の識別子列を確認してください :
    • ファイルには、セグメントの一意の識別子として機能する列が1つだけ含まれている必要があります。
  5. 空の行と不要なデータを削除する :
    • ファイルの最後に空の行がないか確認してください。
    • 問題を引き起こす可能性のある不要な値や重複した値を削除してください。
  6. 属性データ型にレコード値を一致させる :
    • レコード値が指定されたデータ型と一致していることを確認してください。
  7. サポートされていない文字を避ける :
    • 値にサポートされていない文字を削除してください。たとえば、特殊文字や二重引用符(")はサポートされていません。

詳細については、 ファイルセグメント をお読みください。

この記事は役に立ちましたか?
8人中4人がこの記事が役に立ったと言っています

How can we improve this article?