バッチ変更と取り消しのリファレンス

アクションデータを一括で修正または取消する場合は、まず impact.com が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイルの送信形式が正しくなるよう、該当する参照表のガイドラインに従ってください。送信ファイルの準備ができたら、次に進めます バッチ修正／取消の送信 ファイル。

この参照記事には、バッチ修正および取消で最もよく使用されるフィールドが含まれています。フィールドの説明を含む完全で詳細な参照については、 アクションおよびコンバージョンのフィールド参照.

以下の参照先をご覧ください：

• FTP/SMTP バッチ修正または取消で使用するフィールドを確認する
• プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする
• どの理由コードをいつ適用するかを理解する

注文レベルの修正

これは、アイテムレベルではなく注文レベルでアクションデータを一括更新したい場合、たとえば複数の注文の注文金額を変更したい場合に使用します。

使用可能なパラメータ

項目	必須？	編集可能？	メモ
アクションID	条件付きで必須*	編集不可	重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。
Oid / OrderId	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です ActionTrackerId.
ActionTrackerID	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です OrderId/Oid.
金額	任意	編集可能	注文の新しい合計金額を設定します。
currencyCode	任意	編集可能	アクションの収益通貨を設定します。指定がない場合、既定では impact.com アカウントの通貨が使用されます。
CustomerStatus	任意	編集可能	コンバージョン時点での顧客ステータスを設定します。例：NEW / EXISTING。
理由	必須	編集可能	修正のための有効な理由コードを指定してください。

*少なくとも 1 つの識別子パスを指定する必要があります。つまり、次のいずれか ActionId または （*OrderId/Oid *+ ActionTrackerId)

テンプレートファイル

• 注文レベルの修正テンプレート
• 注文レベルの承認テンプレート

注文レベルの取消

これは、アイテムレベルではなく注文レベルでパートナー主導のアクションを一括で取り消したい場合、たとえば複数の注文を取り消したい場合に使用します。

使用可能なパラメータ

項目	必須？	編集可能？	メモ
アクションID	条件付きで必須*	編集不可	重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。
Oid / OrderId	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です ActionTrackerId.
ActionTrackerID	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です OrderId/Oid.
金額	条件付きで必須**	編集可能	次に設定： 0 注文を取り消すために、ただし元の金額 = 0** を除く
理由	必須	編集可能	取消のための有効な理由コードを指定してください。

*少なくとも 1 つの識別子パスを指定する必要があります。つまり、次のいずれか ActionId または (OrderId/Oid + ActionTrackerId)

**元の Amount = 0の場合は、 金額 修正として誤分類されないよう、変更しないでください。

テンプレートファイル

• 注文レベルの取消テンプレート

アイテムレベルの修正

これは、注文レベルではなくアイテムレベルでアクションデータを一括更新したい場合、たとえば注文内の複数アイテムの金額を変更したい場合に使用します。

使用可能なパラメータ

項目	必須？	編集可能？	メモ
アクションID	条件付きで必須*	編集不可	重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。
Oid / OrderId	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です ActionTrackerId.
ActionTrackerID	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です OrderId/Oid.
SKU**	必須	編集不可	修正したいアイテムの SKU 値を指定してください。
金額**	条件付きで必須	編集可能	新しいアイテム金額、つまり price*quantity を設定します。数量を変更する場合は、このフィールドも変更が必要です。
数量**	任意	編集可能	注文内のアイテムの新しい数量を設定します。
カテゴリ**	任意	編集可能	アイテムのカテゴリを設定します。
理由**	必須	編集可能	取消のための有効な理由コードを指定してください。

*少なくとも 1 つの識別子パスを指定する必要があります。つまり、次のいずれか ActionId または (OrderId/Oid + ActionTrackerId)

**これらのフィールドは、修正する各アイテムに含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。

テンプレートファイル

• アイテムレベルの修正テンプレート
• アイテムレベルの承認テンプレート

アイテムレベルの取消

これは、注文レベルではなくアイテムレベルでアクションデータを一括で取り消したい場合、たとえば注文内の複数アイテムを取り消したい場合に使用します。

使用可能なパラメータ

項目	必須？	編集可能？	メモ
アクションID	条件付きで必須*	編集不可	重複排除ウィンドウが短い場合は、この識別子を指定することを推奨します。
Oid / OrderId	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です ActionTrackerId.
ActionTrackerID	条件付きで必須*	編集不可	次を使用する場合は、この識別子の指定が必要です OrderId/Oid.
SKU**	必須	編集不可	修正したいアイテムの SKU 値を指定してください。
金額**	条件付きで必須	編集可能	新しいアイテム金額、つまり price*quantity を設定します。数量を変更する場合は、このフィールドも変更が必要です。
数量**	任意	編集可能	注文内のアイテムの新しい数量を設定します。
理由**	必須	編集可能	修正のための有効な理由コードを指定してください。

*少なくとも 1 つの識別子パスを指定する必要があります。つまり、次のいずれか ActionId または (OrderId/Oid + ActionTrackerId)

**これらのフィールドは、修正する各アイテムに含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。

テンプレートファイル

• アイテムレベルの取消テンプレート

この例で SKU O7427540 が 2 回表示されるのは、1 行が取り消し（Amount=0）、もう 1 行が修正（Amount=15）だからです。

注： 重複が発生する可能性がある場合は、 OrderIds を使用する組み合わせとして選ぶ場合、 OrderId + ActionTrackerId、impact.com は更新を最新の ActionId に対して既定で適用します。古い ActionId に更新を適用したい場合は、 ActionId.

理由コード

アクションデータを修正または取り消すたびに、理由を指定する必要があります。アクションが更新される理由を説明するには、下記の該当する理由コードを使用してください。

警告： 許可されていない値を渡すと、そのエントリは処理されず、代わりにエラーが返されます。カスタム理由コードが必要な場合は、CSM サポートに連絡してください または Disposition Codes について相談してください.

コード	説明
消費者不正	消費者不正
消費者エラー	消費者エラー
商品返品	商品は返品されました
承認済み	アクションは承認されています 注: アクションを承認しようとしている場合、 承認 として設定する必要があります カスタムディスポジションコード.
注文エラー	注文エラー
ORDER_UPDATE	注文が更新されました
パートナーアクティビティの異議申し立て	パートナーアクティビティの異議申し立て
ブランドアクティビティの異議申し立て	ブランドアクティビティの異議申し立て
利用規約に準拠していません	利用規約に準拠していません
在庫切れ	商品は在庫切れです
テストアクション	テストアクション
パートナーがアクティブではありません	パートナーアカウントが無効化されました
別のパートナーに付与されました	別のパートナーに付与されました
その他	その他の理由