Objet Android
L’objet
android_push
vous permet de définir ou de demander des informations relatives au contenu Android Push et Android Push Alert par le biais de nos points d’extrémité de messages.
Objet Notification push Android
Vous devez inclure un objet Android push dans messages
si vous voulez que les utilisateurs que vous avez ciblés reçoivent un push sur leurs appareils Android. Le nombre total d’octets de votre chaîne de caractères alert
et de votre objet extra
ne doit pas dépasser 4 000. L’API de messagerie renvoie une erreur si vous dépassez la taille de message autorisée par Google.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
"alert": (required, string) the notification message,
"title": (required, string) the title that appears in the notification drawer,
"extra": (optional, object) additional keys and values to be sent in the push,
"message_variation_id": (optional, string) used when providing a campaign_id to specify which message variation this message should be tracked under (must be an Android Push Message),
"notification_channel_id": (optional, string) the channel ID the notification will be sent with,
"priority": (optional, integer) the notification priority value,
"android_priority": (optional, string) the FCM sender priority,
"send_to_sync": (optional, if set to true we will throw an error if "alert" or "title" is set),
"collapse_key": (optional, string) the collapse key for this message,
// Specifying "default" in the sound field will play the standard notification sound
"sound": (optional, string) the location of a custom notification sound within the app,
"custom_uri": (optional, string) a web URL, or Deep Link URI,
"summary_text": (optional, string),
"time_to_live": (optional, integer (maximum of 2,419,200 seconds)),
"notification_id": (optional, integer),
"push_icon_image_url": (optional, string) an image URL for the large icon,
"accent_color": (optional, integer) accent color to be applied by the standard Style templates when presenting this notification, an RGB integer value,
"send_to_most_recent_device_only": (optional, boolean) defaults to false, if set to true, Braze will only send this push to a user's most recently used Android device, rather than all eligible Android devices,
"buttons" : (optional, array of Android push action button objects) push action buttons to display
"conversation_data" : (optional, Android Conversation Push Object) the data to be displayed through Conversation Push.
}
Vous pouvez envoyer des notifications « Big Picture » en spécifiant la clé appboy_image_url
dans l’objet extra
. La valeur de appboy_image_url
doit être une URL qui renvoie à l’emplacement où votre image est hébergée. Les images doivent être recadrées à un rapport hauteur/largeur de 2:1 et doivent avoir une taille minimale de 600 x 300 px.
Informations relatives aux paramètres supplémentaires
Paramètre | Détails |
---|---|
priority |
Ce paramètre accepte les valeurs entre -2 et 2 , où -2 représente la priorité « MIN » et 2 représente la priorité « MAX ». 0 est la valeur « PAR DÉFAUT ». Toutes les valeurs envoyées en dehors de cette plage prendront la valeur 0 par défaut. Pour plus d’informations sur le niveau de priorité à utiliser, voir Priorité des notifications Android. |
android_priority |
Ce paramètre accepte les valeurs “normal” ou “élevé” pour spécifier la priorité de l’expéditeur FCM. Par défaut, les messages de notification sont envoyés avec une priorité élevée et les messages de données avec une priorité normale. Pour plus d’informations sur l’impact des différentes valeurs sur la réception/distribution, voir Priorité des messages Android. |
collapse_key |
FCM peut stocker simultanément jusqu’à quatre clés de réduction par appareil. Si vous utilisez plus de quatre clés de réduction, FCM ne donne aucune garantie quant à celles qui seront conservées. Braze utilise l’un de ces éléments par défaut pour les campagnes, assurez-vous donc de ne spécifier que jusqu’à trois clés de réduction supplémentaires pour les messages Android. |
push_icon_image_url |
La valeur du paramètre des grandes icônes doit être une URL qui renvoie à l’emplacement où votre image est hébergée. Les images doivent être recadrées selon un apport hauteur/largeur 1:1 et mesurer au moins 40x40. |
notification_channel |
Si cela n’est pas spécifié, Braze tentera d’envoyer la charge utile de la notification avec l’ID du canal de repli du tableau de bord. Pour en savoir plus, consultez la section Canaux de notification et reportez-vous aux étapes de définition des canaux de notification lors de l’intégration. |
send_to_sync |
Pour plus d’informations sur les messages send_to_sync , consultez les notifications Android silencieuses. |
Objet Bouton d’action push Android
1
2
3
4
5
6
{
"text": (required, string) the button's text,
"action": (optional, string) one of "OPEN_APP", "URI", "DEEP_LINK", or "CLOSE", defaults to "OPEN_APP",
"uri": (optional, string) a web URL or Deep Link URI,
"use_webview": (optional, boolean) whether to open the web URL inside the app if the action is "URI", defaults to true
}
Objet de notification push de conversation pour Android
Les concepts présentés dans ce message correspondent à ceux de la documentation Android People et Conversations push.
1
2
3
4
5
6
{
"shortcut_id" : (required, string) the sharing shortcut identifier,
"reply_person_id" : (required, string) the identifier of the Person this push is replying to,
"messages" : (required, array of Android Conversation Push Message Object),
"persons" : (required, array of Android Conversation Push Person Object)
}
Objet Notification push Android de conversation pour les messages
1
2
3
4
5
{
"text" : (required, string) the text of this message,
"timestamp" : (required, integer) the unix timestamp of when this message was sent,
"person_id" : (required, string) the Person identifier of this message's sender,
}
Objet Notification push Android de conversation pour les personnes
1
2
3
4
{
"id" : (required, string) the identifier of this Person,
"name" : (required, string) the display name of this Person
}