API経由でアクション内の項目を修正または逆転する

impact.comでは、アクションの修正や取り消しに加えて、アクション内のアイテム単位の詳細を修正および取り消すことができます。

注意： impact.comでは、アクションごとに最大1000件の修正が可能です。その後さらに修正が必要な場合は、 サポートに連絡してください.

API経由でアクション内のアイテムを修正する

アイテムレベルでトラッキングしている場合（つまり、コンバージョンを報告する際にアイテムデータを渡している場合）、APIを使用してアクション内のアイテムの数量や報告された収益額を修正できます。

アクション内のアイテムを修正するには、次のものが必要です：

• 以下の ActionId （アクションの）

• 以下の 更新の 理由（アクション内のアイテムを修正する場合は、常に ORDER_UPDATE).

• 以下の Sku 修正するアイテムの（在庫管理単位）値（APIでアクションを取得したときに確認できます）。

• 新しい Quantity アイテムの新しい数量値。

• 新しい収益 Amount アイテムの新しい収益金額の値 — この値が変更される場合のみこのフィールドをコールに含めてください（例：報告されたアイテムの収益額が誤って報告されていた場合）。

これらの値がすべて揃ったら、以下のサンプルコールを参照してアクション内のアイテムを修正する方法を確認してください。

サンプルコールとレスポンス

アイテムの新しい数量

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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \

アイテムの新しい収益金額

  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \

サンプルレスポンス

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}

パラメータ参照

AccountId	あなたのimpact.comアカウントのAPIアカウントIDの値。 この値の見つけ方を学ぶ.
AuthToken	あなたのimpact.comアカウントのAPI認証トークンの値。 この値の見つけ方を学ぶ.
ActionId	修正するアクションのID値。
Sku	アイテムの在庫管理単位（SKU）の値 — これはAPIでアクションを取得したときに確認できます。
Quantity	アイテムの新しい数量値。
更新の	アイテムを取り消しまたは修正する場合は、常に ORDER_UPDATE を理由として送信してください。
Amount	アイテムの新しい収益金額の値。

API経由でアクション内のアイテムを取り消す

アイテムレベルでトラッキングしている場合（つまり、コンバージョンを報告する際にアイテムデータを渡している場合）、APIを使用して複数のアイテムを取り消すことができます。これには Quantity を 0.

アクション内のアイテムを取り消すには、次のものが必要です：

• 以下の ActionId （アクションの）

• 以下の 更新の アクションを更新するための（理由）（アクション内のアイテムを取り消す場合は、常に ORDER_UPDATE).

• 以下の Sku 取り消すアイテムの

• 新しい Quantity アイテムの値 — この場合は、 0

これらの値がすべて揃ったら、以下のサンプルコールを参照してアクション内のアイテムを取り消す方法を確認してください。

サンプルコールとレスポンス

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 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'

サンプルレスポンス

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}  

パラメータ参照

AccountId	あなたのimpact.comアカウントのAPIアカウントIDの値。 この値の見つけ方を学ぶ.
AuthToken	あなたのimpact.comアカウントのAPI認証トークンの値。 この値の見つけ方を学ぶ.
ActionId	修正するアクションのID値。
Sku	アイテムの在庫管理単位（SKU）の値 — これはAPIでアクションを取得したときに確認できます。
Quantity	アイテムの新しい数量値。
更新の	アイテムを取り消しまたは修正する場合は、常に ORDER_UPDATE を理由として送信してください。