Modifier ou annuler par lot via l’API

Suivez le cours PXA

Si quelque chose concernant une action change (par exemple, une commande a été annulée, un article a été retourné, etc.), vous pouvez utiliser l’API pour la modifier (ou l’inverser), en modifiant le montant de la commission pour l’action.

Quelle méthode de soumission vous convient le mieux ?

Options d’annulation via l’API :

• 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 la ActionId valeur

Pour modifier les données d’une action via l’API, vous aurez besoin de son 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 actions des 30 derniers jours.

• Des limites de débit s’appliquent.

• Consultez le Lister toutes les actions documentation du point de terminaison de l’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 motif pour remettre l’action à 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 exemple, les valeurs de revenus peuvent être calculées de manière incorrecte).

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

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

Codes de motif pris en charge :

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

Vous pouvez utiliser les mises à jour des actions 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 la ActionUpdatesID valeur pour récupérer les mises à jour d’une action.