Recommendations

Recommendation Widget'larının Mobil Uygulamaya Yerleştirilmesi

Android mobil uygulamanızda, kişiye özel ürün önerileri göstermeniz için gerekli dokümanları bu bölümde bulabilirsiniz.

Bir VisilabsTargetRequest nesnesi oluşturun ve VisilabsTargetRequest nesnesinin executeAsync yöntemini çağırın.

ZoneID her uygulama için farklıdır, bu nedenle destek için RMC ekibi ile iletişime geçiniz. "Alternatif Ürünler" gibi öneri widgetları, ürün kodunun bir parametre olarak görülmesini gerektirir.

Talep tamamlandıktan sonra, talebin başarı ya da başarısızlık durumuna bağlı olarak callback fonksiyonu çağrılır, bu nedenle ihtiyaçlarınıza göre callback fonksiyonlarını aşağıda gösterildiği gibi kodlamanız gerekir:

VisilabsCallback callback = new VisilabsCallback() {
    @Override
    public void success(VisilabsResponse response) {
        try{
            JSONObject jsonObject = response.getJson();
            String groupTitle = jsonObject.getString("title");
            JSONArray jsonArray = jsonObject.getJSONArray("recommendations");
            for(int i = 0 ; i < jsonArray.length() ; i++) {
                JSONObject currentProductObject = jsonArray.getJSONObject(i);
                String currentProductTitle = currentProductObject.getString("title");
                Double currentProductPrice = currentProductObject.getDouble("price");
                boolean currentProductFreeShipping = currentProductObject.getBoolean("freeshipping");
                String qs = currentProductObject.getString("qs");
                //Continues like this...
            }
        } catch (Exception e){
            Log.e(LOG_TAG, e.getMessage(), e);
        }
    }
    @Override
    public void fail(VisilabsResponse response) {
        Log.e(LOG_TAG, response.getErrorMessage());
    }
};

Yukarıdaki gibi callback fonksiyonunu oluşturulduktan sonra istek aşağıdaki şekilde gibi atılır:

VisilabsTargetRequest targetRequest = Visilabs.CallAPI().buildTargetRequest(zoneID, "productCode");
targetRequest.executeAsync(callback);

Ayrıca, filtreleri ve ek parametreleri geçirebileceğiniz bir overload buildTargetRequest yöntemi bulunmaktadır.

List<VisilabsTargetFilter> filters = new ArrayList<VisilabsTargetFilter>();
HashMap<String,String> properties = new HashMap<String, String>();
properties.put("OM.extra", "Extra Value");
VisilabsTargetFilter f = new VisilabsTargetFilter("attr1", "0", "value");
filters.add(f);
f.setAttribute("attr2");
f.setFilterType("1"); // There are 2 filter types: Include and Exclude. For Include pass "0", for Exclude pass "1".
f.setValue("value");
filters.add(f);

try {
    VisilabsTargetRequest targetRequest = Visilabs.CallAPI().buildTargetRequest(zoneID, "productCode", properties, filters);
    targetRequest.executeAsync(callback);
} catch (Exception e) {
    e.printStackTrace();

Attribute

Fonksiyon	Açıklama

Fonksiyon	Açıklama
`PRODUCTCODE`	Ürün koduna göre filtreleme yapar
`PRODUCTNAME`	Ürün ismine göre filtreleme yapar
`COLOR`	Ürün rengine göre filtreleme yapar
`AGEGROUP`	Ürün yaş grubuna göre filtreleme yapar
`BRAND`	Ürün markasına göre filtreleme yapar
`CATEGORY`	Ürün kategorisine göre filtreleme yapar
`GENDER`	Ürün cinsiyetine göre filtreleme yapar
`MATERIAL`	Ürün material kolonuna göre filtreleme yapar
`ATTRIBUTE1`	Ürün attribute1 kolonuna göre filtreleme yapar
`ATTRIBUTE2`	Ürün attribute2 kolonuna göre filtreleme yapar
`ATTRIBUTE3`	Ürün attribute3 kolonuna göre filtreleme yapar
`ATTRIBUTE4`	Ürün attribute4 kolonuna göre filtreleme yapar
`ATTRIBUTE5`	Ürün attribute5 kolonuna göre filtreleme yapar
`SHIPPINGONSAMEDAY`	Ürünün aynı gün kargo kolonuna göre filtreler
`FREESHIPPING`	Ürünün ücretsiz kargo durumuna göre filtreler
`ISDISCOUNTED`	Ürün indirim durumuna göre filtreleme yapar

Filter Type

Fonksiyon	Açıklama

Fonksiyon	Açıklama
`like`	Verilen değer, seçilen kolonun içerisinde geçiyor mu kontrolü yapar.
`notLike`	Verilen değer, seçilen kolonun içerisinde geçmiyor mu kontrolü yapar.
`equals`	Verilen değer, seçilen kolondaki değere tam eşit mi kontrolü yapar.
`notEquals`	Verilen değer, seçilen kolondaki değere tam eşit değil mi kontrolü yapar.
`greaterThan`	Verilen değer, seçilen kolondaki değerden daha büyük mü kontrolü yapar.
`lessThan`	Verilen değer, seçilen kolondaki değerden daha küçük mü kontrolü yapar.
`greaterOrEquals`	Verilen değer, seçilen kolondaki değerden daha büyük veya eşit mi kontrolü yapar.
`lessOrEquals`	Verilen değer, seçilen kolondaki değerden daha küçük veya eşit mi kontrolü yapar.

Recommendation tıklamalarının panele yansıması için, aşağıdaki method, tıklanan ürünün "qs" parametresiyle çağırılmalıdır.

Recommendation İçeren Örnek Uygulama