API 経由で一括変更または取り消し

PXAコースを受講する

アクションに関して何か変更があった場合（例：注文がキャンセルされた、商品が返品された、など）、APIを使ってそれを修正（または取り消し）し、そのアクションのコミッション金額を変更できます。

どの送信方法があなたに適していますか？

〜したい場合は...	この方法を使用してください...
コーディング不要で、手動の単発ファイルを送信する	​メール バッチ処理または FTP経由でファイルをアップロードする
自動コンバージョンレポートを設定する	​コンバージョン / アクション API、 FTP経由でファイルを送信する、または FTP経由でファイルを取得する

APIでの取り消しオプション：

• API経由でアクション内の1つ以上のアイテムを修正または取り消す
• API経由でアクション全体を取り消す

前提条件：次を取得してください ActionId 値

APIでアクションデータを修正するには、その ActionId の値が必要です。これを使って、APIで修正したいアクションを見つけることができます。

• 呼び出しで日付範囲を指定できます。指定しない場合、エンドポイントは既定で過去30日間のアクションを表示します。
• レート制限 が適用されます。
• 以下を表示します すべてのアクションを一覧表示 詳細はAPIエンドポイントのドキュメントをご覧ください。

よくある質問

アクション（またはアクション項目）に対して行った修正／取り消しをどのようにリセットしますか？

アクションがロック日より前に修正または取り消しされた場合、 RESET を理由として送信し、アクションをデフォルト状態に戻す更新を行えます：

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Reason=RESET'

次を通じてリセットされたアクションは RESET コードにより、レポートに正しく表示されない場合があります（例：収益値が誤って計算される可能性があります）。

ディスポジションコードと理由の違いは何ですか？

どちらも ディスポジションコード および 理由 は同じ文脈で使用されます — 理由 はAPIが既定で受け入れる事前定義コードであり、一方 ディスポジションコード は設定できるカスタム理由です。 ディスポジションコードの詳細を見る.

サポートされている理由コード：

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

修正／取り消しがアクションに適用された時期をどのように確認できますか？

次の アクション更新 エンドポイントを使うと、アクションが最後に更新された時期と現在の状態を確認できます。

注： ある ActionUpdatesID 値は別の ActionId 値とは異なります — そのため、 ActionUpdatesID アクションの更新を取得するには、その値を使用する必要があります。