Aperçu du traitement en masse des revers via API (services Web)

Suivre 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), en changeant le montant de la commission pour l'action. Dans cet article, nous montrons comment modifier et annuler une action avec des appels cURL à l'API Brand d'impact.com.

Options de traitement par lot pour les annulations :

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

• Annuler une action entière via l'API

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

Pour annuler une action, vous aurez besoin de sa ActionId valeur. L'appel ci-dessous récupérera toutes les actions pour un Programme (c.-à-d., Campagne) — vous pouvez l'utiliser pour trouver l'action que vous voulez modifier.

• 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 la Lister toutes les actions Documentation du point de terminaison API pour en savoir plus.

Référence du paramètre

Paramètre	Description
AccountId	La valeur de l'ID de compte API de votre compte impact.com. Apprenez comment trouver cette valeur.
AuthToken	La valeur du jeton d'autorisation API de votre compte impact.com. Apprenez comment trouver cette valeur.
CampaignId	La valeur ID du programme (campagne) sous lequel l'action a été suivie.

Exemple d'appel

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

Exemple de réponse

FAQ

Comment réinitialiser une modification / annulation effectuée sur une action (ou des articles 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 à 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 incorrectement).

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

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

Soumettre l'une de ces valeurs comme raison annulera l'article (ou l'action) :

Code	Description
CONS_FRAUD	Fraude consommateur
CONS_ERROR	Erreur du consommateur
ITEM_RETURNED	Article retourné
ORDER_ERROR	Erreur de commande
ORDER_UPDATE	La commande a été mise à jour
PUB_ACT_DISPUTE	Litige d'activité partenaire
ADV_ACT_DISPUTE	Contestation d'activité par l'annonceur
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
OTHER	Autre raison
ITEM_CANCELLED	Article dans la commande annulé

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

Vous pouvez utiliser les 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.

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

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