Metod: PUT /api/v1/advertiser/campaign/{id}
Açıklama: HilltopAds hesabınız için API aracılığıyla oluşturulmuş bir reklam kampanyasını güncelleyebilirsiniz.
Lütfen unutmayın, bu yöntem yalnızca Popunder mobil ve Popunder masaüstü formatları için kullanılabilir.
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. |
campaignID | Güncellenecek reklam kampanyasının kimliği
| 123456 | Yalnızca bir reklam kampanyasının kimliğini belirtebilirsiniz. Bu, istekte gerekli bir parametredir. |
format | Kampanyada güncellenecek 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 güncellenmesi 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 | Güncellenen 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:
Oluşturulan 123456 ID'li reklam kampanyasında aşağıdaki parametreleri güncellemek için:
Rate - 2,53 $'a
Sıklık kapakları - kampanya için 24 saatte 1 ekrana
URL - https://mywebsit2.com adresine.
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 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