¿Cómo crear una campaña publicitaria usando la API?
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. |
limitImpressionsTotal | Especificar el número Total de Impresiones Límite | 200000 | Sólo puede especificar un número. |
limitImpressionsDaily | Especificar el Límite de Impresiones Diarias | 20000 | Sólo puede especificar un número. El min. impresiones diarias límite es de 15.000. |
limitBudgetTotal | Especificar el Presupuesto Total del Límite de | 2000 | Sólo puede especificar un número. |
limitBudgetDaily | Especificar el Límite de Presupuesto Diario | 50 | Sólo puede especificar un número. El min. presupuesto diario límite es de $20. |
filters | Usted puede permitir/no permitir Proxy y WebView tráfico de filtros. | Proxy WebView | Estos parámetros se pasan como un objeto. |
targeting | Se requiere la configuración de orientación para la campaña de publicidad.
| geo navegador os dispositivo operadormóvil iprange osversions Aplicación | Estos parámetros se pasan como un objeto. Cada nueva orientación parámetro se especifica con una coma. |
uniformDistributionDaily | Elija cómo la campaña de los límites debe ser alcanzado. | ASAP De manera uniforme | Asap – llegar a la especificada campaña de límites tan pronto como sea posible |
Targeting object
Name | Example | Description |
geo | US GB AU | Enter the two-letter code of the required country/countries, separated by commas. |
browser | Chrome FireFox Safari |
|
os | Android iOS |
|
device | mobile/smartphone tablet |
|
mobilecarrier | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Win 7 |
All available versions |
App |
|
Targeting object
Name | Example |
Proxy | Allow Disallow Only |
WebView | Allow Disallow Only |
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://api.hilltopads.com/v1/anunciante/campaña?key=nXzgO3Bc¡Aprovecha todo el potencial de la API de la red publicitaria de HilltopAds!