Procesamiento en lote de reversos vía API (servicios web) - descripción general

Realiza el curso PXA

Si algo de una acción cambia (por ejemplo, se canceló un pedido, se devolvió un artículo, etc.), puedes usar la API para modificarla (o revertirla), cambiando la cantidad de comisión por la acción. En este artículo, mostraremos cómo modificar y revertir una acción con llamadas cURL a la API de Marca de impact.com.

Opciones de reversión por proceso por lotes:

• Modificar o revertir uno o más artículos en una acción vía API

• Revertir una acción completa vía API

Prerequisito: Recuperar el ActionId valor

Para revertir una acción, necesitarás su ActionId valor. La llamada a continuación recuperará todas las acciones para un Programa (es decir, Campaña) — puedes usar esto para encontrar la acción que deseas modificar.

• Puedes especificar un rango de fechas en tu llamada — de lo contrario, el endpoint mostrará por defecto los últimos 30 días de acciones.

• Se aplican límites de velocidad .

• Ver el Listar todas las acciones Documentación del endpoint de la API para aprender más.

Referencia de parámetros

Parámetro	Descripción
AccountId	El valor del ID de la cuenta API de su cuenta de impact.com. Aprenda cómo encontrar este valor.
AuthToken	El valor del token de autorización de la API de su cuenta de impact.com. Aprenda cómo encontrar este valor.
IdCampaña	El valor ID del programa (campaña) bajo el cual se rastreó la acción.

Llamada de ejemplo

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

Respuesta de ejemplo

Preguntas frecuentes

¿Cómo restablezco una modificación/reversión realizada a una acción (o artículos de la acción)?

Si una acción ha sido modificada o revertida antes de su fecha de bloqueo, puedes enviar RESET como razón para actualizar la acción a su estado predeterminado:

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'

Las acciones que han sido restablecidas mediante el RESET código pueden no aparecer correctamente en los informes (por ejemplo, los valores de ingresos pueden calcularse incorrectamente).

¿Cuál es la diferencia entre un código de disposición y una razón?

Tanto los Códigos de Disposición como las Razones se usan en el mismo contexto — Las razones son códigos predefinidos que la API aceptará por defecto, mientras que Los códigos de disposición son razones personalizadas que puedes configurar. Aprende más sobre los códigos de disposición.

Enviar cualquiera de estos valores como razón revertirá el artículo (o la acción):

Código	Descripción
CONS_FRAUD	Fraude del consumidor
CONS_ERROR	Error del consumidor
ITEM_RETURNED	Artículo devuelto
ORDER_ERROR	Error del pedido
ORDER_UPDATE	El pedido fue actualizado
PUB_ACT_DISPUTE	Disputa de actividad del socio
ADV_ACT_DISPUTE	Disputa de actividad del anunciante
NOT_COMPLIANCE_TERMS	No cumple con los términos
ITEM_OUT_OF_STOCK	El artículo está agotado
TEST_ACTION	Acción de prueba
PARTNER_NOT_ACTIVE	Cuenta del socio desactivada
CREDITED_DIFFERENT_MP	Acreditado a otro socio
OTHER	Otro motivo
ITEM_CANCELLED	Artículo en el pedido fue cancelado

¿Cómo puedo ver cuándo se aplican las modificaciones/reversiones a una acción?

Puede usar los actualizaciones de acción endpoint para ver cuándo se actualizó por última vez una acción y cuál es su estado actual.

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

Nota: Un ActionUpdatesID valor es diferente de un ActionId valor — debes usar el ActionUpdatesID valor para recuperar actualizaciones de una acción.