Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

    Image Modified

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

    Image Modified

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

    Image Modified


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

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

Mini - İkon & Yazı

Tam Ekran Görsel

Image ModifiedImage Modified

Image Modified

Tam Ekran Görsel ve Buton

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

Pop-up Anket

Image Modified

Image Modified

Image Modified

Pop-up - Yazı ve Butonlu NPS

Native Alert & Action Sheet

1-10 Puanlama NPS

Image Modified

Image Modified

Image Modified

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

Yarım Ekran Görsel

Carousel

Image Modified

Image Modified

Image Modified

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.

...

languagejava

...

Video In-App

Image Added

1-10 Puanlama NPS - Inline

InlineNpsWithNumbersView'ı projenizde tercih ettiğiniz bir layout dosyasına eklemelisiniz.
Örnek kullanım:

Code Block
?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"
      visilabsActionRequest.executeAsyncAction(getVisilabsCallback());
 android:layout_height="wrap_content"
   } catch (Exception e) {/>
</
       e.printStackTrace();
    }
    }

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

Code Block
languagejava
public VisilabsCallback getVisilabsCallback() {

    return new VisilabsCallback() {
        @Override
        public void success(VisilabsResponse responseLinearLayout
>

InlineNpsWithNumbersView 'i ekledikten sonra ilgili koddaki (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ı parametreye (HashMap<String, String> özellikleri, NpsItemClickListener npsItemClickListener, Activity) sahiptir.

Özellikler, isteğe bağlı olan parametreler, istediğiniz sorgu parametrelerini eklemeniz içindir.
nps ItemClickListener, kullanıcı bir banner’a 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.

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.

Code Block
languagejava
@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.

Code Block
languagejava
private VisilabsActionsCallback getVisilabsCallback() {
    return new VisilabsActionsCallback() {

        @Override
  try {     public void success(VisilabsActionsResponse message, String url) {
      FavsResponse favsResponse = new Gson().fromJson(response.getRawResponse(), FavsResponse.class);    List<FavoriteAttributeAction> favoriteAttributeActions = message.getFavoriteAttributeAction();
          String[] favBrandsbrands = favsResponsefavoriteAttributeActions.getFavoriteAttributeActionget(0)[0].getActiondata().getFavorites().getBrand()[0];
          //Continues like this...
   Log.i("Favs 1.Brand", favBrands);     }

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

veya

Code Block
languagejava
private VisilabsFavsRequestCallback getVisilabsCallback() {
     }
return new VisilabsFavsRequestCallback() {
        @Override
        public void fail(VisilabsResponse response void success(FavsResponse message, String url) {
            Log.di("Error", response.getRawResponse()LOG_TAG, "Success Request : " + url);
        }     };
}

veya

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

...

};
}

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;

Code Block
languagejava
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;

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

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

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

Image Added

Image Added

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;

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

...

App Banner

Uygulamanızın istediğiniz bir layout dosyasında istediğiniz bir yere BannerRecyclerView ı yerleştiriniz. Örnek xml :

Code Block
languagexml

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

Code Block
languagejava
    VisilabsRecyclerView visilabsRecyclerView = findViewById(R.id.vrv_story);

       StoryItemClickListener storyItemClickListener = new StoryItemClickListener() {
   <?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

  <com.visilabs.inApp.bannercarousel.BannerRecyclerView
      android:id="@+id/bannerListView"
 @Override     android:layout_width="match_parent"
       public void storyItemClicked(String storyLink) {android:layout_height="150dp"/>

  <Button
        android:id="@+id/btn_show_banner"
        Toast.makeText(getApplicationContext(), storyLink, Toast.LENGTH_LONG).show();android:layout_gravity="center"
      android:layout_width="150dp"
     }
 android:layout_height="50dp"
       };
 android:layout_marginTop="20dp"
       visilabsRecyclerView.setStoryAction(getApplicationContext(), storyItemClickListener);

 

İsterseniz Story Aksiyon Id ile de setleyebilirsiniz.

Code Block
languagejava
      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.

...

android:background="@drawable/rounded_corners_background"
      android:text="@string/show_banner" />
</LinearLayout>

Daha sonra ilgili program dosyasında (Java veya Kotlin) BannerRecyclerView objesine erişip requestBannerCarouselAction() methodunun çağırılması gereklidir. Bu method bir zorunlu (context: Context), 3 opsiyonel parametre(properties: HashMap<String, String>?, bannerRequestListener: BannerRequestListener?, bannerItemClickListener: BannerItemClickListener?) almaktadır.

properties parametresi sorguya eklemek istediğiniz ekstra query parametreleri içindir.

bannerRequestListener parametresi eğer sorgu sonucunda bir şeyler ters gider ve sunuculardan bilgi alınamazsa bunun size bildirimlesi içindir. Böylece layoutunuza eklediğiniz BannerRecyclerView in visibility sini View.GONE veya View.INVISIBLE yaparak ilgili alanın boş görünmesini engelleyebilirsiniz.

bannerItemClickListener parametresi kullanıcının herhangi bir banner a tıklaması sonucu SDK’nın otomatik yönlendirmesi yerine kendiniz yönlendirme yapmak istiyorsanız kullanabileceğiniz bir parametredir.

Tüm parametreleri içeren örnek bir kullanım aşağıdaki gibidir.

Code Block
languagejava
VisilabsCallbackbannerItemClickListener callback = new VisilabsCallback() {
    @Override
    public void success(VisilabsResponse response) {
        try{ new BannerItemClickListener() {
            @Override
JSONObject jsonObject = response.getJson();         public void bannerItemClicked(String bannerLink) String{
groupTitle = jsonObject.getString("title");             JSONArray jsonArray = jsonObject.getJSONArray("recommendations" Toast.makeText(getApplicationContext(), bannerLink, Toast.LENGTH_SHORT).show();
            for(int i = 0 ; i < jsonArray.length() ; i++) {Log.i("link banner", bannerLink);
                try {
  JSONObject currentProductObject = jsonArray.getJSONObject(i);               Intent viewIntent String= currentProductTitle = currentProductObject.getString("title"new Intent(Intent.ACTION_VIEW, Uri.parse(bannerLink));
                Double  currentProductPrice = currentProductObject.getDouble("price"startActivity(viewIntent);
                boolean} currentProductFreeShippingcatch = currentProductObject.getBoolean("freeshipping");
(Exception e) {
               String qs = currentProductObject.getString("qs");          Log.e(LOG_TAG, "The link is not formatted properly!");
 //Continues like this...             }
         } catch (Exception e){}
        };
   Log.e(LOG_TAG, e.getMessage(), e);   
BannerRequestListener bannerRequestListener = new BannerRequestListener() }{
    }     @Override   @Override
 public void fail(VisilabsResponse response) {       public void Log.e(LOG_TAG, response.getErrorMessage());onRequestResult(boolean isAvailable) {
     }
};

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

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

...

Code Block
languagejava
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();

...

Code Block
languagejava
// ö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;

Code Block
languagejava
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;

Code Block
languagejava
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

...

           if (!isAvailable) {
                    binding.bannerListView.setVisibility(View.GONE);
                }
            }
        };

        HashMap<String, String> properties = new HashMap<>();
        properties.put("OM.inapptype", "banner_carousel");

        binding.bannerListView.requestBannerCarouselAction(
                getApplicationContext(),
                properties,
                bannerRequestListener,
                bannerItemClickListener);

Ü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;

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

...

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

...

Image AddedImage Added