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.

Geliştirilen SDK web siteniz için native Javascript ile geliştirilmiştir. Web sitenize 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

Geliştirmelerinizi yaparken entegrasyonun doğru olduğundan emin olmak için Mlink Web SDK'nın Debug Mod'unu aktif edebilirsiniz. Bunun için üzerinde çalıştığınız sayfanın url (adres) sonuna "mlink=debug" parametresini eklemeniz yeterli olacaktır.


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 mobil 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.

Event gönderim metodlarının tamamı parametre olarak JSON tipinde bir payload nesnesi beklemektedir. Bu nesne genel olarak kullanıcının kendisi ve ilgi gösterdiği ürünlerin bilgilerini parametre alır. Ek olarak bu kullanıcının web sitenizde gördüğü reklamları opsiyonel olarak göndermeniz, uygulamanızda görüntülenen reklamlar ile satışların ilişkisinin sağlayacak ve reklam verimliliği ile kazançlarınızı arttıracaktır.

Aşağıda bir payload nesnesinin nasıl yaratıldığını ve bilgilerin doldurulmasını gösteren örnek kod bloğunu bulabilirsiniz.


let payload = {
    userId: 123,
    categoryId : "123abc",
    keyword : "süt",
    transactionId : 1234567890,
    loyaltyCard : "111222333444",
    app : "migros-sanalmarket",
    products : [
        { barcode: 123456, quantity: 2, price: 123.45 },
        { barcode: 6789, quantity: 1, price: 567.88 }
    ]
};

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

* Tüm parametreler tüm eventlerde zorunlu değildir. Her bir event için kullanılan parametreler değişiklik gösterebilir. En doğru bilgi için ilgili eventin dökümantasyonunu inceleyebilirsiniz.

Parametre	Açıklama
`userId`	Web sitenize login olmuş kullanıcının sizin sisteminizdeki ID bilgisi.
`cateogryId`	Kullanıcı eğer bir kategori listeleme sayfasını görüntülüyor ise, görüntülediği kategorinin ID bilgisi.
`keyword`	Kullanıcı eğer bir arama yaptıysa ve bunun sonucunu görüntülüyorsa, arama yaptığı kelimeyi gönderir.
`transactionId`	Kullanıcı bir alışverişi tamamladıysa, sizin sisteminizde tanımlı olan transaction ID bilgisi.
`loyaltyCard`	Kullanıcı eğer bir loyalty Card kullandıysa onun bilgileri gönderilir.
`app`	Aktif kullanılan uygulamayı belirtir.
`products`	Kullanıcının ilgi gösterdiği ürünlerin bilgilerini içeren bir array. Her bir ürün için aşağıdaki bilgileri gönderebilirsiniz. barcode: Ürünün barkod numarası quantity: Ürünün adedi price: Ürünün fiyatı

Event Listesi

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

Home / View

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


let payload = {
    userId: 123,
    app : "migros-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 : "migros-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 : "migros-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 : "migros-sanalmarket",
    loyaltyCard : "111222333444",
    categoryId : "123abc",
);

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

Listing / AddToCart


let payload = {
    userId: 123,
    categoryId : "123abc",
    app : "migros-sanalmarket",
    loyaltyCard : "111222333444",
    products : [
        { barcode: 123456, quantity: 2, price: 123.45 },
    ]
);

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 : "migros-sanalmarket",
    loyaltyCard : "111222333444",
    products : [
        { barcode: 123456, quantity: 2, price: 123.45 },
    ]
);

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 : "migros-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 : "migros-sanalmarket",
    loyaltyCard : "111222333444",
    products : [
        { barcode: 123456, quantity: 2, price: 123.45 },
    ]
);

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 : "migros-sanalmarket",
    loyaltyCard : "111222333444",
    products : [
        { barcode: 123456, quantity: 2, price: 123.45 },
    ]
);

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 : "migros-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 : "migros-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 : "migros-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 : "migros-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 : "migros-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 : "migros-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 2 farklı entegrasyon adımı bulunmaktadır.

Impression

Bunlardan ilki, reklamın görüntülendiği bilgisini yine Mimeda'ya bildirebilmek amacıyla bir fonksiyon çağırılmalıdır. Impression fonksiyonu reklamın sorgulanması sonrasında alınan cevabın (Response Model) hiç değiştirmeden parametre olarak verilmesini bekler.


let payload = { 
    "lineItemId": 123456,
    "creativeId": 987654,
    "productSku": "11010239",
    "adUnit": "slot-1",
    "keyword": "çikolatalı süt",
    "app" : "migros-sanalmarket",
    "payload": "encrypted-data"
};

Mlink.Publisher.AddMetrics.Impression(payload);

Click

Bir diğeri ise, reklamın tıklandığı bilgisini yine Mimeda'ya bildirebilmek amacıyla bir fonksiyon çağırılmalıdır. Click fonksiyonu reklamın sorgulanması sonrasında alınan cevabın (Response Model) hiç değiştirmeden parametre olarak verilmesini bekler.


let payload = { 
    "lineItemId": 123456,
    "creativeId": 987654,
    "productSku": "11010239",
    "adUnit": "slot-1",
    "keyword": "çikolatalı süt",
    "app" : "migros-sanalmarket",
    "payload": "encrypted-data"
};

Mlink.Publisher.AddMetrics.Click(payload);

Son Güncelleme: 31.01.2025

GENEL

YAYINCILAR

REKLAMVERENLER

KREATİF AJANSLAR