Ana içeriğe geç

Bir Reklam Kampanyası Oluşturun

Reklam kampanyası oluşturabileceğiniz API yöntemine dair her şey.

HilltopAds avatar
Yazar: HilltopAds
Bir haftadan uzun bir süre önce güncellendi

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
Evenly – gün boyunca / tüm dönem boyunca belirtilen limitlere kademeli olarak 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

Facebook

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

  • 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!

Bu cevap sorunuzu yanıtladı mı?