Método: POST /api/v1/anunciante/campaña
Descripción: Puedes crear una campaña publicitaria vía API para tu cuenta publicitaria de HilltopAds.
Tenga en cuenta que este método solo está disponible para los formatos Popunder mobile y Popunder desktop.
Parámetros:
nombre | descripción | ejemplo | comentario |
key | Una clave API única que puede generar en la sección API de su cuenta HilltopAds | nXzgO3Bc | Se trata de un parámetro obligatorio en la solicitud. |
format | Formato publicitario para el que debe crearse la campaña. | Popunder móvil | Sólo puede especificar un formato de publicidad. Se trata de un parámetro obligatorio en la solicitud. |
rate | Precio por 1000 impresiones (CPM). | 1.53 | Todos los precios (tarifa) se especifican en la solicitud sin divisa, pero se establecerán en USD en el resultado. Se trata de un parámetro obligatorio en la solicitud. |
capTotal | Límite de frecuencia de impresión. Este parámetro indica el número de veces que se muestra un anuncio. | 2 | Sólo puede especificar un número. |
capResetAfter | Límite de frecuencia de impresión. Este parámetro indica durante cuánto tiempo mostrar el anuncio. | 12 | Sólo puede especificar un número. |
capParaCampaña | Límite de frecuencia de impresión. Este parámetro indica si la regla se aplica a la campaña o al banner. | campaña | Para el formato Popunder, sólo puede especificar campaña. |
channels | Segmento y categoría de tráfico para los que debe lanzarse el anuncio. | Corriente principal/no corriente Actividad elevada Principal/no principal Actividad media Principal/no principal Baja actividad | Para especificar varios segmentos de actividad, enumérelos con comas. Tenga en cuenta que sólo puede especificar una categoría de tráfico: principal o no principal. Se trata de un parámetro obligatorio en la solicitud. |
type | Tipo de campaña publicitaria | CPM, CPC | Tenga en cuenta que actualmente sólo puede especificar el tipo de campaña CPM. Se trata de un parámetro obligatorio en la solicitud. |
name | Nombre de una campaña publicitaria. | Popunder_API | El nombre de la campaña debe ser único y no repetirse con nombres de campañas ya creadas. Se trata de un parámetro obligatorio en la solicitud. |
url | Ofrezca el enlace URL al que debe enviarse el tráfico. | Sólo puede especificar un enlace. Se trata de un parámetro obligatorio en la solicitud. | |
active | Especifique el estado de la campaña creada: true - ON, false - OFF. | Verdadero, falso | Cuando se especifica el estado de la campaña como Verdadero (ON), la campaña se activará sólo después de la moderación. |
targeting | Ajustes de segmentación necesarios para la campaña publicitaria.
| geo navegador os dispositivo operador móvil iprange osversiones Aplicación | Estos parámetros se pasan como un objeto. Cada nuevo parámetro de destino se especifica con una coma. |
Ejemplo de solicitud:
Para crear una campaña publicitaria con los siguientes parámetros:
Formato del anuncio - Popunder mobile
Tarifa - 1,53 $.
Frecuencia de taponamientos - 2 visualizaciones cada 12 horas para la campaña
Canales - actividad principal alta и actividad media
Tipo - CPM (para un formato de anuncio Popunder puede especificar sólo CPM).
Nombre - Popunder_API
URL - https://mywebsite.com.
Activo - Verdadero
Objetivos - GEO: US, UK, DE; Navegador: Chrome, Safary; Dispositivo: móvil
Tenga en cuenta que si su enlace contiene el símbolo '&', deberá codificarlo en formato URL codificado. De lo contrario, puede recibir un error en la respuesta a la solicitud de cambio de enlace.
Por ejemplo, el enlace
https://mywebsite.com/?token={{ctoken}}&zone={zone_id}}debe especificarse como
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Para codificar su enlace en formato URL, puede utilizar la herramienta.
Debe escribir una solicitud con el siguiente formato:
curl -X POST --data '{"format": "Popunder mobile", "channels":["Mainstream High Activity", "Mainstream Medium Activity"], "type": "CPM", "rate":1.53, "name": "Popunder_API", "url": "https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D", "active":true, "capTotal":2, "capResetAfter":12, "capForCampaign": "campaign", "targeting":{"geo":{"operator": "in", "operand":["US", "UK", "DE"]}, "browser":{"operator": "in", "operand":["Chrome", "Safary"]}, "device":{"operator": "in", "operand":["Mobile/smartphone"]}}}' https://hilltopads.com/api/v1/anunciante/campaña?key=nXzgO3Bc