Visit www.talkable.com

Upgrade

Sometimes we need you to upgrade existing integration to use our latest features.

0.5.4

Fixed crashes when the server sends bad responses.

0.5.3

Added createEmailShare and createSocialShare methods to TalkableApi.

Deprecated createShare methods from TalkableApi.

0.5.2

Added support for title, url and imageUrl attributes for Item.

0.5.1

Added multiple coupons support for Event and Purchase.

0.5.0

Added an ability to handle errors when showing Offer.

To update from the previous version, please do following steps.

  1. Update dependencies inside build.gradle:

    // From
    compile 'com.google.code.gson:gson:2.7'
    compile 'com.android.support:support-v4:25.3.1'
    
    // To
    compile 'com.google.code.gson:gson:2.8'
    compile 'com.android.support:support-v4:26.1.0'
    
  2. Use showOffer functions with a callback parameter.

    // From
    showOffer(activity, origin);
    
    // To
    showOffer(activity, origin, new TalkableErrorCallback<TalkableOfferLoadException>() {
        @Override
        public void onError(final TalkableOfferLoadException error) {
            // Error handling. Note that it runs on non UI thread
        }
    });
    
  3. Use Talkable.setSiteSlug functions without Context as a parameter.

    // From
    setSiteSlug(context, "site-slug");
    
    // To
    setSiteSlug("site-slug");
    
  4. TalkableOfferFragmentListener interface implementation is optional now.

  5. In case you used TalkableOfferFragment directly check out a new workflow.

0.4.2

Read Contacts permission is optional from this version.

In case you used import_contacts callback, you have to define READ_CONTACTS permission inside the manifest:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.android.app.myapp" >
  <uses-permission android:name="android.permission.READ_CONTACTS" />
  ...
</manifest>

0.4.1

Fixed an issue inside TalkableOfferFragment.

0.4.0

Added multiple site slugs support. Bugs fixing.

From this moment you can operate with multiple Talkable sites inside Talkable SDK. Look in Advanced Usage for more detailed information if needed.

To update from the previous version, please do following steps.

  1. Update dependencies inside build.gradle.

    // From
    compile 'com.google.code.gson:gson:2.4'
    compile 'com.android.support:support-v4:24.2.1'
    
    // To
    compile 'com.google.code.gson:gson:2.7'
    compile 'com.android.support:support-v4:25.3.1'
    
  2. Change credentials setup inside the manifest.

    <!-- From -->
     <application>
         ...
         <meta-data
             android:name="TalkableApiKey"
             android:value="{{YOUR_TALKABLE_PUBLIC_API_KEY}}" />
         <meta-data
             android:name="TalkableSiteSlug"
             android:value="{{YOUR_SITE_SLUG}}" />
         ...
     </application>
    
     <!-- To -->
     <application>
         ...
         <meta-data
             android:name="tkbl-api-key-{{YOUR_SITE_SLUG}}"
             android:value="{{YOUR_TALKABLE_PUBLIC_API_KEY}}" />
         ...
     </application>
    
  3. Initialize Talkable in the Application.

    import com.talkable.sdk.Talkable;
    import android.app.Application;
    
    public class App extends Application {
        @Override
        public void onCreate() {
            super.onCreate();
            Talkable.initialize(this);
        }
    }
    

    Note

    Make sure to add your application class name as android:name parameter of the <application> element in your manifest

  4. Call Talkable.trackAppOpen inside you main activity class, like before.

    import com.talkable.sdk.Talkable;
    import android.app.Activity;
    
    public class MainActivity extends Activity {
        @Override
        public void onCreate(Bundle savedInstanceState) {
            ...
    
            Talkable.trackAppOpen(this);
        }
    }
    

From this version defining of TalkableActivity and InstallReferrerReceiver inside Android Manifest is not necessary.

0.3.1

Introducing TalkableOfferFragmentListener interface. Bugs fixing.

Fixed a bug when no campaign found and added TalkableOfferFragmentListener interface.

To use instance of TalkableOfferFragment directly you have to implement TalkableOfferFragmentListener interface from TalkableOfferFragment class inside an activity that uses the fragment. Look in Advanced Usage for more detailed information if needed.

0.3.0

Move to Fragments

Talkable SDK is built on top of Fragments (from Support Library) instead of Activities now to provide more flexibility for end users.

0.2.0

Deep linking scheme

Add this to AndroidManifest.xml inside definition of Talkable activity

<intent-filter>
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="tkbl-{{YOUR_SITE_SLUG}}" />
</intent-filter>

Tracking app opening

Replace Talkable.initialize(this); with Talkable.trackAppOpen(this); in your main activity. Look in installation section for more detailed information if needed.

0.1.0

It’s initial release, nothing to do.