Modificar o revertir elementos de una acción vía API

Además de modificar y revertir acciones, impact.com le permite modificar y revertir los detalles a nivel de artículo de una acción.

Nota: impact.com permite un máximo de 1000 modificaciones por acción. Si necesita realizar más modificaciones después de eso, contacte con el soporte.

Modificar artículos en una acción mediante API

Si realiza seguimiento a nivel de artículo (es decir, pasando datos de artículos al informar conversiones), puede usar la API para modificar la cantidad o el importe de ingresos informado de los artículos dentro de una acción.

Para modificar artículos en una acción, necesitará:

El ActionId de la acción.
El Razón para actualizar la acción (cuando modifique artículos en la acción, siempre envíe ORDER_UPDATE).
El Sku del(los) artículo(s) a modificar (puede encontrarse al recuperar una acción mediante la API).
El nuevo Quantity valor para el artículo.
El nuevo importe de Amount valor para el artículo: incluya esto en la llamada solo si este valor está cambiando (por ejemplo, si la cantidad de ingresos del artículo se informó incorrectamente).

Una vez que tenga todos estos valores, vea las llamadas de ejemplo a continuación para aprender cómo modificar un artículo dentro de una acción.

Llamadas de ejemplo y respuesta

Nueva cantidad de artículo

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' \

Nuevo importe de ingresos del artículo

  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' \

Respuesta de ejemplo

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

Referencia de parámetros

AccountId

El valor del ID de cuenta de API de su cuenta de impact.com. Aprenda cómo encontrar este valor.

AuthToken

El valor del token de autorización de API de su cuenta de impact.com. Aprenda cómo encontrar este valor.

ActionId

El valor ID de la acción que se va a modificar.

Sku

El valor de unidad de mantenimiento de existencias (SKU) del artículo: esto puede encontrarse al recuperar una acción mediante la API.

Quantity

El nuevo valor de cantidad para el artículo.

Razón

Al revertir o modificar un artículo, siempre envíe ORDER_UPDATE como la razón.

Amount

El nuevo valor del importe de ingresos para el artículo.

Revertir artículos en una acción mediante API

Si realiza seguimiento a nivel de artículo (es decir, pasando datos de artículos al informar conversiones), puede usar la API para revertir uno o más artículos estableciendo Quantity a 0.

Para revertir artículos en una acción, necesitará:

El ActionId de la acción.
El Razón para actualizar la acción (cuando revierta artículos en la acción, siempre envíe ORDER_UPDATE).
El Sku del(los) artículo(s) que se van a revertir (puede encontrarse al recuperar una acción mediante la API).
El nuevo Quantity valor para el artículo: en este caso, 0

Una vez que tenga todos estos valores, vea la llamada de ejemplo a continuación para aprender cómo revertir artículos en una acción.

Llamada de ejemplo y respuesta

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'