Sponsorlu Ürün reklam modeli Mimeda tarafından geliştirilen ve yayıncıları tarafından kullanılarak, kullanıcı arama sonucu ekranında doğal arama sonucuna benzer şekilde görüntülenen reklam modelidir.
Reklam modelinin entegrasyon çalışması 2 ayrı ortamda yapılmalıdır.
İlk olarak reklamların sorgulanmarı ve var ise reklam gösterimi kararı verilebilmesi için server-to-server olarak sorgulama yapılacak olan GetAd Servisi.
Sonraki adımda ise reklamın görüntülendiği platforma (mobil uygulama veya web sitesi) göre kullanılacak olan SDK ve SDK içerisindeki ilgili Metrik Toplama Entegrasyonu.
Bu servisin amacı server-to-server olarak reklam sorgusu yapabilmektir. Bu servis üzerinden herhangi bir veri güncellemesi yapılmaz.
GET HTTP/1.1
https://bidding-mimeda.azurewebsites.net/migros-sanalmarket/sponsored-product?adUnit=slot-1&keyword=çikolatalı süt
Parametre | Açıklama |
---|---|
adunit
|
Reklamın görüntüleneceği alanı belirler. Aynı sayfada birden fazla adunit olabileceği için her biri için ayrı bir adunit parametresi ile ayrı sorgu atılır. AdUnit hakkında detaylı bilgi için tıklayın. |
keyword
|
Kullanıcının arama yaptığı kelimedir. Herhangi bir sanitizasyon (harf değiştirme veya unicode çevrimi vb.) işlemi yapmadan aynı şekilde parametreye gönderilmelidir. |
{
"data": {
"keyword": "çikolatalı süt",
"adUnit": "slot-1",
"winners": [
{
"lineItemId": 12,
"creativeId": 33,
"productSku": "11010239",
"adUnit": "slot-1",
"keyword": "çikolatalı süt",
"payload": "encrypted-data"
},
{
"lineItemId": 21,
"creativeId": 66,
"productSku": "11014714",
"adUnit": "slot-1",
"keyword": "çikolatalı süt",
"payload": "encrypted-data"
},
{
"lineItemId": 21,
"creativeId": 67,
"productSku": "11010242",
"adUnit": "slot-1",
"keyword": "çikolatalı süt",
"payload": "encrypted-data"
}
]
},
"message": null,
"statusCode": 200
}
Reklam sorgusu ve reklam gösterimi yapıldıktan sonra, reklam görüntülendiğinde ve tıklandığında, kullanıcının platformuna göre bu bilgilerin Mimeda metrik toplama ortamına gönderilmesi gerekmektedir. Bu gönderim işlemi Mimeda SDK üzerinden yapılmaktadır ve web veya mobil uygulama ortamlarına göre gönderimleri farklılıklar içermektedir. Her bir platform için nasıl gönderim yapılacağını aşağıdaki linkleri takip ederek bulabilirsiniz.