Modifier ou inverser par lot via l'API (Web Services)

Suivez le cours PXA

Si quelque chose concernant une action change (par ex. une commande a été annulée, un article a été retourné, etc.), vous pouvez utiliser l'API pour la modifier (ou l'annuler), changeant ainsi le montant de la commission pour l'action.

Options de traitement par lot pour les annulations :

• Modifier ou annuler un ou plusieurs éléments d'une action via l'API

• Annuler une action entière via l'API

Prérequis : Récupérer le ActionId valeur

Pour modifier les données d'une action, vous aurez besoin de sa ActionId valeur. Vous pouvez ensuite l'utiliser pour trouver l'action que vous souhaitez modifier via l'API.

• Vous pouvez spécifier une plage de dates dans votre appel — sinon, le point de terminaison affiche par défaut les 30 derniers jours d'actions.

• Les limites de débit s'appliquent.

• Voir le Lister toutes les actions documentation du point de terminaison API pour en savoir plus.

FAQ

Comment réinitialiser une modification / annulation effectuée sur une action (ou des éléments d'action) ?

Si une action a été modifiée ou annulée avant sa date de verrouillage, vous pouvez soumettre RESET comme raison pour remettre l'action dans son état par défaut :

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'

Les actions qui ont été réinitialisées via le RESET code peuvent ne pas apparaître correctement dans les rapports (par ex. les valeurs de revenus peuvent être calculées de manière incorrecte).

Quelle est la différence entre un code de disposition et une raison ?

Les deux Codes de disposition et Raisons sont utilisés dans le même contexte — Raisons sont des codes prédéfinis que l'API acceptera par défaut, tandis que Codes de disposition sont des raisons personnalisées que vous pouvez configurer. En savoir plus sur les codes de disposition.

Codes de raison pris en charge :

Comment puis-je voir quand des modifications / annulations sont appliquées à une action ?

Vous pouvez utiliser le mises à jour d'action point de terminaison pour voir quand une action a été mise à jour pour la dernière fois et quel est son état actuel.

Remarque : Un ActionUpdatesID valeur est différente d'une ActionId valeur — vous devez utiliser le ActionUpdatesID valeur pour récupérer les mises à jour d'une action.