Método: PUT /api/v1/advertiser/campaign/{id}
Descrição: Pode atualizar uma campanha publicitária criada através da API da sua conta HilltopAds.
Por favor, note que este método está disponível apenas para os formatos Popunder mobile e Popunder desktop.
Parâmetros:
nome | descrição | exemplo | comentário |
key | Uma chave de API exclusiva que pode gerar na secção API da sua conta HilltopAds | nXzgO3Bc | Este é um parâmetro obrigatório no pedido. |
campaignID | ID da campanha publicitária a atualizar
| 123456 | Pode especificar o ID de apenas uma campanha publicitária. Este é um parâmetro obrigatório no pedido. |
format | Formato publicitário a atualizar na campanha | Popunder móvel | Só é possível especificar um formato de publicidade. Este é um parâmetro obrigatório no pedido. |
rate | Preço por 1000 impressões (CPM). | 1.53 | Todos os preços (taxa) são especificados no pedido sem moeda, mas serão definidos em USD no resultado. Este é um parâmetro obrigatório no pedido. |
capTotal | Limite de frequência de impressões. Este parâmetro indica o número de vezes que um anúncio é apresentado. | 2 | Só é possível especificar um número. |
capResetAfter | Limite de frequência de impressões. Este parâmetro indica o tempo de apresentação do anúncio. | 12 | Só é possível especificar um número. |
capForCampaign | Limite de frequência de impressão. Este parâmetro indica se a regra se aplica à campanha ou ao banner. | campanha | Para o formato Popunder, só é possível especificar campaign. |
channels | Segmento e categoria de tráfego para os quais o anúncio deve ser atualizado. | Atividade elevada Mainstream/não-mainstream Atividade média A montante/não a montante Baixa atividade | Para especificar vários segmentos de atividade, enumere-os com vírgulas. Nota: só pode especificar uma categoria de tráfego - convencional ou não convencional. Este é um parâmetro obrigatório no pedido. |
type | Tipo de campanha publicitária | CPM, CPC | Tenha em atenção que, atualmente, só pode especificar o tipo de campanha CPM. Este é um parâmetro obrigatório no pedido. |
name | Nome de uma campanha publicitária. | Popunder_API | O nome da campanha deve ser único e não deve ser repetido com nomes de campanhas já criadas. Este é um parâmetro obrigatório no pedido. |
url | Oferecer a ligação URL para onde o tráfego deve ser enviado. | Só é possível especificar uma ligação. Este é um parâmetro obrigatório no pedido. | |
active | Especificar o estado da campanha actualizada: true - ON, false - OFF | Verdadeiro, falso | Se especificar o estado da campanha como Verdadeiro (ON), a campanha só ficará ativa após moderação. |
targeting | Definições de segmentação necessárias para a campanha publicitária. | geo navegador os dispositivo transportadora móvel intervalo osversões Aplicação | Estes parâmetros são passados como um objeto. Cada novo parâmetro de seleção é especificado com uma vírgula. |
Exemplo de pedido:
Para atualizar os seguintes parâmetros na campanha publicitária criada com o ID 123456:
Taxa - para $2.53
Frequência de exibição - até 1 exibição por 24 horas para a campanha
URL - para https://mywebsit2.com
Tenha em atenção que, se a sua ligação contiver o símbolo "&", tem de a codificar para o formato codificado por URL. Caso contrário, poderá receber um erro na resposta ao pedido de alteração da ligação.
Por exemplo, a ligação
https://mywebsite.com/?token={{ctoken}}&zone={{{zone_id}}deve ser especificado como
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Para codificar o seu link para o formato codificado por URL, pode utilizar a ferramenta.
É necessário escrever um pedido no seguinte 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