Como criar uma campanha publicitária usando a API?
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. |
limitImpressionsTotal | Especificar o Total de Impressões Limite | 200000 | Você pode especificar apenas um número. |
limitImpressionsDaily | Especificar o Limite de Impressões Diárias | 20000 | Você pode especificar apenas um número. O min. impressões diárias limite é de 15.000. |
limitBudgetTotal | Especificar o Limite do Orçamento Total | 2000 | Você pode especificar apenas um número. |
limitBudgetDaily | Especificar o Limite de Orçamento Diário | 50 | Você pode especificar apenas um número. O min. limite de orçamento diário é de r $20. |
filters | Você pode permitir/não permitir Proxy e modo de exibição da web filtros de tráfego. | Proxy Modo de exibição da web | Estas parâmetro é passado como um objeto. |
targeting | Necessária configurações de segmentação para campanhas publicitárias.
| geo navegador os dispositivo mobilecarrier iprange osversions Aplicação | Esses parâmetros são passados como um objeto. Cada nova segmentação parâmetro é especificado com uma vírgula. |
uniformDistributionDaily | Escolha a forma como a campanha de limites deve ser alcançado. | ASAP Evenly | ASAP alcançar o especificado campanha de limites tão rapidamente quanto possível |
Segmentação objeto
Nome | Exemplo | Descrição |
geo | EUA GB AU | Insira o código de duas letras do país/países, separados por vírgulas. |
navegador | Chrome FireFox Safari |
|
os | Android iOS |
|
dispositivo | celular/smartphone tablet |
|
mobilecarrier | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Ganhar 7 |
Todas as versões disponíveis |
Aplicação |
|
Segmentação objeto
Nome | Exemplo |
Proxy | Permitir Não permitir Apenas |
Modo de exibição da web | Permitir Não permitir Apenas |
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://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3BcDesbloqueie todo o potencial da API da rede de anúncios HilltopAds!