Modifier ou inverser des éléments d'une action via l'API

En plus de modifier et d'annuler des actions, impact.com vous permet de modifier et d'annuler les détails au niveau des articles d'une action.

Remarque : impact.com autorise un maximum de 1000 modifications par action. Si vous devez effectuer d'autres modifications par la suite, contacter le support.

Modifier les articles d'une action via l'API

Si vous suivez au niveau des articles (c.-à-d. en transmettant les données des articles lors du signalement des conversions), vous pouvez utiliser l'API pour modifier la quantité ou le montant de revenu déclaré des articles au sein d'une action.

Pour modifier les articles d'une action, vous aurez besoin de :

• Le ActionId de l'action.

• Le Raison de la mise à jour de l'action (lors de la modification des articles d'une action, soumettez toujours ORDER_UPDATE).

• Le Sku des articles à modifier (peut être trouvé lors de la récupération d'une action via l'API).

• La nouvelle Quantity valeur pour l'article.

• Le nouveau Amount valeur de revenu pour l'article — inclure ceci dans l'appel uniquement si cette valeur change (par ex., le montant de revenu d'article déclaré a été signalé de manière incorrecte).

Une fois que vous avez toutes ces valeurs, consultez les exemples d'appels ci-dessous pour apprendre comment modifier un article au sein d'une action.

Exemples d'appels et réponse

Nouvelle quantité d'article

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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \

Nouveau montant de revenu par article

  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \

Exemple de réponse

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}

Référence des paramètres

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.
ActionId	La valeur ID de l'action à modifier.
Sku	La valeur du stock-keeping unit (SKU) de l'article — elle peut être trouvée lors de la récupération d'une action via l'API.
Quantity	La nouvelle valeur de quantité pour l'article.
Raison	Lors de l'annulation ou de la modification d'un article, soumettez toujours ORDER_UPDATE comme raison.
Amount	La nouvelle valeur du montant de revenu pour l'article.

Annuler des articles d'une action via l'API

Si vous suivez au niveau des articles (c.-à-d. en transmettant les données des articles lors du signalement des conversions), vous pouvez utiliser l'API pour annuler un ou plusieurs articles en définissant Quantity à 0.

Pour annuler des articles d'une action, vous aurez besoin de :

• Le ActionId de l'action.

• Le Raison pour la mise à jour de l'action (lors de l'annulation d'articles d'une action, soumettez toujours ORDER_UPDATE).

• Le Sku des articles à annuler (peut être trouvé lors de la récupération d'une action via l'API).

• La nouvelle Quantity valeur pour l'article — dans ce cas, 0

Une fois que vous avez toutes ces valeurs, consultez l'exemple d'appel ci-dessous pour apprendre comment annuler des articles d'une action.

Exemple d'appel et réponse

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 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'

Exemple de réponse

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}  

Référence des paramètres

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.
ActionId	La valeur ID de l'action à modifier.
Sku	La valeur du stock-keeping unit (SKU) de l'article — elle peut être trouvée lors de la récupération d'une action via l'API.
Quantity	La nouvelle valeur de quantité pour l'article.
Raison	Lors de l'annulation ou de la modification d'un article, soumettez toujours ORDER_UPDATE comme raison.