Modifier ou annuler par lot via l'API

Suivez la formation 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’annuler), en changeant le montant de commission de l’action.

Quelle méthode de soumission vous convient le mieux ?

Si vous voulez...	Utilisez cette méthode...
Soumettez un fichier manuel, ponctuel, sans code	​E-mail traitement par lots ou téléverser un fichier via FTP
Configurer le reporting automatisé des conversions	​Conversions / Actions API, envoyer un fichier via FTP, ou récupérer un fichier via FTP

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 sa ActionId valeur. Vous pourrez 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.
• Limites de débit s’appliquent.
• Consultez le Lister toutes les actions Consultez la documentation du point de terminaison de l’API pour en savoir plus.

FAQ

Comment réinitialiser une modification / annulation apportée à 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 réinitialisées via le RESET code peuvent ne pas s’afficher correctement dans les rapports (par ex., les valeurs de revenus peuvent être calculées incorrectement).

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

Les deux Codes de disposition et Motifs sont utilisés dans le même contexte — Motifs sont des codes prédéfinis que l’API acceptera par défaut, tandis que 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 :

Code	Description
CONS_FRAUD	Fraude du consommateur
CONS_ERROR	Erreur du consommateur
ITEM_RETURNED	L’article a été retourné
APPROVED	L’action est approuvée Remarque : Si vous essayez d’approuver des actions, Approuver doit être défini comme un code de disposition personnalisé.
ORDER_ERROR	Erreur de commande
ORDER_UPDATE	La commande a été mise à jour
PUB_ACT_DISPUTE	Litige d’activité partenaire
ADV_ACT_DISPUTE	Litige d’activité de la marque
NOT_COMPLIANCE_TERMS	Non conforme aux conditions
ITEM_OUT_OF_STOCK	L’article est en rupture de stock
TEST_ACTION	Action de test
PARTNER_NOT_ACTIVE	Compte partenaire désactivé
CREDITED_DIFFERENT_MP	Crédité à un autre partenaire
AUTRE	Autre raison

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

Vous pouvez utiliser des 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 la valeur est différente de celle d’un ActionId valeur — vous devez utiliser la ActionUpdatesID valeur pour récupérer les mises à jour d’une action.