Button

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

 @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);
 Button.getButton(this).getAction("btn-your-id", context, new Button.ActionListener() {
     @Override
     public void onAction(final AppAction action) {
         // Let's setup our Button
         android.widget.Button button = findViewById(R.id.activity_buy_tickets_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() {
         android.widget.Button button = findViewById(R.id.activity_buy_tickets_button);
         button.setVisibility(View.GONE);
     }
 });

  @Override
 	public void onNoAction() {
 		android.widget.Button button = findViewById(R.id.activity_buy_tickets_button);
 		button.setVisibility(View.GONE);
 	}
 });
 

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.

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

Will report an order attribution and its value & currency to this user, the order total will be a sum of all the line items.

 LineItem eggs = new LineItem("sku-123", 1099);
 LineItem milk = new LineItem("sku-567", 399, 3);
 LineItem onions = new LineItem("sku-89", 199, 1, "White Onion");
 List omeletteItems = Arrays.asList(eggs, milk, onions);

 Button.getButton(context).reportOrder(omeletteItems, "USD", UUID.randomUUID().toString());
 

Will report an order attribution and its value & currency to this user.

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.

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

Ceases all Button activity.

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"
       />