API de creación de oferta

POST https://api.offer18.com/api/m/offers

🔗 Haga clic para probar la API de creación de oferta

Parámetros comunes

Consulta	Tipo	Descripción
mid	Entero	ID de cuenta de la red
api-key	Cadena	Clave API de la red
secret-key	Cadena	Clave secreta de la red

Acción

Consulta	Tipo	Descripción
action	Cadena	Valores permitidos: crear / actualizar / eliminar
offer_id	Entero	Requerido en la actualización y eliminación de la oferta

---

Campos

Cuerpo	Tipo	Descripción
offer_name	Cadena	Nombre de la campaña
advertiser_id	Entero	ID del anunciante
offer_url	URL	URL de la campaña
external_offer_id	Cadena	ID de la campaña externa (si la hay)
app_id	Cadena	ID de la aplicación (si la hay)
logo	URL	URL del logotipo de la campaña
category	Cadena	Categoría de la campaña
preview_url	URL	URL de vista previa de la campaña
currency	Cadena	Moneda de la oferta 🔗 Ver monedas
price_advertiser	Decimal	Precio dado por el anunciante para la campaña
price_affiliate	Decimal	Precio dado al afiliado para la campaña
model_advertiser	Cadena	Modelo de anunciante de la campaña 🔗 Ver modelos
model_affiliate	Cadena	Modelo de anunciante de la campaña 🔗 Ver modelos
hide_affiliate_payout	Entero	Valores permitidos 1: Para ocultar el pago al afiliado
start_datetime	Marca de tiempo UTC	Fecha / hora de inicio (YYYY-MM-DD HH:MM:SS)
end_datetime	Marca de tiempo UTC	Fecha / hora de fin (YYYY-MM-DD HH:MM:SS )
visibility	Cadena	Valores permitidos: público, permiso, privado
status	Cadena	Valores permitidos: aprobado, pendiente
deep_links	Entero	Valores permitidos 1: Para habilitar enlaces profundos en las ofertas
offer_terms	Cadena	Términos de la campaña
offer_kpi	Cadena	Términos KPI de la campaña
private_note	Cadena	Notas privadas en la campaña
imps_url	URL	URL de impresión
landing_page_id_1	Entero	En caso de que el usuario quiera actualizar la página de destino existente
landing_page_name_1	Cadena	Nombre de la primera página de destino
landing_page_url_1	URL	URL de la primera página de destino de la campaña
landing_page_id_2	Entero	En caso de que el usuario quiera actualizar la página de destino existente
landing_page_name_2	Cadena	Nombre de la segunda página de destino
landing_page_url_2	URL	URL de la segunda página de destino de la campaña
creatives	URL	URL de los creativos de la campaña
fallback	booleano	Valores permitidos: 1: Para habilitar el respaldo
fallback_offer_id	Entero	ID de la oferta de respaldo
fallback_url	URL	URL de respaldo
fraud_conv_speed	Entero	Tiempo en segundos
proxy_block	Entero	Valores permitidos: 1: Para bloquear proxies
blank_ref_block	Entero	Valores permitidos: 1: Para bloquear referencias en blanco
hide_referral	Entero	Valores permitidos: 1: Para ocultar la referencia
assign_affiliates	Entero	Asignar afiliados a esta campaña (valores separados por comas)
capping_rule_id	Entero	En caso de que el usuario quiera actualizar la regla de límite existente
capping[0][capping_rule_name]	Cadena	Nombre de la regla de límite
capping[0][capping_rule_type]	Cadena	Tipo de regla de límite 1. advertiser_capping 2. affiliate_capping
capping[0][capping_timezone]	Marca de tiempo	Zona horaria del límite
capping[0][capping_events]	Cadena	Eventos del límite
capping[0][capping_type]	Cadena	Tipo de límite 1. gross_conversions 2. approved_conversions 3. gross_revenue 4. approved_revenue 5. gross_payout 6. approved_payout 7. gross_clicks 8. approved_clicks
capping[0][capping_period]	Cadena	Periodo del límite 1. diario 2. semanal 3. mensual 4. por hora
capping[0][capping_value]	Entero	Valor del límite
capping[0][overcap_action]	Cadena	Acción al superar el límite 1. detener 2. fallback 3. fallback_conversion_accept 4. conversion_accept 5. conversion_reject 6. conversion_pending
capping[0][capping_notification_email]	Cadena	Correo electrónico de notificación del límite
capping[0][capping_affiliate_visibility]	Entero	1: Para mostrar la regla de límite al afiliado
capping[0][capping_affiliate_id]	Cadena	IDs de afiliado (separados por comas)
targeting_rule_id	Entero	En caso de que el usuario quiera actualizar la regla de segmentación existente
target_country	Cadena	Permitir país específico 🔗 Ver países
block_country	Cadena	Bloquear país específico 🔗 Ver países
target_os	Cadena	Permitir sistema operativo específico 🔗 Ver SO
block_os	Cadena	Bloquear sistema operativo específico 🔗 Ver SO
target_device	Cadena	Permitir dispositivos específicos 🔗 Ver dispositivos
block_device	Cadena	Bloquear dispositivos específicos 🔗 Ver dispositivos
target_browser	Cadena	Permitir navegador específico 🔗 Ver navegadores
block_browser	Cadena	Bloquear navegador específico 🔗 Ver navegadores
target_isp	Cadena	Permitir ISP específico
block_isp	Cadena	Bloquear ISP específico
events[0][event_name]	Cadena	Nombre del evento
events[0][event_token]	Cadena	Token del evento
capping_conversion_period	Cadena	En desuso
capping_budget	Entero	En desuso
capping_conversion	Entero	En desuso
capping_budget_period	Cadena	En desuso

Reglas de límite (Instrucciones)

1. Si desea establecer múltiples reglas de límite, puede hacerlo asignando las reglas a diferentes números Ejemplo 1: capping[1][capping_rule_name] capping[1][capping_rule_type] Ejemplo 2: capping[2][capping_rule_name] capping[2][capping_rule_type]

2. Si desea actualizar una regla de límite existente, debe enviar capping_rule_id en la solicitud de la API junto con los nuevos datos a 0número (cero) Ejemplo: capping[0][capping_rule_name] capping[0][capping_rule_type]

Eventos (Instrucciones)

1. Si desea crear múltiples eventos, puede hacerlo asignando eventos a diferentes números Ejemplo 1: events[1][event_name] events[1][event_token] Ejemplo 2: events[2][event_name] events[2][event_token]

---

Ejemplo de solicitud de API

Creación de oferta

Respuesta de la API

{
    "status": "200",
    "response": "offer_created_successfully",
    "offer_id": 000012    
}

Actualización de oferta

Respuesta de la API

{
    "status": "200",
    "response": "offer_updated_successfully",
    "offer_id": "000001"
}

---

Para interacciones seguras, llame siempre a la API desde el lado del servidor.