API de Creación de Ofertas

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

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

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
type	Cadena	Valores permitidos: create / update
oid	Entero	Requerido en la actualizació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 externo de la campaña (si corresponde)
app_id	Cadena	ID de la aplicación (si corresponde)
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 otorgado por el anunciante para la campaña
price_affiliate	Decimal	Precio otorgado al afiliado por 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 (AAAA-MM-DD HH:MM:SS)
end_datetime	Marca de tiempo UTC	Fecha/hora de finalización (AAAA-MM-DD HH:MM:SS )
visibility	Cadena	Valores permitidos: public, permission, private
status	Cadena	Valores permitidos: approve, pending
deep_links	Entero	Valores permitidos 1: Para habilitar deeplinks en 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_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_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 para la campaña
fallback	boolean	Valores permitidos: 1: Para habilitar fallback
fallback_offer_id	Entero	ID de la oferta de fallback
fallback_url	URL	URL de la alternativa
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 referencia 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	Cadena	En caso de que el usuario quiera actualizar una regla de limitación existente
capping[0][capping_rule_name]	Cadena	Nombre de la regla de limitación
capping[0][capping_rule_type]	Cadena	Tipo de regla de limitación 1. advertiser_capping 2. affiliate_capping
capping[0][capping_timezone]	Marca de tiempo	Zona horaria de la limitación
capping[0][capping_events]	Cadena	Eventos de limitación
capping[0][capping_type]	Cadena	Tipo de limitación 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 de limitación 1. daily 2. weekly 3. monthly 4. hourly
capping[0][capping_value]	Entero	Valor de la limitación
capping[0][overcap_action]	Cadena	Acción por sobrepaso 1. stop 2. fallback 3. fallback_conversion_accept 4. conversion_accept 5. conversion_reject 6. conversion_pending
capping[0][capping_notification_email]	Stirng	Correo electrónico de notificación de limitación
capping[0][capping_affiliate_visibility]	Entero	1: Mostrar la regla de limitación al afiliado
capping[0][capping_affiliate_id]	Stirng	IDs de afiliados (separados por comas)
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 sistemas operativos
block_os	Cadena	Bloquear sistema operativo específico 🔗 Ver sistemas operativos
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 para el evento
capping_conversion_period	Cadena	Obsoleto
capping_budget	Entero	Obsoleto
capping_conversion	Entero	Obsoleto
capping_budget_period	Cadena	Obsoleto

Reglas de limitación (Instrucciones)

1. Si desea establecer múltiples reglas de limitación, puede hacerlo asignando 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 limitación existente, debe publicar capping_rule_id en Solicitud API junto con los nuevos datos a 0(Cero) número 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 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, siempre llame a la API desde el lado del servidor.