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

PXAコースを受講する

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

どの送信方法が適していますか？

もし〜したい場合...	この方法を使います...
コーディングなしで、手動の1回限りのファイルを送信する	​メール バッチ処理または 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がデフォルトで受け入れる定義済みコードであり、一方 処理コード は、設定できるカスタム理由です。 処理コードの詳細.

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

コード	説明
CONS_FRAUD	消費者詐欺
CONS_ERROR	消費者の誤り
ITEM_RETURNED	商品が返品されました
APPROVED	アクションは承認されています 注: アクションを承認しようとしている場合は、 承認 として設定する必要があります カスタム処理コード.
ORDER_ERROR	注文エラー
ORDER_UPDATE	注文が更新されました
PUB_ACT_DISPUTE	パートナーの活動に関する異議申し立て
ADV_ACT_DISPUTE	ブランドの活動に関する異議申し立て
NOT_COMPLIANCE_TERMS	利用規約に準拠していません
ITEM_OUT_OF_STOCK	商品は在庫切れです
TEST_ACTION	テストアクション
PARTNER_NOT_ACTIVE	パートナーアカウントが無効化されました
CREDITED_DIFFERENT_MP	別のパートナーに計上されました
OTHER	その他の理由

アクションに修正／取消が適用された時期を確認するにはどうすればよいですか？

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

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