Personalizar el SDK de Android

Enlaces profundos

En su actividad que manejará el enlace profundo, agregue la etiqueta <data> con los parámetros scheme, host y pathPrefix.

<activity
          android:name=".PromoActivity"
          android:label="PromoActivity">
    <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="com.pushwoosh"
          android:host="promotion"
          android:pathPrefix="" />
    </intent-filter>
</activity>

En el ejemplo anterior, el enlace profundo abrirá PromoActivity. La implementación básica a continuación muestra una alerta con el valor del id de la promoción por simplicidad. ¡En su aplicación definitivamente podría hacer algo útil!

public class PromoActivity extends Activity
{
    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);

        setContentView(R.layout.deep_link);
        setTitle("Deep link activity");

        Intent intent = getIntent();
        String action = intent.getAction();
        Uri data = intent.getData();

        if (TextUtils.equals(action, Intent.ACTION_VIEW))
        {
            openUrl(data);
        }
    }

    private void openUrl(Uri uri)
    {
        String promoId = uri.getQueryParameter("id");
        Toast.makeText(getApplicationContext(), promoId, Toast.LENGTH_LONG).show();
    }
}

Seguimiento de compras in-app

Si desea realizar un seguimiento de las compras in-app en Customer Journeys, configure el envío de información de compra a Pushwoosh llamando a este método:

Pushwoosh.getInstance().sendInappPurchase(@NonNull String sku, @NonNull BigDecimal price, @NonNull String currency);

Notificación push de Geozones

Para usar los pushes de Geozone, agregue la librería com.pushwoosh:pushwoosh-location y llame a:

PushwooshLocation.startLocationTracking();

En su AndroidManifest.xml, incluya los permisos necesarios:

<manifest ... >
  <!-- Required for geolocation-based push notifications -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Required for precise location tracking -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

  <!-- Required for background location access on Android 10 (API level 29) and higher -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>

Uso de notificaciones locales con Pushwoosh

Si utiliza la API de Notificaciones Locales de Pushwoosh, agregue el permiso RECEIVE_BOOT_COMPLETED a su AndroidManifest.xml:

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>x

Uso del número de insignia en Android

Pushwoosh admite la configuración del número de insignia en el acceso directo del ícono de la aplicación para los siguientes lanzadores de Android:
Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, HUAWEI, ZUK, OPPO.
Para usar esta funcionalidad, simplemente agregue la librería com.pushwoosh:pushwoosh-badge a su aplicación.

Abrir una actividad personalizada

Si desea iniciar una actividad particular en respuesta a las notificaciones push, agregue el siguiente intent-filter a esa actividad:

<activity android:name="YourActivity">
    <intent-filter>
        <action android:name="${applicationId}.MESSAGE"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

Control del nivel de registro (Log Level)

Para ayudar con la depuración y la integración, el SDK imprimirá todas las solicitudes en la consola por defecto. Cuando esté listo para la compilación de producción, agregue los metadatos com.pushwoosh.log_level con el valor “ERROR” al AndroidManifest.xml. De esta manera, solo la información sobre errores irá a la consola. Otra opción podría ser una de las siguientes:

NONE - Sin registros del SDK
ERROR - Mostrar solo errores en la consola
WARN - Mostrar también advertencias
INFO - Mostrar mensajes informativos
DEBUG - Incluso la información de depuración se muestra ahora
NOISE - Todo lo que el SDK puede imprimir y más

<meta-data android:name="com.pushwoosh.log_level" android:value="ERROR" />

Uso de Proguard

Cuando use Proguard, agregue las siguientes opciones:

-keep class com.pushwoosh.** { *; }
-dontwarn com.pushwoosh.**

Vea los requisitos de la librería de Google Play Services con respecto a Proguard aquí:
https://developers.google.com/android/guides/setup

Personalización del comportamiento de apertura de notificaciones

Si necesita seleccionar programáticamente qué actividad mostrar como resultado de una notificación push, puede crear una NotificationServiceExtension personalizada e incluir el nombre de clase completamente calificado de su NotificationServiceExtension en los metadatos bajo el valor com.pushwoosh.notification_service_extension.

<meta-data
    android:name="com.pushwoosh.notification_service_extension"
    android:value="com.your.package.YourNotificationServiceExtension" />

public class YourNotificationServiceExtension extends NotificationServiceExtension {
    @Override
    protected void startActivityForPushMessage(PushMessage message) {
      // super.startActivityForPushMessage() starts default launcher activity
      // or activity marked with ${applicationId}.MESSAGE action.
      // Simply do not call it to override this behaviour.
        // super.startActivityForPushMessage(message);

        // start your activity instead:
        Intent launchIntent  = new Intent(getApplicationContext(), YourActivity.class);
        launchIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);

        // (Optional) pass notification data to Activity
        launchIntent.putExtra(Pushwoosh.PUSH_RECEIVE_EVENT, message.toJson().toString());

        context.startActivity(launchIntent);
    }
}

Personalización de las notificaciones push

Para personalizar la vista de las notificaciones push, necesita crear una Factory personalizada, puede crear una NotificationFactory personalizada e incluir el nombre de clase completamente calificado de su NotificationFactory en los metadatos bajo el valor com.pushwoosh.notification_factory.

<meta-data
    android:name="com.pushwoosh.notification_factory"
    android:value="com.your.package.YourNotificationFactory" />

public class YourNotificationFactory extends PushwooshNotificationFactory {
  @Override
  public Notification onGenerateNotification(@NonNull PushMessage pushMessage) {
    if (customNotification) {
       // TODO: generate and return custom notification
    }

    // return default Pushwoosh notification
    return super.onGenerateNotification(pushMessage);
  }
}

Personalización del resumen de grupo

Para personalizar la apariencia de un resumen de grupo, cree una Factory personalizada. Puede crear una SummaryNotificationFactory personalizada e incluir el nombre de clase completamente calificado de su SummaryNotificationFactory en los metadatos bajo el valor com.pushwoosh.summary_notification_factory.

<meta-data
    android:name="com.pushwoosh.summary_notification_factory"
    android:value="com.your.package.YourSummaryNotificationFactory" />

public class YourSummaryNotificationFactory extends PushwooshSummaryNotificationFactory {
    @Override
    public String summaryNotificationMessage(int notificationsAmount) {
        // return the message you want
        return super.summaryNotificationMessage(notificationsAmount);
    }
    @Override
    public int summaryNotificationIconResId() {
        // return the icon resource id you want
        return super.summaryNotificationIconResId();
    }
}

URL de endpoint privado

Pushwoosh proporciona endpoints privados para clientes con suscripciones al Plan Personalizado. Para configurar un endpoint privado para el SDK de Android, necesita agregar lo siguiente a su archivo AndroidManifest.xml:

<meta-data android:name="com.pushwoosh.base_url" android:value="PUSHWOOSH_PRIVATE_ENDPOINT_URL_PROVIDED" />

Creación de una cola de Rich Media

En caso de que haya varias páginas de Rich Media para mostrar simultáneamente (por ejemplo, los eventos de activación para dos o más In-Apps ocurren en un momento, o una página de Rich Media ya se está mostrando en el momento en que ocurre un evento de activación diferente), puede configurar una cola para la visualización de páginas de Rich Media. Para crear una cola, agregue el siguiente código a su proyecto:

package com.pushwoosh.testingapp;

import com.pushwoosh.RichMediaManager;
import com.pushwoosh.exception.PushwooshException;
import com.pushwoosh.richmedia.RichMediaPresentingDelegate;
import com.pushwoosh.richmedia.RichMedia;
import com.pushwoosh.internal.utils.PWLog;

import java.util.ArrayDeque;
import java.util.concurrent.locks.ReentrantLock;

public class DefaultRichMediaPresentingDelegate implements RichMediaPresentingDelegate {
    private final String TAG = DefaultRichMediaPresentingDelegate.class.getSimpleName();
    private ArrayDeque<RichMedia> richMediaQueue = new ArrayDeque<>();
    private RichMedia currentRichMedia = null;
    private ReentrantLock reentrantLock;

    public DefaultRichMediaPresentingDelegate() {
        PWLog.noise(TAG, "new DefaultRichMediaPresentingDelegate:" + this);
        reentrantLock = new ReentrantLock();
    }

    @Override
    public boolean shouldPresent(RichMedia richMedia) {
        PWLog.noise(TAG, "shouldPresent:" + richMedia);
        if (currentRichMedia == null) {
            PWLog.noise(TAG, "currentRichMedia is null");
        }
        if (richMedia.isLockScreen()) {
            PWLog.noise(TAG, "isLockScreen is true");
            return true;
        }
        try {
            reentrantLock.lock();
            if (currentRichMedia == null) {
                PWLog.noise(TAG, "show:" + richMedia);
                currentRichMedia = richMedia;
                return true;
            } else {
                PWLog.noise(TAG, "add to queue:" + richMedia);
                richMediaQueue.add(richMedia);
                return false;
            }
        } finally {
            reentrantLock.unlock();
        }
    }

    @Override
    public void onPresent(RichMedia richMedia) {
        PWLog.noise(TAG, "onPresent" + richMedia);
    }

    @Override
    public void onError(RichMedia richMedia, PushwooshException pushwooshException) {
        PWLog.error(TAG, pushwooshException + " richMedia:"+richMedia.toString());
        tryShowNextRichMediaThreadSafety();
    }

    @Override
    public void onClose(RichMedia richMedia) {
        PWLog.noise(TAG, "onClose:" + richMedia);
        tryShowNextRichMediaThreadSafety();
    }

    private void tryShowNextRichMediaThreadSafety() {
        try {
            reentrantLock.lock();
            tryShowNextRichMedia();
        } finally {
            reentrantLock.unlock();
        }
    }

    private void tryShowNextRichMedia() {
        if (!richMediaQueue.isEmpty()) {
      currentRichMedia = richMediaQueue.poll();
      PWLog.noise(TAG, "try manual show:" + currentRichMedia);
      RichMediaManager.present(currentRichMedia);
    } else {
      PWLog.noise(TAG, "richMediaQueue is empty");
      currentRichMedia = null;
    }
    }
}

Push con sonido personalizado

Coloque su archivo de audio en la carpeta adecuada. Para el framework nativo de Android, sus archivos deben colocarse en la carpeta /app/src/main/res/raw.

2. Cree un Canal de Notificación.

3. Seleccione un sonido mientras configura un mensaje push.

4. Establezca el Canal de Notificación al que pertenecerá el mensaje. Para ello, especifique lo siguiente en el campo “Android root params”:{"pw_channel": "PUSH NOTIFICATION CHANNEL NAME"} //`` aquí necesita especificar el nombre de su canal con sonido personalizado

En caso de usar la API remota, establezca los parámetros de la siguiente manera dentro de su solicitud de API /createMessage:

"android_root_params": {"pw_channel": "push"} // aquí necesita especificar el nombre de su canal con sonido personalizado, por ejemplo, "push" para las notificaciones con sonido push.wav.
"android_sound": "push" // aquí debe especificar el nombre del archivo sin extensión

Una vez que envíe el push con esos parámetros especificados, se crea el Canal de Notificación con el sonido seleccionado para todos los dispositivos con Android 8+.

Ahora, para enviar el push con un sonido personalizado, solo tiene que especificar el canal asociado con ese sonido.

Reglas de Proguard para sonidos de notificación personalizados

Si su aplicación utiliza Proguard para la reducción de código y recursos, es importante mantener sus archivos de sonido intactos y disponibles para librerías externas. Si utiliza la propiedad minifyEnabled = true en su build.gradle, agregue las siguientes reglas a su proguard-rules.pro:

-keep public class your.package.name.R$raw {
 *;
}

Si reduce los recursos de su aplicación además de la reducción de código usando la propiedad shrinkResources=true, debe especificar adicionalmente qué recursos desea conservar. Para ello, cree un nuevo archivo XML con cualquier nombre, guárdelo en algún lugar de su proyecto (por ejemplo, en res/xml), y especifique los nombres de los recursos bajo el parámetro tools:keep en la etiqueta resources:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
 tools:keep="@raw/*"
/>

Lista completa de flags de metadatos del SDK de Android

Para configurar un flag, necesita agregar el bloque de metadatos a su archivo AndroidManifest.xml dentro de la etiqueta application. Por ejemplo, si desea establecer el ID de la aplicación de Pushwoosh, agregue el siguiente código a su archivo AndroidManifest.xml:

<meta-data
    android:name="com.pushwoosh.appid"
    android:value="XXXXX-XXXXX" />

Flag	Descripción	Valores posibles
com.pushwoosh.appid	Establece el ID de la aplicación de Pushwoosh.	XXXXX-XXXXX
com.pushwoosh.senderid	Establece el ID de remitente del proyecto de Firebase.	123456789000
com.pushwoosh.log_level	Establece el nivel de registro. Para más detalles, consulte Control del nivel de registro.	NONE / ERROR / WARN / INFO / DEBUG (por defecto) / NOISE
com.pushwoosh.base_url	Sobrescribe la URL base del servidor de Pushwoosh.	https://cp.pushwoosh.com/json/1.3/ (por defecto)
com.pushwoosh.notification_service_extension	NotificationServiceExtension personalizado. Para más detalles, consulte Personalización del comportamiento de apertura de notificaciones.	com.myapp.MyNotificationServiceExtension
com.pushwoosh.notification_factory	NotificationFactory personalizado. Para más detalles, consulte Personalización de las notificaciones push.	com.myapp.MyNotificationFactory
com.pushwoosh.summary_notification_factory	SummaryNotificationFactory personalizado.	com.myapp.MySummaryNotificationFactory
com.pushwoosh.multi_notification_mode	Si es true, las notificaciones se agruparán. Si es false, solo se mostrará la última notificación recibida.	true / false (por defecto)
com.pushwoosh.allow_server_communication	Si es true, el SDK tiene permitido enviar solicitudes de red a los servidores de Pushwoosh.	true (por defecto) / false
com.pushwoosh.handle_notifications_using_workmanager	Si es true, se establece WorkManager para manejar las notificaciones.	true / false (por defecto)
com.pushwoosh.notification_icon	Nombre del recurso del ícono de notificación personalizado (pequeño). Si es nulo, se usará el ícono de la aplicación por defecto.	res/drawable-xxhdpi-v11/notification_small_icon.png / null
com.pushwoosh.notification_icon_color	Color de fondo del ícono de notificación (pequeño).	#FFFFFF
com.pushwoosh.allow_collecting_device_data	Si es true, el SDK tiene permitido recopilar y enviar datos del dispositivo a Pushwoosh.	true (por defecto) / false
com.pushwoosh.allow_collecting_device_os_version	Si es true, el SDK tiene permitido recopilar y enviar la versión del sistema operativo del dispositivo a Pushwoosh.	true (por defecto) / false
com.pushwoosh.allow_collecting_device_locale	Si es true, el SDK tiene permitido recopilar y enviar la configuración regional del dispositivo a Pushwoosh.	true (por defecto) / false
com.pushwoosh.allow_collecting_device_model	Si es true, el SDK tiene permitido recopilar y enviar el modelo del dispositivo a Pushwoosh.	true (por defecto) / false
com.pushwoosh.in_app_business_solutions_capping	Limita el número de veces que el In-App push-unregister puede mostrarse en un día.	1 (por defecto), 2, …, n
com.pushwoosh.start_foreground_service	Si es true, el Servicio en Primer Plano se inicia junto con la llamada a PushwooshLocation.startLocationTracking()	true / false (por defecto)
com.pushwoosh.foreground_service_notification_text	Establece el texto de una notificación creada cuando se inicia el Servicio en Primer Plano para la clave “com.pushwoosh.start_foreground_service”.	Work in progress (por defecto)
com.pushwoosh.foreground_service_notification_channel_name	Establece el nombre del canal para la notificación creada cuando se inicia el Servicio en Primer Plano para la clave “com.pushwoosh.start_foreground_service”.	Foreground service (por defecto)
com.pushwoosh.trusted_package_names	Permite compartir el HWID de Pushwoosh con el paquete especificado	”com.mycompany.myapp1, com.mycompany.myapp2”

Eliminación de notificaciones push mediante TTL (Time-To-Live)

Para eliminar automáticamente las notificaciones push después de un período de tiempo especificado usando TTL (Time-to-Live), siga estos pasos:

Cree una NotificationFactory personalizada. Aprenda más
En el método onGenerateNotification(), cree una notificación usando la clase Notification.Builder o NotificationCompat.Builder y llame al método setTimeoutAfter:

public class YourNotificationFactory extends PushwooshNotificationFactory {

    @Override
    public Notification onGenerateNotification(@NonNull PushMessage pushMessage) {
        Notification.Builder builder = new Notification.Builder(getApplicationContext(), addChannel(pushData));

        Notification notification = builder.setContentText(pushData.getMessage())
                                           .setContentTitle(title)
                                           .setContentText(text)
                                           // rest of your notification creation code
                                           .setTimeoutAfter(timeout) // time in milliseconds before the notification is canceled
                                           .build();
    }
}

Comparta sus comentarios con nosotros

Sus comentarios nos ayudan a crear una mejor experiencia, por lo que nos encantaría saber de usted si tiene algún problema durante el proceso de integración del SDK. Si enfrenta alguna dificultad, no dude en compartir sus pensamientos con nosotros a través de este formulario.