Flutter忠诚度管理插件notificare_loyalty的使用

Notificare Flutter SDK

Notificare Flutter SDK 可以让您快速且轻松地与许多 Notificare API 服务进行高效通信，并使您可以无缝集成各种功能，从推送通知到情境化存储。

通过我们的 📚 集成指南 和 示例项目 开始使用。

目录

• 功能
• 安装
  • 需求
  • 配置
• 开始使用
• 示例

功能

• 推送通知：接收推送通知并自动跟踪其参与情况。
• 推送通知界面：使用原生屏幕和元素来显示您的推送通知并处理其操作，无需任何努力。
• 应用内消息：无需任何努力即可向用户自动显示相关应用内内容。
• 收件箱：具有内置消息收件箱的应用程序由于其保留消息的性质（可以被用户多次打开），因此享有更高的转化率。SDK 提供了构建收件箱界面所需的所有工具。
• 地理定位：将用户的地理位置转化为相关信息，根据位置行为自动化用户细分并创建真正的情境通知。
• 忠诚度：利用数字卡片的力量，这些卡片存在于应用程序之外，并始终在客户的口袋里。
• 资产：为您的应用程序添加强大的情境营销功能。在正确的时间或地点向正确的用户展示正确的内容。最大化您已经创建的内容，而不会增加开发成本。
• 可扫描项：通过扫描 NFC 标签或二维码解锁新内容，这些标签或二维码可以无缝集成到您的移动应用程序中。

安装

需求

• Android 6（API 级别 23）及以上版本
• iOS 11 及以上版本

配置

在您的 pubspec.yaml 文件中添加 Flutter 包，并遵循开始使用指南。

dependencies:
  # 必需的包
  notificare: ^4.0.0

  # 可选模块
  notificare_assets: ^4.0.0
  notificare_geo: ^4.0.0
  notificare_inbox: ^4.0.0
  notificare_loyalty: ^4.0.0
  notificare_push: ^4.0.0
  notificare_push_ui: ^4.0.0
  notificare_scannables: ^4.0.0

开始使用

集成

通过我们的 📚 集成指南 和 示例项目 开始使用。

示例

• 示例项目 以简化的方式演示其他集成，以便快速了解如何实现给定的功能。

示例代码

以下是一个完整的示例，展示了如何在 Flutter 应用程序中使用 notificare_loyalty 插件。

添加依赖

首先，在 pubspec.yaml 文件中添加 notificare_loyalty 依赖：

dependencies:
  notificare_loyalty: ^4.0.0

初始化

在 main.dart 文件中初始化 notificare_loyalty 插件：

import 'package:flutter/material.dart';
import 'package:notificare/notificare.dart';
import 'package:notificare_loyalty/notificare_loyalty.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    initNotificareLoyalty();
  }

  Future<void> initNotificareLoyalty() async {
    try {
      await Notificare.init();
      await NotificareLoyalty.init();

      // 注册监听器
      NotificareLoyalty.onCardAdded.listen((event) {
        print('Card added: ${event.card}');
      });

      NotificareLoyalty.onCardRemoved.listen((event) {
        print('Card removed: ${event.card}');
      });

      NotificareLoyalty.onCardUpdated.listen((event) {
        print('Card updated: ${event.card}');
      });
    } catch (e) {
      print('Failed to initialize Notificare Loyalty: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Notificare Loyalty Example'),
        ),
        body: Center(
          child: Text('Notificare Loyalty is initialized!'),
        ),
      ),
    );
  }
}

添加卡片

要添加卡片，您可以调用 NotificareLoyalty.addCard() 方法：

Future<void> addCard() async {
  try {
    final card = await NotificareLoyalty.addCard('cardId', 'cardTitle', 'cardDescription', 'cardImageURL');
    print('Card added: $card');
  } catch (e) {
    print('Failed to add card: $e');
  }
}

删除卡片

要删除卡片，您可以调用 NotificareLoyalty.removeCard() 方法：

Future<void> removeCard(String cardId) async {
  try {
    await NotificareLoyalty.removeCard(cardId);
    print('Card removed: $cardId');
  } catch (e) {
    print('Failed to remove card: $e');
  }
}

更新卡片

要更新卡片，您可以调用 NotificareLoyalty.updateCard() 方法：

Future<void> updateCard(String cardId) async {
  try {
    final card = await NotificareLoyalty.getCard(cardId);
    card.title = 'New Card Title';
    card.description = 'New Card Description';
    
    await NotificareLoyalty.updateCard(card);
    print('Card updated: $card');
  } catch (e) {
    print('Failed to update card: $e');
  }
}

获取卡片

要获取卡片信息，您可以调用 NotificareLoyalty.getCard() 方法：

Future<void> getCard(String cardId) async {
  try {
    final card = await NotificareLoyalty.getCard(cardId);
    print('Card retrieved: $card');
  } catch (e) {
    print('Failed to retrieve card: $e');
  }
}