Método: PUT /api/v1/advertiser/campaign/{id}
Descripción: Puede actualizar una campaña publicitaria creada a través de la API de su cuenta HilltopAds.
Tenga en cuenta que este método solo está disponible para los formatos Popunder móvil y Popunder escritorio.
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. |
campaignID | ID de la campaña publicitaria que debe actualizarse
| 123456 | Puede especificar el ID de una sola campaña publicitaria. Se trata de un parámetro obligatorio en la solicitud. |
format | Formato publicitario que se actualizará en 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 actualizarse 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 actualizada: 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 actualizar los siguientes parámetros en la campaña publicitaria creada con el ID 123456:
Tarifa - a 2,53 $.
Frecuencia tapones - a 1 visualización cada 24 horas para campaña
URL - a https://mywebsit2.com
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 PUT --data '{"rate": "2.53", "capTotal":1, "capResetAfter":24, "capForCampaign": "campaign", "url": "https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D"}' https://hilltopads.com/api/v1/advertiser/campaign/123456?key=nXzgO3Bc