Método: POST /api/v1/advertiser/campaign
Descrição: Pode criar uma campanha publicitária através da API para a sua conta de publicidade 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 ser gerada na secção API da sua conta HilltopAds | nXzgO3Bc | Este é um parâmetro obrigatório no pedido. |
format | Formato publicitário para o qual a campanha deve ser criada. | 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 lançado. | 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 | Especifique o estado da campanha criada: 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 criar uma campanha publicitária com os seguintes parâmetros:
Formato do anúncio - Popunder móvel
Taxa - 1,53
Frequência das capas - 2 capas por cada 12 horas para a campanha
Canais - mainstream alta atividade и média atividade
Type - CPM (para um formato de anúncio Popunder, pode especificar apenas CPM)
Nome - Popunder_API
URL - https://mywebsite.com.
Ativo - Verdadeiro
Direcionamento - GEO: US, UK, DE; Browser: Chrome, Safary; Dispositivo - móvel
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 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/advertiser/campaign?key=nXzgO3Bc