Ändern oder stornieren Sie Elemente in einer Aktion via API

Zusätzlich zum Ändern und Rückgängigmachen von Aktionen ermöglicht impact.com Ihnen, die positionsbezogenen Angaben einer Aktion zu ändern und rückgängig zu machen.

Hinweis: impact.com erlaubt maximal 1000 Änderungen pro Aktion. Wenn Sie danach weitere Änderungen vornehmen müssen, kontaktieren Sie den Support.

Positionen in einer Aktion über die API ändern

Wenn Sie auf Positionsebene verfolgen (d. h. Positionsdaten beim Melden von Conversions übergeben), können Sie die API verwenden, um die Menge oder den gemeldeten Umsatzbetrag von Positionen innerhalb einer Aktion zu ändern.

Um Positionen in einer Aktion zu ändern, benötigen Sie:

Die ActionId der Aktion.
Die Grund für die Aktualisierung der Aktion (bei der Änderung von Positionen in einer Aktion immer ORDER_UPDATE).
Die Sku der zu ändernden Position(en) (kann beim Abrufen einer Aktion über die API gefunden werden).
Die neue Quantity Wert für die Position.
Der neue Umsatz Amount Wert für die Position – schließen Sie diesen nur im Aufruf ein, wenn sich dieser Wert ändert (z. B. wenn der gemeldete Umsatzbetrag der Position falsch gemeldet wurde).

Sobald Sie all diese Werte haben, sehen Sie sich die Beispielaufrufe unten an, um zu erfahren, wie Sie eine Position innerhalb einer Aktion ändern.

Beispielaufrufe & Antwort

Neue Positionsmenge

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' \

Neuer Positionsumsatzbetrag

  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' \

Beispielantwort

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

Parameterreferenz

AccountId

Der API-Konto-ID-Wert Ihres impact.com-Kontos. Erfahren Sie, wie Sie diesen Wert finden.

AuthToken

Der API-Autorisierungstoken-Wert Ihres impact.com-Kontos. Erfahren Sie, wie Sie diesen Wert finden.

ActionId

Der ID-Wert der zu ändernden Aktion.

Sku

Der Stock-Keeping-Unit-Wert (SKU) der Position – diesen finden Sie beim Abrufen einer Aktion über die API.

Quantity

Der neue Mengenwert für die Position.

Grund

Beim Rückgängigmachen oder Ändern einer Position geben Sie immer ORDER_UPDATE als Grund an.

Amount

Der neue Umsatzbetragwert für die Position.

Positionen in einer Aktion über die API rückgängig machen

Wenn Sie auf Positionsebene verfolgen (d. h. Positionsdaten beim Melden von Conversions übergeben), können Sie die API verwenden, um eine oder mehrere Positionen rückgängig zu machen, indem Sie Quantity auf 0.

Um Positionen in einer Aktion rückgängig zu machen, benötigen Sie:

Die ActionId der Aktion.
Die Grund für die Aktualisierung der Aktion (bei Rückgängigmachung von Positionen in einer Aktion immer ORDER_UPDATE).
Die Sku der zu rückgängig machenden Position(en) (kann beim Abrufen einer Aktion über die API gefunden werden).
Die neue Quantity Wert für die Position – in diesem Fall 0

Sobald Sie all diese Werte haben, sehen Sie sich den Beispielaufruf unten an, um zu erfahren, wie Sie Positionen in einer Aktion rückgängig machen.

Beispielaufruf & Antwort

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'