Mlink Yardım 1.3.32

Mlink Web SDK

Mimeda tarafından geliştirilen Web SDK ile web sitenizdeki verileri toplayabilir ve analiz edebilirsiniz. Bu sayede, kullanıcıların web sitenizdeki etkileşimlerini ölçebilir ve reklam kampanyalarınızı optimize edebilirsiniz.

SDK kullanılmasının bir başka avantajı ise reklam alanlarının entegrasyonu için gereken tüm işlemleri çok daha rahat yapılmasını sağlamasıdır.

SDK JavaScript kullanılarak geliştirilmiştir ve uygulamanıza front end tarafında entegre edilmesi gerekmektedir.

CDN

Javascript dosyasını aşağıdaki CDN adresinden ve kod örneğini kullanarak sayfanızın HEAD kısmına ekleyiniz.


<script async src="https://cdn.mlink.com.tr/web-sdk/m.js"></script>

Önemli Bilgi

Javascript dosyası sayfaya asenkron olarak yükleneceği için sitenizin yavaşlamasına neden olmaz. Bu sayede kullanıcılarınızın deneyimi olumsuz etkilenmez.

Debug Mode

Entegrasyon sürecinde debug modunu aktifleştirmek ve daha detaylı loglar görmek için bulunduğunuz sayfada mlink isimli query parametresine "debug" değeri verebilirsiniz.


https://localhost/Test.html?mlink=debug

Örnek Log Çıktısı Görüntüsü

Event Gönderimi

Event nedir?

Kullanıcılarınızın uygulamanızı kullanırken analitik verisi oluşturacak şekilde yaptığı davranışlardır. Örneğin bir kullanıcının uygulamanın ana sayfasındaki bir ürünü sepete eklemesi veya bir satış işlemini tamamlaması olarak örneklenebilir.

Eventler içeriklerine göre bazı parametreler alır, bu parametrelerin isimleri ve açıklamaları aşağıda listelenmiştir. Kullanıcılarınızın uygulamanızda oluşturduğu eventleri iletmeniz, yayınlanan reklamların satışlar ile ilişkisinin kurulmasını sağlayacak, reklam verimliliğinin yükselmesi ile kazançlarınızı artıracaktır.

Aşağıda event gönderimine dair bir örnek görebilirsiniz. Eventlerde hangi parametrelerin iletilmesi gerektiğini detaylı görebilmek için aşağıda paylaşılan event listesini inceleyebilirsiniz.


let payload = {
    UserId: 123,
    CategoryId : "123abc",
    Keyword : "süt",
    TransactionId : 1234567890,
    LoyaltyCard : "111222333444",
    App : "sanalmarket",
    Products : [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
        { Barcode: 6789, Quantity: 1, Price: 567.88 }
    ]
};

Mlink.Publisher.Events.Home.AddToCart(payload);

Parametre	Zorunlu	Açıklama
`UserId`	Hayır	Mobil uygulamaya login olmuş kullanıcının sizin sisteminizdeki Id bilgisidir. Eğer kullanıcı login olmuş ise tüm eventlerde user Id bilgisi gönderilmelidir.
`CategoryId`	Hayır	Kullanıcı eğer bir kategori listeleme sayfasını görüntülüyor ise, görüntülediği kategorinin Id bilgisidir. Sadece listing eventlerinde zorunlu olarak gönderilmelidir.
`Keyword`	Hayır	Kullanıcı eğer bir arama yaptıysa ve bunun sonucunu görüntülüyorsa, arama yaptığı kelimeyi gönderir. Sadece search eventlerinde zorunlu olarak gönderilmelidir.
`TransactionId`	Hayır	Kullanıcı bir alışverişi tamamladıysa, sizin sisteminizde tanımlı olan transaction Id bilgisidir. Sadece purchase eventinde zorunlu olarak gönderilmelidir.
`LoyaltyCard`	Hayır	Kullanıcı eğer bir loyalty card kullandıysa onun bilgileri gönderilir. Kullanıcı login olmuşsa ve loyalty card bilgisi varsa gönderilmelidir.
`Products`	Hayır	Kullanıcının etkileşime girdiği ürünlerin bilgilerini içeren listedir. Home/View eventi dışındaki tüm eventlerde zorunlu olarak gönderilmelidir. Her bir ürün için listeye aşağıdaki formatta bir obje eklenir. Barcode: Ürünün SKU numarası Quantity: Ürünün adedi Price: Ürünün fiyatı
`TotalRowCount`	Hayır	Listeleme ekranlarında kullanıcılara gösterilen ürün sayısıdır. Sadece search ve listing eventlerinde zorunlu olarak gönderilmelidir.
`LineItemIDs`	Hayır	Event gönderildiğinde ekranda gözüken line item'ların Id'leri, aralarına virgül konularak (li1,li2,...,li_n) gönderilir.
`App`	Evet	Eventin gönderildiği platformun adıdır. sanalmarket ekstra hemen yemek tazedirekt macrocenter mion petimo

Event Listesi

Aşağıdaki listede her bir event için ayrı ayrı olacak şekilde bilgileri bulabilirsiniz. Her bir eventin ne zaman tetiklenmesi gerektiği ve hangi bilgilerin gönderilmesi gerektiği belirtilmiştir.

Home / View

Kullanıcı ana sayfayı görüntülediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444"
};

Mlink.Publisher.Events.Home.View(payload);

Home / Add to Cart

Kullanıcı ana sayfayı görüntüledikten sonra bir ürünü sepete eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.Home.AddToCart(payload)

Home / Add to Favorites

Kullanıcı ana sayfayı görüntüledikten sonra bir ürünü favorilerine eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.Home.AddToFavorites(payload)

Listing / View

Kullanıcı bir listeleme işlemi yaptığında tetiklenir. Örneğin ana menüden bir kategoriye tıkladığında veya özel bir alışveriş listesine tıkladığında karşısına çıkan ürün listesi olduğunda tetiklenir. Arama işlemleri bu olayın dışındadır.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    CategoryId: "123abc",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ],
    TotalRowCount: 463
};

Mlink.Publisher.Events.Listing.View(payload);

Listing / AddToCart

Kullanıcı bir listeleme ekranında bir ürünü sepete eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    CategoryId: "123abc",
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ],
    TotalRowCount: 463
};

Mlink.Publisher.Events.Listing.AddToCart(payload);

Listing / AddToFavorites

Kullanıcı bir listeleme ekranında bir ürünü favorilere eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    CategoryId: "123abc",
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ],
    TotalRowCount: 463
};

Mlink.Publisher.Events.Listing.AddToFavorites(payload);

Search / View

Kullanıcı bir arama yaptığında tetiklenir.


let payload = {
    UserId: 123,
    Keyword: "süt",
    TotalRowCount: 463,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.Search.View(payload);

Search / Add To Cart

Kullanıcı bir arama yaptıktan sonra, karşısına çıkan listeden bir ürünü sepete eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    Keyword: "süt",
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ],
    TotalRowCount: 463
};

Mlink.Publisher.Events.Search.AddToCart(payload);

Search / Add To Favorites

Kullanıcı bir arama yaptıktan sonra, karşısına çıkan listeden bir ürünü favorilerine eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    Keyword: "süt",
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ],
    TotalRowCount: 463
};

Mlink.Publisher.Events.Search.AddToFavorites(payload);

Product Details / View

Kullanıcı bir ürüne tıklayarak, detay sayfasında inceleme yaptığında tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.ProductDetails.View(payload);

Product Details / Add To Cart

Kullanıcı bir ürünü inceledikten sonra, detay sayfasında sepete eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.ProductDetails.AddToCart(payload);

Product Details / Add To Favorites

Kullanıcı bir ürünü inceledikten sonra, detay sayfasında favorilere eklediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.ProductDetails.AddToFavorites(payload);

Cart / View

Kullanıcı sepeti görüntülediğinde tetiklenir.


let payload = {
    UserId: 123,
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.Cart.View(payload);

Purchase / Success

Kullanıcı bir alışveriş işlemini tamamladığında tetiklenir.


let payload = {
    UserId: 123,
    TransactionId: "123abc",
    App: "sanalmarket",
    LoyaltyCard: "111222333444",
    Products: [
        { Barcode: 123456, Quantity: 2, Price: 123.45 },
    ]
};

Mlink.Publisher.Events.Purchase.Success(payload);

Event Tam Kod Örneği


<!DOCTYPE html>
<html lang="tr">
<head>
    <script async src="https://cdn.mlink.com.tr/web-sdk/m.js"></script>
</head>
<body>

<script>
    function SendEvent() {
        let payload = {
            UserId: 123,
            CategoryId: "123abc",
            Keyword: "süt",
            TransactionId: 1234567890,
            LoyaltyCard : "111222333444",
            App : "sanalmarket",
            Products: [
                { Barcode: 123456, Quantity: 2, Price: 123.45 },
                { Barcode: 6789, Quantity: 1, Price: 567.88 }
            ]
        };

        Mlink.Publisher.Events.Home.AddToCart(payload);
    }
</script>

<button onclick="SendEvent();">GÖNDER</button>

</body>
</html>

Sponsorlu Ürün Entegrasyonu

Mimeda'nın yayıncıları için geliştirdiği bir Sponsorlu Ürün reklam modelinin Frontend tarafında iki farklı entegrasyon adımı bulunmaktadır. Gönderilebilecek parametreler ve açıklamaları aşağıda tanımlanmıştır.

Parametre	Zorunlu	Açıklama
`userId`	Hayır	Bu değer, mobil uygulamaya login olmuş kullanıcının sizin sisteminizdeki Id bilgisidir. Eğer kullanıcı login olmuş ise tüm eventlerde user Id bilgisi gönderilmelidir.
`lineItemId`	Evet	İlgili slota ait sponsorlu ürün sorgusunun cevabında bulunan line item Id'sidir.
`creativeId`	Evet	İlgili slota ait sponsorlu ürün sorgusunun cevabında bulunan kreatif Id'sidir.
`adUnit`	Evet	Sponsorlu ürünün bulunduğu ad unit bilgisidir.
`productSku`	Evet	Tıklanan veya görüntülenen ürünün SKU numarasıdır.
`payload`	Evet	İlgili slota ait sponsorlu ürün sorgusunun cevabında bulunan payload değeridir.
`keyword`	Evet	Kullanıcı tarafından search edilen değerdir.
`app`	Evet	Eventin gönderildiği platformun adıdır. sanalmarket ekstra hemen yemek tazedirekt macrocenter mion petimo

Impression

Impression eventleri, sponsorlu ürünün görüntülendiği bilgisini Mimeda'ya bildirmek amacıyla gönderilir.


let payload = { 
    "UserId": 45322,
    "LoyaltyCard": 98392794,
    "LineItemID": 123456,
    "CreativeID": 987654,
    "ProductSku": "11010239",
    "AdUnit": "slot-1",
    "Keyword": "çikolatalı süt",
    "App" : "sanalmarket",
    "Payload": "encrypted-data"
};

Mlink.Publisher.AddMetrics.Impression(payload);

Click

Click eventleri ise, sponsorlu ürüne tıklandığı bilgisini Mimeda'ya bildirmek amacıyla gönderilir.


let payload = { 
    "UserId": 45322,
    "LoyaltyCard": 98392794,
    "LineItemID": 123456,
    "CreativeID": 987654,
    "ProductSku": "11010239",
    "AdUnit": "slot-1",
    "Keyword": "çikolatalı süt",
    "App" : "sanalmarket",
    "Payload": "encrypted-data"
};

Mlink.Publisher.AddMetrics.Click(payload);

Son Güncelleme: 15.01.2026

GENEL

YAYINCILAR

REKLAMVERENLER

KREATİF AJANSLAR