Mlink Yardım 1.3.32

Alışveriş Listesi

Reklam verenler çoğu zaman, özellikle banner kampanyalarında tek bir ürün yerine birden fazla ürünün reklamını yapmak isteyebiliyorlar. Bu durumda reklamlar tıklandığında birden fazla ürünün (yalnızca reklam bannerında bulunan ürünlerin) görüntülendiği bir sayfanın oluşmasını ve kullanıcıların tıklandığında direkt olarak bu sayfaya gitmesini talep etmektedirler. Bu sayfaya "Alışveriş Listesi" adı verilmektedir.

Aşağıda bannera tıkladığınıda açılan sayfada yalnızca banner içerisindeki ürünler görüntülenir.

Bu özellik ile ilgili yaycınılarımızdan bir alışveriş listesi özelliği geliştirmelerini beklemekteyiz. Mimeda ise kampanyalarda kullanabilmek amacıyla sizin paylaşacağınız API üzerinden kampanyalara özel alışveriş listesi oluşturabilir olmalıdır.

Teknik Bilgiler

Aşağıda bu entegrasyon için geliştirilecek API içinde hangi bilgiler olması gerektiği hakkında bilgilere erişebilirsiniz.

Create

Mimeda tarafından çağırılacak olan, gönderilen bilgiler ile yeni bir alışveriş lisesi yaratılması için kullanılır.

URL

                    
https://api.domaininiz.com/v1/shoppinglist/create

Request

                    
{
    "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
    "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
    "IsEnabled": true,
    "Products": [869111111, 869222222, 869333333, 8694444444, 869555555, 869666666],
    "MimedaID": 123456,
    "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
}

Request Alanları

Alan	Tipi	Zorunlu	Açıklama
`Name`	string	zorunlu	Alışveriş listesinin adını belirler. Web sayfanızda ve/veya mobil uygulamanızda bu alanı görüntleyebilirsiniz. Genellikle kampanya adı ile aynı kullanılır.
`Description`	string	opsiyonel	Alışveriş listesinin kısa açıklamasını belirler. Web sayfanızda ve/veya mobil uygulamanızda bu alanı görüntleyebilirsiniz. Genellikle kampanya hakkında kısa bir açıklama için kullanılır.
`IsEnabled`	bool	zorunlu	Alışveriş sepeti ilk yaratılırken aktif/pasif durumunu belirler. Varsayılan değeri true'dur.
`Products`	array[int]	zorunlu	Bu listede görünmesi istenen ürünlerin barkod bilgileri array şeklinde gönderilir.
`MimedaID`	int	opsiyonel	Mimeda tarafından kullanılacak olan ID alanıdır. Yayıncıların bu bilgiyi saklaması ileride oluşabilecek takip işlemlerini kolaylaştıracaktır.
`Notes`	string	opsiyonel	Bu alan müşteriler tarafından görüntülenmemelidir. Yalnızca takip amacıyla kullanılacak bilgiler bu alanda saklanır.

Reponse

                    
{
    "ID": 1234567890,
    "WebURL": "https://www.domaininiz.com/shoppinglist/1234567890"
    "iOSURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
    "AndroidURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
    "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
    "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
    "IsEnabled": true,
    "Products": [869111111, 869222222, 869333333, 8694444444, 869555555, 869666666],
    "MimedaID": 123456,
    "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
}

Response Alanları

Alan	Tipi	Zorunlu	Açıklama
`ID`	int	zorunlu	Yayıncı tarafından oluşturulan alışveriş listesinin ID'si
`WebURL`	string	zorunlu	Oluşturulan alışveriş listesinin Web URL'si
`iOSURL`	string	opsiyonel	Oluşturulan alışveriş listesinin iOS URL'si
`AndroidURL`	string	opsiyonel	Oluşturulan alışveriş listesinin Android URL'si

Update

Mimeda tarafından çağırılacak olan, gönderilen bilgiler ile varolan bir alışveriş listesinin güncellenmesi için kullanılır.

URL

                    
https://api.domaininiz.com/v1/shoppinglist/update

Request

                    
{
    "ID": 1234567890,
    "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
    "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
    "IsEnabled": true,
    "Products": [869111111, 869222222, 869333333, 8694444444, 869555555, 869666666],
    "MimedaID": 123456,
    "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
}

Request Alanları

Alan	Tipi	Zorunlu	Açıklama
`ID`	string	zorunlu	Güncellenmesi istenen alışveriş listesinin ID'si.
`Name`	string	zorunlu	Alışveriş listesinin adını belirler. Web sayfanızda ve/veya mobil uygulamanızda bu alanı görüntleyebilirsiniz. Genellikle kampanya adı ile aynı kullanılır.
`Description`	string	opsiyonel	Alışveriş listesinin kısa açıklamasını belirler. Web sayfanızda ve/veya mobil uygulamanızda bu alanı görüntleyebilirsiniz. Genellikle kampanya hakkında kısa bir açıklama için kullanılır.
`IsEnabled`	bool	zorunlu	Alışveriş sepeti ilk yaratılırken aktif/pasif durumunu belirler. Varsayılan değeri true'dur.
`Products`	array[int]	zorunlu	Bu listede görünmesi istenen ürünlerin barkod bilgileri array şeklinde gönderilir.
`MimedaID`	int	opsiyonel	Mimeda tarafından kullanılacak olan ID alanıdır. Yayıncıların bu bilgiyi saklaması ileride oluşabilecek takip işlemlerini kolaylaştıracaktır.
`Notes`	string	opsiyonel	Bu alan müşteriler tarafından görüntülenmemelidir. Yalnızca takip amacıyla kullanılacak bilgiler bu alanda saklanır.

Reponse

                    
{
    "ID": 1234567890,
    "WebURL": "https://www.domaininiz.com/shoppinglist/1234567890"
    "iOSURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
    "AndroidURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
    "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
    "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
    "IsEnabled": true,
    "Products": [869111111, 869222222, 869333333, 8694444444, 869555555, 869666666],
    "MimedaID": 123456,
    "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
}

Response Alanları

Alan	Tipi	Zorunlu	Açıklama
`ID`	int	zorunlu	Yayıncı tarafından oluşturulan alışveriş listesinin ID'si
`WebURL`	string	zorunlu	Oluşturulan alışveriş listesinin Web URL'si
`iOSURL`	string	opsiyonel	Oluşturulan alışveriş listesinin iOS URL'si
`AndroidURL`	string	opsiyonel	Oluşturulan alışveriş listesinin Android URL'si

List

Daha önce girilmiş olan kayıtlar arasında filtreleme yapılarak listesinin çekilmesi için kullanılır.

URL

                    
https://api.domaininiz.com/v1/shoppinglist/list

Request

Genel olarak alanların hiç biri zorunlu değildir.

Filtreleme yapılacak alanlar belirlenerek sadece o alanlar üzerinden filtreleme yapılmalıdır.

Bir alan Null gelirse o alan üzerinden filtreleme yapılmamalıdır.

Bir alan hiç gönderilmemişse o alan üzerinden filtreleme yapılmamalıdır.

                    
{
    "StartDate": "2023-12-30T00:00:00",
    "EndDate": "2023-12-31T23:59:59",
    "ID": [111, 222, 333, 444, 555, 666],
    "Name": "Kahvaltılık",
    "Description": "Kahvaltılık",
    "IsEnabled": true,
    "Products": [869111111, 869222222],
    "MimedaID": 123456,
    "Notes": "Mimeda"
}

Request Alanları

Alan	Tipi	Zorunlu	Açıklama
`StartDate`	datetime	opsiyonel	Alışveriş sepetinin yaratılma tarihine göre filtrelemek için kullanılır.
`EndDate`	datetime	opsiyonel	Alışveriş sepetinin yaratılma tarihine göre filtrelemek için kullanılır.
`ID`	array[int]	opsiyonel	Array şeklinde bilgilerinin çekilmesi istenen ID listesi.
`Name`	string	opsiyonel	Alışveriş listesinin adında aranması istenen kelimeler. Contains ile aranmalı ve Case-Insensitive olmalıdır.
`Description`	string	opsiyonel	Alışveriş listesinin açıklamasında aranması istenen kelimeler. Contains ile aranmalı ve Case-Insensitive olmalıdır.
`IsEnabled`	bool	opsiyonel	Alışveriş listesinin durumuna göre filtrelenmesi için kullanılır.
`Products`	array[int]	opsiyonel	Alışveril listesinin içinde olabilecek ürün barkodlarını içerir./td>
`MimedaID`	int	opsiyonel	Bu ID'ye sahip olan alışveril listelerinin listelenmesi için kullanılır.
`Notes`	string	opsiyonel	Notlarda bu bilgiye sahip olan alışveril listeleri için kullanılır.

Reponse

                    
[
    {
        "ID": 1234567890,
        "CreatedDate": "2023-12-30T23:56:12",
        "WebURL": "https://www.domaininiz.com/shoppinglist/1234567890"
        "iOSURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
        "AndroidURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
        "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
        "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
        "IsEnabled": true,
        "Products": [869111111, 869222222, 869333333, 8694444444, 869555555, 869666666],
        "MimedaID": 123456,
        "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
    },
    {
        "ID": 987654321,
        "CreatedDate": "2024-01-22T13:44:00",
        "WebURL": "https://www.domaininiz.com/shoppinglist/1234567890"
        "iOSURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
        "AndroidURL": "yayinci_key://www.domaininiz.com/shoppinglist/1234567890"
        "Name": "Kahvaltılık Gevreklerde Aynı Üründen 2 Al 1 Öde",
        "Description": "Kahvaltılık gevreklerde aynı üründen 2 al 1 öde kampanyası mayıs sonuna kadar devam ediyor.",
        "IsEnabled": true,
        "Products": [869888888, 869777777],
        "MimedaID": 123456,
        "Notes": "Mimeda-Migros ortaklığında geliştirilecen kampanya için kullanılır."
    },
]

Response Alanları

Alan	Tipi	Zorunlu	Açıklama
`CreatedDate`	datetime	zorunlu	Alışveriş listesinin yaratıldığı tarihi belirtir.

GENEL

YAYINCILAR

REKLAMVERENLER

KREATİF AJANSLAR

Mlink Yardım 1.3.32

Alışveriş Listesi

Teknik Bilgiler

Create

URL

Request

Request Alanları

Reponse

Response Alanları

Update

URL

Request

Request Alanları

Reponse

Response Alanları

List

URL

Request

Request Alanları

Reponse

Response Alanları