Metod: POST /api/v1/advertiser/campaign
Açıklama: HilltopAds reklam hesabınız için API aracılığıyla bir reklam kampanyası oluşturabilirsiniz.
Lütfen bu yöntemin yalnızca Popunder mobile ve Popunder desktop biçimleri için kullanılabilir olduğunu unutmayın.
Parametreler:
isim | Açıklama | örnek | Yorum |
key | HilltopAds hesabınızın API bölümünde oluşturabileceğiniz benzersiz bir API anahtarı | nXzgO3Bc | Bu, istekte gerekli bir parametredir. |
format | Kampanyanın oluşturulması gereken reklam formatı. | Popunder mobil | Yalnızca bir reklam biçimi belirtebilirsiniz. Bu, istekte gerekli bir parametredir. |
rate | 1000 gösterim için fiyat (CPM). | 1.53 | Tüm fiyatlar (oran) talepte para birimi olmadan belirtilir, ancak sonuçta USD olarak ayarlanacaktır. Bu, istekte gerekli bir parametredir. |
capTotal | Gösterim sıklığı sınırı. Bu parametre, bir reklamın kaç kez gösterileceğini belirtir. | 2 | Yalnızca bir sayı belirtebilirsiniz. |
capResetAfter | Gösterim sıklığı sınırı. Bu parametre, reklamın ne kadar süreyle gösterileceğini belirtir. | 12 | Yalnızca bir sayı belirtebilirsiniz. |
capForCampaign | Gösterim sıklığı sınırı. Bu parametre, kuralın kampanya için mi yoksa banner için mi geçerli olduğunu gösterir. | kampanya | Popunder biçimi için yalnızca kampanya belirtebilirsiniz. |
channels | Reklamın başlatılması gereken segment ve trafik kategorisi. | Ana akım/ana akım olmayan Yüksek aktivite Ana akım/ana akım olmayan Orta faaliyet Ana akım/ana akım olmayan Düşük aktivite | Birden fazla faaliyet segmenti belirtmek için bunları virgülle listeleyin. Yalnızca bir trafik kategorisi belirtebileceğinizi unutmayın - ana akım veya ana akım olmayan. Bu, istekte gerekli bir parametredir. |
type | Reklam kampanyasının türü | CPM, CPC | Şu anda yalnızca CPM kampanya türünü belirtebileceğinizi lütfen unutmayın. Bu, istekte gerekli bir parametredir. |
name | Bir reklam kampanyasının adı. | Popunder_API | Kampanya adı benzersiz olmalı ve önceden oluşturulmuş kampanyaların adlarıyla tekrarlanmamalıdır. Bu, istekte gerekli bir parametredir. |
url | Trafiğin gönderilmesi gereken URL bağlantısını sunun. | Yalnızca bir bağlantı belirtebilirsiniz. Bu, istekte gerekli bir parametredir. | |
active | Oluşturulan kampanyanın durumunu belirtin: true - AÇIK, false - KAPALI. | Doğru, yanlış | Kampanya durumunu Doğru (AÇIK) olarak belirlediğinizde, kampanya yalnızca moderasyondan sonra aktif hale gelecektir. |
targeting | Reklam kampanyası için gerekli hedefleme ayarları.
| geo tarayıcı os cihaz mobil taşıyıcı iprange osversions Uygulama | Bu parametreler bir nesne olarak geçirilir. Her yeni hedefleme parametresi virgülle belirtilir. |
Talep Örneği:
Aşağıdaki parametrelerle bir reklam kampanyası oluşturmak için:
Ad formatı - Popunder mobile
Fiyat - 1,53 $
Sıklık kaplamaları - Kampanya için 12 saatte 2 gösterim
Kanallar - ana akım yüksek aktivite и orta aktivite
Tür - BGBM (Popunder reklam biçimi için yalnızca BGBM belirtebilirsiniz)
Adı - Popunder_API
URL - https://mywebsite.com.
Aktif - Doğru
Targeting - GEO: ABD, İngiltere, DE; Tarayıcı: Chrome, Safary; Cihaz - mobil
Bağlantınız '&' sembolü içeriyorsa, bunu URL kodlu biçime kodlamanız gerektiğini lütfen unutmayın. Aksi takdirde, bağlantı değişikliği talebine verilen yanıtta bir hata alabilirsiniz.
Örneğin, bağlantı
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}olarak belirtilmelidir
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Bağlantınızı URL kodlu biçime kodlamak için aracı kullanabilirsiniz.
Aşağıdaki formatta bir talep yazmanız gerekmektedir:
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