一括変更と取り消しのリファレンス

アクションデータを一括で変更または取り消す場合は、まずimpact.comが提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイル提出が正しくフォーマットされるよう、関連する参照テーブルのガイドラインに従ってください。提出ファイルの準備が整ったら、次に進んでください： バッチの変更／取り消しを提出する ファイル。

この参照記事には、バッチ変更および取り消しで最も一般的に使用されるフィールドが含まれています。フィールドの説明を含む完全な詳細リファレンスを参照するには、次を参照してください： アクション＆コンバージョンフィールド参照.

以下の参照を参照してください：

• FTP/SMTPバッチ変更または取り消しで使用するフィールドを学ぶ

• プレースホルダのサンプルデータが入ったテンプレートファイルをダウンロードする

• 適用すべき理由コードとその適用タイミングを理解する

注文レベルの変更

これはアイテムレベルではなく注文レベルで一括してアクションデータを更新したい場合（例：複数の注文の注文合計金額を変更する）に該当します。

受け入れ可能なパラメーター

フィールド	必須？	編集可能？	注記
ActionID	条件付き必須*	編集不可	デデュプリケーションウィンドウが短い場合、この識別子の提供を推奨します。
Oid / OrderId	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： ActionTrackerId.
ActionTrackerID	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： OrderId/Oid.
金額	任意	編集可能	注文の新しい合計金額を設定します。
通貨コード	任意	編集可能	アクションの収益通貨を設定します。指定しない場合は、impact.comアカウントの通貨がデフォルトになります。
顧客ステータス	任意	編集可能	コンバージョン時の顧客のステータスを設定します。例：NEW / EXISTING。
理由	必須	編集可能	変更のための有効な理由コードを提供してください。

*少なくとも一つの識別子パスを提供する必要があります。すなわち、次のいずれか： ActionId または （*OrderId/Oid *＋ ActionTrackerId)

テンプレートファイル

• 注文レベルの変更テンプレート

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

注文レベルの取り消し

これはアイテムレベルではなく注文レベルでパートナー発生のアクションを一括で取り消したい場合（例：複数の注文を取り消す）に該当します。

受け入れ可能なパラメーター

フィールド	必須？	編集可能？	注記
ActionID	条件付き必須*	編集不可	デデュプリケーションウィンドウが短い場合、この識別子の提供を推奨します。
Oid / OrderId	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： ActionTrackerId.
ActionTrackerID	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： OrderId/Oid.
金額	条件付き必須**	編集可能	に設定して 0 元の金額が0でない限り注文を取り消すには
理由	必須	編集可能	取り消しのための有効な理由コードを提供してください。

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

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

テンプレートファイル

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

アイテムレベルの変更

これは注文レベルではなくアイテムレベルでアクションデータを一括で更新したい場合（例：注文内の複数アイテムの金額を変更する）に該当します。

受け入れ可能なパラメーター

フィールド	必須？	編集可能？	注記
ActionID	条件付き必須*	編集不可	デデュプリケーションウィンドウが短い場合、この識別子の提供を推奨します。
Oid / OrderId	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： ActionTrackerId.
ActionTrackerID	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： OrderId/Oid.
SKU**	必須	編集不可	変更したいアイテムのSKU値を指定してください。
金額**	条件付き必須	編集可能	新しいアイテム金額、すなわち価格×数量を設定します。数量を変更する場合は、このフィールドも変更が必要です。
数量**	任意	編集可能	注文内のアイテムの新しい数量を設定します。
カテゴリ**	任意	編集可能	アイテムのカテゴリを設定します。
理由**	必須	編集可能	取り消しのための有効な理由コードを提供してください。

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

**これらのフィールドは、変更する各アイテムについて含める必要があります。識別子フィールドは注文ごとに一度だけ含めます。

テンプレートファイル

• アイテムレベルの変更テンプレート

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

アイテムレベルの取り消し

これは注文レベルではなくアイテムレベルでアクションデータを一括で取り消したい場合（例：注文内の複数アイテムを取り消す）に該当します。

受け入れ可能なパラメーター

フィールド	必須？	編集可能？	注記
ActionID	条件付き必須*	編集不可	デデュプリケーションウィンドウが短い場合、この識別子の提供を推奨します。
Oid / OrderId	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： ActionTrackerId.
ActionTrackerID	条件付き必須*	編集不可	を使用する場合は、この識別子の提供が必要です： OrderId/Oid.
SKU**	必須	編集不可	変更したいアイテムのSKU値を指定してください。
金額**	条件付き必須	編集可能	新しいアイテム金額、すなわち価格×数量を設定します。数量を変更する場合は、このフィールドも変更が必要です。
数量**	任意	編集可能	注文内のアイテムの新しい数量を設定します。
理由**	必須	編集可能	変更のための有効な理由コードを提供してください。

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

**これらのフィールドは、変更する各アイテムについて含める必要があります。識別子フィールドは注文ごとに一度だけ含めます。

テンプレートファイル

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

この例ではSKU O7427540が2回出てきます。1行は取り消し（Amount=0）で、もう1行は変更（Amount=15）を行っているためです。

注： 注：重複した OrderIds が予想され、組み合わせの使用を選択する場合： OrderId + ActionTrackerIdimpact.comはデフォルトであなたの更新を最新の ActionId に適用します。古い ActionId に更新を適用したい場合は、を使用してください。 ActionId.

理由コード

アクションデータを変更または取り消すたびに、理由を提供する必要があります。アクションが更新される理由を説明するために、以下の関連する理由コードを使用してください。

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