Visitor.putリード情報更新APIマーケティングプラットフォームのリード情報を更新するためのAPIです。更新キーに対するデータが存在する場合は更新を行い、存在しない場合は新規登録を行いたい場合は「1」を指定します。upsertオプションが「1」の場合の更新キーを指定します。設定値は、システム設定一覧の「Webサービス経由でのリード登録時の更新キーの利用」をご覧ください。複数指定する場合は「:」をURLエンコードした「%3A」で区切ります。本項目に値を設定した場合、「Webサービス経由でのリード登録時の更新キーの利用」で設定した値よりも優先されます。要素のエラーチェック(必須チェック、型チェック)を行いたくない場合は「1」を指定します。使用して、HTTPメソッドを上書きします。リードID※更新キーとして使用します。リードIDは更新できません。場合は指定しないでください。ログインパスワード※マーケティングプラットフォームでシステム設定「パスワードを暗号化して保存」が「有効」の場合、更新できません。</Attribute2List></VisitorData>レスポンスXMLサンプルなし制限事項マーケティングプラットフォームAPIのリクエストパラメータに記載されている必須カラムと、対応するマーケティングプラットフォームの必須カラムは、整合性がとれている必要があります。マーケティングプラットフォームAPIでは必須でないカラムであっても、マーケティングプラットフォームのカラムが必須であった場合、APIによるデータ更新処理時に必須エラーが発生します。指定する更新キーによって、「リクエストボディの必須カラム」が変わります。このメソッドでリード情報が更新・登録されるかによって、レスポンスコードが変わります。パラメータ[upsert=1]およびレスポンスコードを参照下さい。リード情報の更新方法についてマーケティングプラットフォームAPIは、リード情報の更新にvisitor.putメソッドを使用します。visitor.putメソッドは更新するリード情報を特定するために、更新キーを指定する必要があります。通常、更新キーは一意であることが保証されているリードIDを使用しますが、リードID以外の更新キーを使用することもできます。リードID以外による更新リード情報の更新は、emailなどリードID以外の更新キーを指定できます。リードID以外の更新キーによる更新を行う場合、下記の設定を行う必要があります。システム設定「Webサービス経由でのリード登録時の更新キーの利用」マーケティングプラットフォームのシステム設定「Webサービス経由でのリード登録時の更新キーの利用」に更新キーを指定します。※システム設定「Webサービス経由でのリード登録時の更新キーの利用」については「APIガイドの利用方法」の「APIによるキャンペーンの申込について」節の「キャンペーンへの追加申込」項を参照してください。[upsert=1]visitor.putのURLパラメータでupsertを1に指定した場合、リード情報の更新方法が変わります。※UPSERTとは、UPDATE+INSERTのことであり、更新対象のデータがあればデータの更新(UPDATE)、なければデータの新規登録(INSERT)を行います。指定した更新キーに該当するリードがいる場合にリード情報の更新を行い、該当するリードがいなければリード情報の新規登録を行います。更新キーに該当するリードが2件以上存在する場合、リード情報の更新・新規登録はされません。新キーとして指定したカラムは、リクエストボディの必須カラムになります。「email」を更新キーに設定した場合、Emailが必須カラムになります。リクエストURL:更新キーを「id」に指定した場合は、リクエストURLの{id}、HTTPリクエストボディのは不要となります。https://{domainname}/services/rest/visitorレスポンスコードupsertに1を指定した場合は、更新と新規登録でレスポンスコードが変わります。※リード情報が新規登録された。