Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 34 Next »

In App Message

Uygulama içi mesajlar (in-app messages), mobil uygulamanızda doğrudan etkin oldukları zaman kullanıcılarınıza giden bildirimlerdir. Birkaç farklı isimle adlandırılabilirler: uygulama içi mesajlar, uygulama içi bildirimler ve uygulama içi mesajlaşma. Bunlar, push bildirimler, e-posta ve SMS gibi diğer mesajlaşma türlerini içeren genel bir mobil mesajlaşma stratejisinin hayati bir bileşenidir.

Uygulama içi iletileri göstermek ve RMC nesnesini başlatmak için aşağıdaki yöntemi kullanın:

Visilabs.CreateAPI("OrganizasyonID", "SiteID", "http://lgr.visilabs.net", "DataSource", "http://rt.visilabs.net" , "Android" , getApplicationContext(), "http://s.visilabs.net/json", "http://s.visilabs.net/actjson", requestTimeout);


Tüm customEvent() çağrılarına gerekli getActivity() parametresini ekleyin:

HashMap<String,String> parameters = new HashMap<String, String>();
 parameters.put("OM.exVisitorID", "test@euromsg.com");
 parameters.put("OM.sys.AppID", "visilabs-login"); //

 Visilabs.CallAPI().customEvent("android-visilabs", parameters, getActivity());

InApp’lerde bulunan deeplinklerin callback edilmesi:

Bu özelliği kullanabilmek için yapmanız gereken customEvent() methoduyla InApp’i çağırmadan önce aşağıdaki gibi callback methodunu set etmelisiniz:

InAppButtonInterface buttonCallback = new InAppButtonInterface() {
    @Override
    public void onPress(String link) {
        //Write your code here for the button click
    }
};
Visilabs.CallAPI().setInAppButtonInterface(buttonCallback);

Ardından customEvent() metodunu çağırabilirsiniz.

InApp’lerde Custom Font kullanımı

  1. InApp’lerde custom font kullanımı için ilk olarak res klasörü altında font folder'ı oluşturun.

  2. Oluşturduğunuz klasörün içerisine istediğiniz fontları ekleyebilirsiniz.

  3. Son olarak arayüzden uzantısız bir şekilde kullanmak istediğiniz fontun adını girin.


12 farklı In-App Message tasarımı mevcut:

Pop-up - Görsel, Başlık, Yazı & Buton

Mini - İkon & Yazı

Tam Ekran Görsel

Tam Ekran Görsel ve Buton

Pop-up - Görsel, Başlık, Yazı ve Buton

Pop-up Anket

Pop-up - Yazı ve Butonlu NPS

Native Alert & Action Sheet

1-10 Puanlama NPS

Yıldızlı anket & ikinci pop-up

Yarım Ekran Görsel

Carousel

Video In-App

InApp İçeren Örnek Uygulama

Favori Özellik Aksiyonu

RMC panel üzerindeki target aksiyonlarından tanımladığınız favori değişkenlerinizi aşağıdaki gibi mobil uygulama üzerinden alıp kullanabilirsiniz.

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);


//requestAction() or requestActionId()
  try {
        VisilabsActionRequest visilabsActionRequest = Visilabs.CallAPI().requestAction(VisilabsConstant.FavoriteAttributeAction);
        visilabsActionRequest.executeAsyncAction(getVisilabsCallback());
    } catch (Exception e) {
        e.printStackTrace();
    }
    }

Not: getVisilabsCallback() metodu için aşağıdaki iki kod bloğundan birisini kullanabilirsiniz.

private VisilabsActionsCallback getVisilabsCallback() {
    return new VisilabsActionsCallback() {

        @Override
        public void success(VisilabsActionsResponse message, String url) {
          List<FavoriteAttributeAction> favoriteAttributeActions = message.getFavoriteAttributeAction();
          String[] brands = favoriteAttributeActions.get(0).getActiondata().getFavorites().getBrand();
          //Continues like this...
        }

        @Override
        public void fail(Throwable t, String url) {
            Log.e("Error", t.getMessage());
        }
    };
}

veya

private VisilabsFavsRequestCallback getVisilabsCallback() {
    return new VisilabsFavsRequestCallback() {
        @Override
        public void success(FavsResponse message, String url) {
            Log.i(LOG_TAG, "Success Request : " + url);
            //Do your work here by using message, e.g.
            /*
            List<FavoriteAttributeAction> favsActions = message.getFavoriteAttributeAction();
            for (int i = 0; i < favsActions.size() ; i++) {
                String actionType = favsActions.get(i).getActiontype();
                Log.i(LOG_TAG, "action type " + i+1 + " : " + actionType);
                Actiondata  actionData = favsActions.get(i).getActiondata();
                for (int j = 0; j < favsActions.size() ; j++) {
                    String[] attributes = actionData.getAttributes();
                    Favorites favorites = actionData.getFavorites();
                    //goes on...
                }
            }
            */
        }
        @Override
        public void fail(Throwable t, String url) {
            Log.e(LOG_TAG, "Fail Request : " + url);
            Log.e(LOG_TAG, "Fail Request Message : " + t.getMessage());
        }
    };
}

Story Manager

Story Banner ve Story Aksiyonu

Her iki aksiyon içinde implementasyonu için aşağıdaki VisilabsRecyclerView ‘i layout’ta istediğiniz bölüme yerleştirin.

    <com.visilabs.story.VisilabsRecyclerView
        android:id="@+id/vrv_story"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

VisilabsRecyclerView'i classınızda tanımladıktan sonra StoryItemClickListener tanımlayarak her bir story’e tıklandığında yapmak istediğiniz yönlendirme ve ya aksiyonu tanımlayınız. Burada örnek olması için Toast Mesajı gösterilmiştir.

Ardından VisilabsRecyclerView'in setStoryActionmethodunu çağrarak storyItemClickListenerobjesini methoda ekleyiniz.

    VisilabsRecyclerView visilabsRecyclerView = findViewById(R.id.vrv_story);

       StoryItemClickListener storyItemClickListener = new StoryItemClickListener() {
            @Override
            public void storyItemClicked(String storyLink) {
                Toast.makeText(getApplicationContext(), storyLink, Toast.LENGTH_LONG).show();
            }
        };

       visilabsRecyclerView.setStoryAction(getApplicationContext(), storyItemClickListener);

 

İsterseniz Story Aksiyon Id ile de setleyebilirsiniz.

      visilabsRecyclerView.setStoryActionId(getApplicationContext(), "250", storyItemClickListener);

Panelde aktif story looking banner veya story olduğu sürece uygulamanızda gözükecektir.

Recommendation

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

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

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.

// örnek callback fonsiyonunda her bir ürün için "qs" parametresinin nasıl elde edilebileceğini görebilirsiniz.
Visilabs.CallAPI().trackRecommendationClick(qs);

Mail Üyelik Formu

RMC panelden in-app message’da olduğu gibi mail üyelik formunu oluşturduktan sonra her customEvent çağırdığınız zaman mail üyelik formu olup olmadığı kontrol edilir ardından mail üyelik formu gösterilir. customEvent parametresinde Activity’i alan overloadı çağırmanız gerekmektedir. Örnek kod ve görsel;

customEvent(String pageName, HashMap<String, String> properties, Activity parent)

Çarkıfelek

RMC panelden in-app message’da olduğu gibi çarkıfelek oluşturduktan sonra her customEvent çağırdığınız zaman çarkıfelek olup olmadığı kontrol edilir ardından çarkıfelek gösterilir. customEvent parametresinde Activity’i alan overloadı çağırmanız gerekmektedir. Örnek kod ve görsel;

customEvent(String pageName, HashMap<String, String> properties, Activity parent)

Çarkıfelek Yarım Görünüm

Çarkıfelek Tam Görünüm

Kazı Kazan

RMC panelden in-app message’da olduğu gibi Kazı Kazan oluşturduktan sonra her customEvent çağırdığınız zaman Kazı Kazan olup olmadığı kontrol edilir ardından Kazı Kazan gösterilir. customEvent parametresinde Activity’i alan overloadı çağırmanız gerekmektedir. Örnek kod ve görsel;

customEvent(String pageName, HashMap<String, String> properties, Activity parent)

Inline Nps With Numbers

InlineNpsWithNumbersView'ı projenizde tercih ettiğiniz bir layout dosyasına koymalısınız.
Örnek kullanım:

?xml version="1.0" encoding="utf-8"?>
<
LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   xmlns:app="http://schemas.android.com/apk/res-auto">
   <com.visilabs.inApp.inlineNpsWithNumber.InlineNpsWithNumbersView
       android:id="@+id/inlineNps"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       />
</
LinearLayout
>

InlineNpsWithNumbersView 'i koyduktan sonra ilgili program kodundaki (Java veya Kotlin) nesneye erişmeli ve bu nesne üzerinde setNpsWithNumberAction() yöntemini çağırmalısınız. Bu yöntem 1 zorunlu (Bağlam bağlamı) ve 3 isteğe bağlı parametre (HashMap<String, String> özellikleri, NpsItemClickListener npsItemClickListener, Activity) alır.

Özellikler, isteğe ek olarak istediğiniz sorgu parametrelerini eklemek içindir.
nps ItemClickListener, kullanıcı bir banner'ı tıkladığında kontrolü elde etmek içindir. Sdk'nın kullanıcıyı otomatik olarak bağlantıya yönlendirmesini istemiyorsanız, bu arayüzü kullanabilirsiniz.

Ürün Durum Bilgisi

RMC Panelde tanımladığınız Ürün Durum Bilgisi aksiyonu Ürün Görüntüleme, Sepete Ekleme ve Favoriye Ekleme/Çıkarma eventlerinde çalışmaktadır. Bu eventlerde ürün idnin gönderildiğinden emin olmalısınız. Bu eventlerde çağırdığınız customEvent metodunun Activity overloadını alması gerekmektedir.

Kulakçık

RMC panelden Kulakçık aksiyonu oluşturduktan sonra her customEvent çağırdığınız zaman Kulakçık olup olmadığı kontrol edilir ardından Kulakçık gösterilir. customEvent parametresinde Activity’i alan methodu çağırmanız gerekmektedir. Örnek kod ve görsel;

customEvent(String pageName, HashMap<String, String> properties, Activity parent)

  • No labels