Advocate参加者を一括インポートする
Advocate は、送信されたインポートを受け付けます .csv または .jsonl ファイル形式に対応しています。以下を参照してください CSVインポートサンプルファイル および JSONLインポートサンプルファイル インポートに必要なファイル構造を確認してください。
注: 各インポートのエントリ数は500,000件を超えないことを推奨します。
参加者を一括インポート
左側のナビゲーションメニューで、〜を選択します
[Engage] → 参加者.
選択 ユーザーをインポート.
下に インポートの種類、選択します ユーザー.
を選択してインポートファイルを追加してください ファイルを選択.
[任意] 特定のユーザーセグメントにインポートした参加者を追加または削除するには、ドロップダウンリストからセグメントを選択します。
注: この選択は すべての このインポートファイルに含まれる参加者に適用されます。
選択 インポートを開始.
インポートが完了すると、確認メールが送信されます。インポートは、キューの状況とファイルサイズに応じて、最大 30 分かかる場合があります。
フィールド
一括ユーザーインポートでは、アップロードファイル内の標準フィールドとカスタムフィールドの両方がサポートされます。 フィールドは大文字と小文字を区別します。
標準フィールドは、当社の Open Endpoint User Upsert API 呼び出しと同じ検証で解析されます:
accountId (Required)
文字列
この参加者が属するアカウントの一意の識別子。
id (Required)
文字列
この参加者に割り当てられた一意の識別子。
firstName
文字列
参加者の名。
lastName
文字列
参加者の姓。
メール
文字列
参加者のメールアドレス。
referable
boolean
impact.com が、この参加者が紹介可能かどうかを判断するために使用するフラグ。
注: フラグは 1つ の r でなければなりません。
locale
文字列
参加者のロケール。 国際化に使用されます。ロケールは次の形式である必要があります language_COUNTRY ここでは、言語コードは小文字、国コードは大文字でなければなりません。区切り文字はアンダースコアである必要があります。
referredBy.code
文字列
この参加者を紹介した顧客アドボケートの紹介コード。
referralCodes.{programId}
文字列
この参加者が指定のプログラムで共有するための表示用紹介コード(含まれていない場合は自動生成されます)。
sharelinks.{programId}
文字列
この参加者が指定のプログラムで共有するための表示用共有リンク(含まれていない場合は自動生成されます)。
dateCreated
文字列
この参加者が Advocate プログラムで作成された日付。
imageUrl
文字列
ウィジェット、メール、テーマでオプションとして使用されます。絶対パスのプロフィール画像 URL を指定する場合、最小画像サイズは 80px x 80px です。
dateUsTaxFormSubmitted
integer
参加者の W-9 税務フォームが収集済みとしてマークされた日付。構成されている場合、テナントの W-9 コンプライアンスに使用されます。
customFields.{fieldName}
文字列
この構造を使用して、任意のカスタムフィールドを含めます。
カスタムユーザーフィールド は、参加者固有のデータを扱えます。カスタムユーザーフィールドの情報に基づいて、プログラムの目標を発火するよう設定できます。
例:サブスクリプション会員を更新したときに参加者へ報酬を付与します。まず、カスタムフィールド customFields.subscriptionPaid の値を はい含めます。次に、目標を customFields.subscriptionPaid と等しい はい.
この形式で列ヘッダーにカスタムフィールドを追加します: customFields.yourCustomFieldName.
注: カスタムフィールドでは配列やオブジェクトの値は使用できません。
結果
インポートが完了するとメールで通知されます。インポート結果は当社の [Engage] → レポート → インポートとエクスポート Advocate プログラム内のページからダウンロードできます。
警告: ダウンロードリンクは30日後に期限切れになります。
インポートが正常に完了すると、参加者情報を含むファイルが生成され、メールで送信されます。これらの結果に含まれる情報は、当社の ユーザー詳細レポート.
インポート中にエラーが発生した場合は、追加のファイルが生成されます。このエラーファイルには、失敗したレコードの各エラーエントリが含まれ、失敗したレコードの行番号(元のインポートファイルから)と、関連するエラーメッセージが含まれます。
2
このリクエストには、有効で空でない id が必要です
BAD_REQUEST
400
まれにシステムエラーが発生してインポートが中断された場合、インポートは 中止済み として表示され、復旧しません。さらにサポートが必要な場合はサポートチームまでご連絡ください。
最終更新
役に立ちましたか?

