Button

Indicates whether an app action can be fetched for provided url.@Override public void onAction(final AppAction action) { action.invokeAction(); }@Override public void onNoAction() { } } } }</pre>

This method will check if there's any pending deferred deep link for this user after an installation. You'd want to check this in your main launcher intent activity's onCreate. For most application you'd only need to override onDeepLink(Intent) and call startActivity(Intent). First you need to setup your application in the dashboard, follow our interactive setup here.

 @Override
 public void onCreate(final Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    com.usebutton.sdk.Button.checkForDeepLink(new com.usebutton.sdk.Button.DeepLinkListener() {
       @Override
       public void onDeepLink(final Intent intent) {
          // Deep link received, let's open it.
          startActivity(intent);
       }

       @Override
       public void onNoDeepLink() {}
    });
    setContentView(R.layout.your_activity);
    // ...
 }
 

Disable SDK debug logging, see enableDebugLogging() for more details.

Will enable useful debug logging from the Button SDK (tag Button). We recommend you call this function before start(). Use adb logcat ButtonSDK:D *:S to filter on Button log statements only.

If you need to customize the Button experience past styling the ButtonDropin you can use this method to get full control. Most integrators should use a ButtonDropin in their layout instead. Code example:

 final Location venue = new Location("Madison Square Garden");
 venue.putIdentifier(Identifiers.IDENTIFIER_TICKETMASTER, "483329");
 final ButtonContext context = ButtonContext.withSubjectLocation(venue);
 android.widget.Button button = findViewById(R.id.activity_buy_tickets_button);
 Button.getButton(this).getAction("btn-your-id", context, new Button.ActionListener() {
     @Override
     public void onAction(final AppAction action) {
         // Let's setup our Button
         final Preview preview = action.getPreview();
         final Text previewText = preview.getText();
         // This will set both text and text color.
         previewText.applyTo(button);
         // Let's also style our Button with some brand colors
         button.setBackgroundColor(preview.getBackgroundColor());
         // Important that you register a click listener to invoke the action
         button.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(final View v) {
                 action.invokePreview(v.getContext());
             }
         });
     }

     @Override
     public void onNoAction() {
         button.setVisibility(View.GONE);
     }
 });
 

Fetches an app action for a merchantId.

Fetches an app action for a supported url.

Gets the shared Button instance & lazily instantiates if not yet created.

You can use this method to check if the current user came in through a Button deep link or not (null)

Clears any session information and effectively creates a new customer. Use when e.g. the user logs out or changes in the host application. Don't forget to also set the user identifier upon registration or login by calling setUserIdentifier(String) .

Call this if you need to have the Button SDK reload its language settings from Locale.getDefault() (in case you're forcing a different language in your app from the device default.

     Button.getButton(context).start(); // started with device default
     Locale.setDefault(Locale.forLanguageTag("nb-NO"));
     Button.getButton(context).onLocaleChanged();
     // SDK will now reload its internal dictionary
 

Report a custom named event with an optional dictionary of parameters (JSONObject), for example a registration or a restaurant table reservation.

Call with a non-null value to associate your own unique identifier with the current Button session. For example, this value can be a username, e-mail address, or profile ID. It can be used with certain Button backend reporting features. You should call this when you've established a user's identify, like after a sign up or login. Don't forget to mirror this with calling logout() when the user logs out.

Initializes Button for your application, preferably called from android.app.Application.onCreate(). Remember to add your application ID to your AndroidManifest.xml first, see Button for example

Similar to startMerchantAction(MerchantAction, MerchantAction.OnCompleteListener) Includes a MerchantActionSettings to configure whether Button should handle URLs that it cannot commission.

Pass your URLs to Button via MerchantAction.

When starting a MerchantAction, Button will take control and detect whether the URL can be exchanged for a commissioned Checkout Flow including installing the merchant app if necessary. If Button cannot exchange the URL, it will open the it in an in-app web view.

Similar to startMerchantAction(MerchantAction). Includes a callback to know when the Button Checkout Flow has completed.

Convenience method to check if a promotion will be filled given a placement ID and context. See ButtonDropin for more information about context. You can use this to e.g. show/hide ButtonDropin's layout container. For instructions on finding your buttonId, see Button

 <com.usebutton.sdk.ButtonDropin
           android:layout_width="match_parent"
           android:layout_height="60dp"
           android:layout_margin="10dp"
           button:buttonId="your-button-id"
           button:textColor="@color/white"
           button:textSize="18dp"
       />