Übersicht: Stapelverarbeitung von Rückbuchungen via API (Web Services)

Nehmen Sie am PXA-Kurs teil

Wenn sich an einer Aktion etwas ändert (z. B. eine Bestellung storniert wurde, ein Artikel zurückgegeben wurde usw.), können Sie die API verwenden, um sie zu ändern (oder rückgängig zu machen) und den Provisionsbetrag für die Aktion anzupassen. In diesem Artikel zeigen wir, wie man eine Aktion mit cURL-Aufrufen an die impact.com Brand API ändert und rückgängig macht.

Optionen zur Stapelverarbeitung von Rückgängen:

• Ein oder mehrere Artikel einer Aktion per API ändern oder rückgängig machen

• Eine gesamte Aktion per API rückgängig machen

Voraussetzung: Rufen Sie den ActionId Wert

Um eine Aktion rückgängig zu machen, benötigen Sie deren ActionId Wert. Der untenstehende Aufruf ruft alle Aktionen für eine bestimmte Program (d. h., Kampagne) ab — Sie können dies verwenden, um die Aktion zu finden, die Sie ändern möchten.

• Sie können in Ihrem Aufruf einen Datumsbereich angeben — andernfalls zeigt der Endpunkt standardmäßig die letzten 30 Tage an Aktionen an.

• Rate-Limits gelten.

• Siehe die Alle Aktionen auflisten API-Endpunktdokumentation, um mehr zu erfahren.

Parameterreferenz

Parameter	Beschreibung
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.
CampaignId	Der ID-Wert des Programms (Kampagne), unter dem die Aktion nachverfolgt wurde.

Beispielaufruf

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -d 'CampaignId={CampaignId}'

Beispielantwort

FAQs

Wie setze ich eine Änderung / einen Rückgang, der an einer Aktion (oder Aktionsartikeln) vorgenommen wurde, zurück?

Wenn eine Aktion vor ihrem Sperrdatum geändert oder rückgängig gemacht wurde, können Sie RESET als Grund übermitteln, um die Aktion wieder in ihren Standardzustand zu versetzen:

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'

Aktionen, die über den RESET Code zurückgesetzt wurden, werden in den Berichten möglicherweise nicht korrekt angezeigt (z. B. können Umsatzwerte falsch berechnet werden).

Was ist der Unterschied zwischen einem Disposition-Code und einem Grund?

Sowohl Disposition-Codes als auch Gründe werden im gleichen Kontext verwendet — Gründe sind vordefinierte Codes, die die API standardmäßig akzeptiert, während Disposition-Codes benutzerdefinierte Gründe sind, die Sie konfigurieren können. Erfahren Sie mehr über Disposition-Codes.

Das Übermitteln eines dieser Werte als Grund wird den Artikel (oder die Aktion) rückgängig machen:

Code	Beschreibung
CONS_FRAUD	Betrug durch Verbraucher
CONS_ERROR	Fehler des Verbrauchers
ITEM_RETURNED	Artikel zurückgegeben
ORDER_ERROR	Bestellfehler
ORDER_UPDATE	Bestellung wurde aktualisiert
PUB_ACT_DISPUTE	Partneraktivitätsstreit
ADV_ACT_DISPUTE	Streitigkeit über Werbetreibenden-Aktivität
NOT_COMPLIANCE_TERMS	Nicht konform mit den Bedingungen
ITEM_OUT_OF_STOCK	Artikel ist nicht vorrätig
TEST_ACTION	Testaktion
PARTNER_NOT_ACTIVE	Partnerkonto deaktiviert
CREDITED_DIFFERENT_MP	Gutschrift an einen anderen Partner
OTHER	Anderer Grund
ITEM_CANCELLED	Artikel in Bestellung wurde storniert

Wie kann ich sehen, wann Änderungen / Rückgänge auf eine Aktion angewendet wurden?

Sie können die Action-Updates Endpunkt, um zu sehen, wann eine Aktion zuletzt aktualisiert wurde und welchen aktuellen Status sie hat.

curl 'https://api.impact.com/Advertisers/{AccountSID}/ActionUpdates/{ActionUpdatesId}' \
  -X GET \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \

Hinweis: Eine ActionUpdatesID Wert unterscheidet sich von einem ActionId Wert — Sie müssen den ActionUpdatesID Wert verwenden, um Updates für eine Aktion abzurufen.