API kullanarak reklam kampanyası nasıl oluşturulur?
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. |
limitImpressionsTotal | Toplam Gösterim Sınırını Belirtin | 200000 | Yalnızca bir numara belirtebilirsiniz. |
limitImpressionsDaily | Günlük Gösterim Sınırını Belirtin | 20000 | Sadece bir sayı belirtebilirsiniz. Günlük gösterim sayısı için minimum sınır 15.000’dir. Günlük gösterim sayısı için maksimum sınır 100.000’dir. |
limitBudgetTotal | Toplam Bütçe Sınırını Belirtin | 2000 | Yalnızca bir numara belirtebilirsiniz. |
limitBudgetDaily | Günlük Bütçe Sınırını Belirtin | 50 | Sadece bir sayı belirtebilirsiniz. Günlük minimum bütçe limiti 20$'dır. |
filters | Proxy ve WebView trafik filtrelerine izin verebilir/vermeyebilirsiniz. | Vekil Web Görünümü | Bu parametre bir nesne olarak geçirilir. |
targeting | Reklam kampanyası için gerekli hedefleme ayarları.
| coğrafi tarayıcı işletim sistemi aygıt mobil taşıyıcı iprange'ın osversiyonlar Uygulama | Bu parametreler bir nesne olarak geçirilir. Her yeni hedefleme parametresi virgülle belirtilir. |
uniformDistributionDaily | Kampanya sınırlarına nasıl ulaşılacağını seçin. | ASAP Evenly | ASAP – belirtilen kampanya limitlerine olabildiğince çabuk ulaşın |
Hedefleme nesnesi
İsim | Örnek | Tanım |
coğrafi | bizi GB AU | Gerekli ülke/ülkelerin iki harfli kodlarını virgülle ayırarak girin. |
tarayıcı | Krom Firefox'un Safari |
|
işletim sistemi | Android iOS |
|
aygıt | mobil / akıllı telefon tablet |
|
mobil taşıyıcı | Vodafone |
|
iprange'ın | 127.0.0.1 |
|
osversiyonlar | iOS 15 Kazanmak 7 |
Mevcut tüm sürümler |
Uygulama |
|
Hedefleme nesnesi
İsim | Örnek |
Vekil | İzin vermek İzin verme Sadece |
Web Görünümü | İzin vermek İzin verme Sadece |
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://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3Bc
HilltopAds reklam ağı API’sinin tüm potansiyelini ortaya çıkarın!