Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GlobalLink Translation PR #5000

Merged
merged 3 commits into from
Mar 14, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Voici un exemple tronqué avec une famille de polices personnalisée, `my_custom

Pour définir une icône épinglée personnalisée, remplacez le style `Braze.ContentCards.PinnedIcon`. Votre actif d’image personnalisé doit être déclaré dans l’élément `android:src`.

## Rendu carte personnalisée{#customizing-card-rendering-for-android}
## Rendu de carte personnalisée {#customizing-card-rendering-for-android}

Les informations suivantes indiquent comment modifier la manière dont une carte est affichée dans le `recyclerView`. L’interface `IContentCardsViewBindingHandler` définit la façon dont toutes les cartes de contenu sont affichées. Vous pouvez personnaliser cela pour modifier tout ce que vous voulez :

Expand Down Expand Up @@ -289,7 +289,7 @@ Par défaut, les vues des cartes de contenu répondent automatiquement aux modif

Pour écraser ce comportement, remplacez les valeurs `values-night` dans `android-sdk-ui/src/main/res/values-night/colors.xml` et `android-sdk-ui/src/main/res/values-night/dimens.xml`.

[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.appboy.models.cards/-card/get-extras.html
[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.cards/-card/extras.html
[40]: {{site.baseurl}}/developer_guide/platform_integration_guides/android/advanced_use_cases/font_customization/#font-customization
[42]: https://github.com/Appboy/appboy-android-sdk/blob/master/android-sdk-ui/src/main/res/values/styles.xml
[44]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.ui.contentcards.handlers/-i-content-cards-update-handler/index.html
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ channel:

# Personnalisation du flux des cartes de contenu par défaut {#content-cards-fragment-customization}

Cette section couvre la personnalisation du [ContentCardsFragment][49][dont la source se trouve sur GitHub][54].
Cette section couvre la personnalisation du [ContentCardsFragment][49] dont la source se trouve sur [GitHub][54]

## Personnaliser l’ordre d’affichage des cartes {#customizing-displayed-card-order-for-android}

Expand Down Expand Up @@ -156,7 +156,7 @@ class DefaultContentCardsUpdateHandler : IContentCardsUpdateHandler {
{% endtab %}
{% endtabs %}

Ce code peut également être trouvé ici, [DefaultContentCardsUpdateHandler][46].
Ce code est également disponible ici, [DefaultContentCardsUpdateHandler][46].

Voici comment utiliser cette classe :

Expand Down Expand Up @@ -187,7 +187,7 @@ fragment.setContentCardUpdateHandler(cardUpdateHandler)

Si le [`ContentCardsFragment`][49] détermine qu’une actualisation de la carte de contenu a échoué, il affiche un message d’erreur de connexion réseau.

Un adaptateur spécial, le [`EmptyContentCardsAdapter`][50] remplace la norme [`ContentCardAdapter`][53] pour afficher le message d’erreur. Pour définir le message personnalisé lui-même, remplacez la ressource string `com_braze_feed_empty`..
Un adaptateur spécial, le [`EmptyContentCardsAdapter`][50] remplace la norme [`ContentCardAdapter`][53] pour afficher le message d’erreur. Pour définir le message personnalisé lui-même, remplacez la ressource de chaîne de caractère `com_braze_feed_empty`.

Le style utilisé pour afficher ce message peut être trouvé via [`Braze.ContentCardsDisplay.Empty`][52] et est reproduit dans l’extrait de code suivant :

Expand All @@ -210,7 +210,7 @@ Pour personnaliser complètement le comportement d’erreur réseau, vous pouvez
[53]: https://github.com/Appboy/appboy-android-sdk/blob/master/android-sdk-ui/src/main/java/com/braze/ui/contentcards/adapters/ContentCardAdapter.kt
[54]: https://github.com/Appboy/appboy-android-sdk/blob/master/android-sdk-ui/src/main/java/com/braze/ui/contentcards/ContentCardsFragment.kt
[50]: https://github.com/Appboy/appboy-android-sdk/blob/master/android-sdk-ui/src/main/java/com/braze/ui/contentcards/adapters/EmptyContentCardsAdapter.kt
[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.appboy.models.cards/-card/extras.html
[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.cards/-card/extras.html
[44]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.ui.contentcards.handlers/-i-content-cards-update-handler/index.html
[45]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.ui.contentcards/-content-cards-fragment/set-content-card-update-handler.html
[46]: https://github.com/Appboy/appboy-android-sdk/blob/v11.0.0/android-sdk-ui/src/main/java/com/appboy/ui/contentcards/handlers/DefaultContentCardsUpdateHandler.java
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ channel:

Les objets `Card` peuvent éventuellement porter des paires clé-valeur comme `extras`. Elles peuvent être utilisées pour envoyer des données avec une `Card` pour une manipulation ultérieure par l’application.

Consultez notre [KDoc ][36] pour plus d’informations.
Consultez notre [KDoc][36] pour plus d’informations.

{% alert note %}
Les cartes de contenu ont une limite de taille maximale de 2 kb pour le contenu que vous saisissez dans le tableau de bord de Braze. Cela inclut le texte des messages, les URL d’images, les liens et les paires clé-valeur. Dépasser ce montant empêchera la carte d’être envoyée.
{% endalert %}

[1]: {{site.baseurl}}/user_guide/message_building_by_channel/content_cards/customize/#customization-approaches
[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.appboy.models.cards/-card/#-2118252107%2FProperties%2F-1725759721
[36]: https://appboy.github.io/appboy-android-sdk/kdoc/braze-android-sdk/com.braze.models.cards/-card/#-2118252107%2FProperties%2F-1725759721
Original file line number Diff line number Diff line change
@@ -1,156 +1,158 @@
---
nav_title: Configuration initiale du SDK
article_title: Configuration initiale du SDK pour Flutter
platform: Flutter
page_order: 1
description: "Cette référence présente le SDK Flutter et explique comment l’intégrer nativement sur Android et iOS."
search_rank: 1
---

# Configuration initiale du SDK

Suivez ces instructions pour installer le [SDK Braze pour Flutter][1] qui contient un package permettant aux intégrateurs d’utiliser les API Braze dans les [applications Flutter ][2] rédigées dans Dart. Ce plug-in offre une fonctionnalité d’analytique de base et vous permet d’intégrer des messages in-app et des cartes de contenu pour iOS et Android à l’aide d’une base de code unique.

{% alert note %}
Vous devrez effectuer les étapes d’installation séparément sur les deux platesformes.
{% endalert %}

## Conditions préalables

Pour terminer l’installation, vous aurez besoin de la [clé API ][3]d’identification de l’application[ ainsi que de l’endpoint SDK][4]. Les deux sont situés dans **Manage Settings** dans le tableau de bord.

Avant de suivre ces étapes, installez et configurez le [SDK Flutter][5].

## Étape 1 : Intégrez la bibliothèque Braze

Ajoutez le kit SDK Braze pour Flutter à partir de la ligne de commande.

```bash
flutter pub add braze_plugin
```

Cela ajoutera la ligne appropriée à votre `pubspec.yaml`.

## Étape 2 : Configuration native complète

{% tabs %}
{% tab Android %}

Pour vous connecter aux serveurs Braze, créez un fichier `braze.xml` dans le dossier `android/res/values` de votre projet. Collez le code suivant et remplacez la clé d’identification API et le endpoint par vos valeurs :

```xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
<string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_ENDPOINT_OR_CLUSTER</string>
</resources>
```

Ajoutez les autorisations requises à votre fichier `AndroidManifest.xml` :

```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

{% endtab %}
{% tab iOS %}
{% subtabs global %}
{% subtab SWIFT %}
Ajoutez l’importation SDK Braze en haut du fichier `AppDelegate.swift` :
```swift
import BrazeKit
```

Dans le même fichier, créez l’objet de configuration Braze dans la méthode `application:didFinishLaunchingWithOptions:` et remplacez la clé API et le endpoint par les valeurs de votre application. Ensuite, créez l’instance Braze à l’aide de la configuration et créez une propriété statique sur AppDelegate pour un accès facile :

```swift
static var braze: Braze? = nil

func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
// Setup Braze
let configuration = Braze.Configuration(
apiKey: "<BRAZE_API_KEY>",
endpoint: "<BRAZE_ENDPOINT>"
)
// Activez la journalisation ou personnalisez la configuration ici.
let braze = BrazePlugin.initBraze(configuration)
AppDelegate.braze = braze

return true
}
```
{% endsubtab %}
{% subtab OBJECTIVE-C %}
Importez `BrazeKit` en haut du fichier `AppDelegate.m` :
```objc
@import BrazeKit;
```

Dans le même fichier, créez l’objet de configuration Braze dans la méthode `application:didFinishLaunchingWithOptions:` et remplacez la clé API et le endpoint par les valeurs de votre application. Ensuite, créez l’instance Braze à l’aide de la configuration et créez une propriété statique sur AppDelegate pour un accès facile :

```objc
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Setup Braze
BRZConfiguration *configuration =
[[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
endpoint:@"<BRAZE_ENDPOINT>"];
// - Activez la journalisation ou personnalisez la configuration ici.
Braze *braze = [BrazePlugin initBraze:configuration];
AppDelegate.braze = braze;

[self.window makeKeyAndVisible];
return YES;
}

#pragma mark - AppDelegate.braze

static Braze *_braze = nil;

+ (Braze *)braze {
return _braze;
}

+ (void)setBraze:(Braze *)braze {
_braze = braze;
}
```
{% endsubtab %}
{% endsubtabs %}

{% endtab %}
{% endtabs %}

## Étape 3 : Utilisation

Pour importer le plug-in dans votre code Dart, utilisez ce qui suit :

```dart
import 'package:braze_plugin/braze_plugin.dart';
```

Puis, initialisez une instance du plug-in Braze en appelant `new BrazePlugin()` comme dans [notre exemple d’application.][6].

## Testez votre intégration de base

À ce stade, vous pouvez vérifier que le SDK est intégré en vérifiant les statistiques de session dans le tableau de bord. Si vous exécutez votre application sur une des deux plateformes, vous devriez voir une nouvelle session dans le tableau de bord (dans la section **Overview**).

Vous pouvez ouvrir une session pour un utilisateur particulier en appelant le code suivant dans votre application.

```dart
BrazePlugin braze = BrazePlugin();
braze.changeUser("{some-user-id}");
```

Recherchez ensuite l’utilisateur avec `{some-user-id}` dans le tableau de bord sous **User Search**. Vous pouvez y vérifier que les données de session et d’appareil ont été enregistrées.

[1]: https://pub.dev/packages/braze_plugin
[2]: https://flutter.dev/
[3]: {{site.baseurl}}/api/api_key/#the-app-identifier-api-key
[4]: {{site.baseurl}}/api/basics/#endpoints
[5]: https://docs.flutter.dev/get-started/install
[6]: https://github.com/braze-inc/braze-flutter-sdk/blob/master/example/lib/main.dart
---
nav_title: Configuration initiale du SDK
article_title: Configuration initiale du SDK pour Flutter
platform: Flutter
page_order: 1
description: "Cette référence présente le SDK Flutter et explique comment l’intégrer nativement sur Android et iOS."
search_rank: 1
---

# Configuration initiale du SDK

Suivez ces instructions pour installer le [SDK Braze pour Flutter][1] qui contient un package permettant aux intégrateurs d’utiliser les API Braze dans les [applications Flutter][2] écrites dans Dart. Ce plug-in offre une fonctionnalité d’analytique de base et vous permet d’intégrer des messages in-app et des cartes de contenu pour iOS et Android à l’aide d’une base de code unique.

{% alert note %}
Vous devrez effectuer les étapes d’installation séparément sur les deux plates-formes.
{% endalert %}

## Conditions préalables

Pour terminer l’installation, vous aurez besoin de la [clé API d’identification de l’application][3] ainsi que de l’[endpoint SDK][4]. Les deux sont situés dans **Manage Settings (Gérer les paramètres)** dans le tableau de bord.

Avant de suivre ces étapes, installez et configurez le [SDK Flutter][5].

## Étape 1 : Intégrez la bibliothèque Braze

Ajoutez le kit SDK Braze pour Flutter à partir de la ligne de commande.

```bash
flutter pub add braze_plugin
```

Cela ajoutera la ligne appropriée à votre `pubspec.yaml`.

## Étape 2 : Configuration native complète

{% tabs %}
{% tab Android %}

Pour vous connecter aux serveurs Braze, créez un fichier `braze.xml` dans le dossier `android/res/values` de votre projet. Collez le code suivant et remplacez la clé d’identification API et l’endpoint par vos valeurs :

```xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
<string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_ENDPOINT_OR_CLUSTER</string>
</resources>
```

Ajoutez les autorisations requises à votre fichier `AndroidManifest.xml` :

```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

{% endtab %}
{% tab iOS %}
{% subtabs global %}
{% subtab SWIFT %}
Ajoutez l’importation SDK Braze en haut du fichier `AppDelegate.swift` :
```swift
import BrazeKit
```

Dans le même fichier, créez l’objet de configuration Braze dans la méthode `application(_:didFinishLaunchingWithOptions:)` et remplacez la clé API et le endpoint par les valeurs de votre application. Ensuite, créez l’instance Braze à l’aide de la configuration et créez une propriété statique sur `AppDelegate` pour un accès facile :

```swift
static var braze: Braze? = nil

func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
// Setup Braze
let configuration = Braze.Configuration(
apiKey: "<BRAZE_API_KEY>",
endpoint: "<BRAZE_ENDPOINT>"
)
// - Enable logging or customize configuration here
configuration.logger.level = .info
let braze = BrazePlugin.initBraze(configuration)
AppDelegate.braze = braze

return true
}
```
{% endsubtab %}
{% subtab OBJECTIVE-C %}
Importez `BrazeKit` en haut du fichier `AppDelegate.m` :
```objc
@import BrazeKit;
```

Dans le même fichier, créez l’objet de configuration Braze dans la méthode `application:didFinishLaunchingWithOptions:` et remplacez la clé API et le endpoint par les valeurs de votre application. Ensuite, créez l’instance Braze à l’aide de la configuration et créez une propriété statique sur `AppDelegate` pour un accès facile :

```objc
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Setup Braze
BRZConfiguration *configuration =
[[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
endpoint:@"<BRAZE_ENDPOINT>"];
// - Enable logging or customize configuration here
configuration.logger.level = BRZLoggerLevelInfo;
Braze *braze = [BrazePlugin initBraze:configuration];
AppDelegate.braze = braze;

[self.window makeKeyAndVisible];
return YES;
}

#pragma mark - AppDelegate.braze

static Braze *_braze = nil;

+ (Braze *)braze {
return _braze;
}

+ (void)setBraze:(Braze *)braze {
_braze = braze;
}
```
{% endsubtab %}
{% endsubtabs %}

{% endtab %}
{% endtabs %}

## Étape 3 : Utilisation

Pour importer le plug-in dans votre code Dart, utilisez ce qui suit :

```dart
import 'package:braze_plugin/braze_plugin.dart';
```

Puis, initialisez une instance du plug-in Braze en appelant `new BrazePlugin()` comme dans [notre exemple d’application][6].

## Testez votre intégration de base

À ce stade, vous pouvez vérifier que le SDK est intégré en vérifiant les statistiques de session dans le tableau de bord. Si vous exécutez votre application sur une des deux plateformes, vous devriez voir une nouvelle session dans le tableau de bord (dans la section **Overview**).

Vous pouvez ouvrir une session pour un utilisateur particulier en appelant le code suivant dans votre application.

```dart
BrazePlugin braze = BrazePlugin();
braze.changeUser("{some-user-id}");
```

Recherchez ensuite l’utilisateur avec `{some-user-id}` dans le tableau de bord sous **User Search**. Vous pouvez y vérifier que les données de session et d’appareil ont été enregistrées.

[1]: https://pub.dev/packages/braze_plugin
[2]: https://flutter.dev/
[3]: {{site.baseurl}}/api/api_key/#the-app-identifier-api-key
[4]: {{site.baseurl}}/api/basics/#endpoints
[5]: https://docs.flutter.dev/get-started/install
[6]: https://github.com/braze-inc/braze-flutter-sdk/blob/master/example/lib/main.dart
Loading