Flutter Adobe Visitor ID管理插件tealium_adobevisitor的使用

文档

完整的文档请参阅Tealium学习社区：

Tealium for Flutter

许可证

使用本软件受“LICENSE.txt”文件中包含的许可协议条款和条件约束。在下载或使用此存储库中的任何文件之前，请务必阅读许可协议。通过下载或使用这些文件，即表示您同意受该许可协议的约束并遵守其条款。

版权 (C) 2012-2022, Tealium Inc.

示例代码

以下是使用tealium_adobevisitor插件的完整示例代码：

example/lib/main.dart

import 'package:flutter/material.dart';
import 'dart:convert';
import 'dart:developer' as developer;

import 'package:tealium_adobevisitor/tealium_adobevisitor.dart';

import 'tealium_button.dart';
import 'package:tealium_adobevisitor/common.dart';
import 'package:tealium/common.dart';
import 'package:tealium/tealium.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _adobeOrgIdController = TextEditingController();
  var _adobeOrgSet = false;
  AdobeVisitor? _adobeVisitor;

  final _knownIdController = TextEditingController();
  final _dataProviderIdController = TextEditingController();
  var _linkEcidReady = false;
  final _authStateOptions = [
    const DropdownMenuItem<int>(
      value: -1,
      child: Text("Not Set"),
    )
  ] +
      AuthState.values.map<DropdownMenuItem<int>>((AuthState authState) {
        return DropdownMenuItem<int>(
          value: authState.intValue,
          child: Text(authState.name),
        );
      }).toList();
  int? _authStateSelection;

  final _urlController = TextEditingController(text: "https://mysite.com/");
  var _decoratedUrl = "";
  var _urlParameters = "";

  [@override](/user/override)
  void initState() {
    super.initState();

    _knownIdController.addListener(_validateLinkSettings);
    _dataProviderIdController.addListener(_validateLinkSettings);
  }

  void initializeTealium(String adobeOrgId) {
    if (adobeOrgId == "") return;

    TealiumAdobeVisitor.configure(AdobeVisitorConfig(adobeOrgId));
    var config = TealiumConfig(
      'tealiummobile',
      'demo',
      TealiumEnvironment.dev,
      [Collectors.AppData],
      [Dispatchers.Collect],
      batchingEnabled: false,
    );

    Tealium.initialize(config).then((value) => {
          developer.log('Tealium Initialized'),
          setState(() {
            _adobeOrgSet = true;
          }),
          _fetchAdobeVisitor()
        });
  }

  Padding _listView() {
    return Padding(
        padding: const EdgeInsets.all(10),
        child: ListView(
          scrollDirection: Axis.vertical,
          children: <Widget>[
            const Padding(padding: EdgeInsets.all(8)),
            TextField(
              controller: _adobeOrgIdController,
              autocorrect: true,
              decoration:
                  const InputDecoration(hintText: 'Enter a valid AdobeOrgId'),
            ),
            TealiumButton(
                title: 'Initialize Tealium',
                onPressed: () => initializeTealium(_adobeOrgIdController.text)),
            TealiumButton(
                disabled: !_adobeOrgSet,
                title: 'Get Adobe Visitor',
                onPressed: () => _fetchAdobeVisitor()),
            TealiumButton(
                disabled: !_adobeOrgSet,
                title: 'Reset Visitor',
                onPressed: () => _resetVisitor()),
            const Padding(padding: EdgeInsets.all(8)),
            TextField(
              enabled: _adobeOrgSet,
              controller: _urlController,
              autocorrect: true,
              decoration:
                  const InputDecoration(hintText: 'Enter a url to decorate.'),
            ),
            TealiumButton(
                disabled: !_adobeOrgSet,
                title: 'Decorate Url',
                onPressed: () =>
                    TealiumAdobeVisitor.decorateUrl(_urlController.text).then(
                        (value) => setState(() => _decoratedUrl = value as String))),
            Visibility(
                visible: _decoratedUrl.isNotEmpty, child: Text(_decoratedUrl)),
            TealiumButton(
                disabled: !_adobeOrgSet,
                title: 'Get URL Parameters',
                onPressed: () =>
                    TealiumAdobeVisitor.getUrlParameters().then(
                            (value) => setState(() => _urlParameters = value?["adobe_mc"] as String)).catchError(
                        (error) =>
                          setState(() => _urlParameters = "Adobe Visitor could not be retrieved. Check Org ID."
                    ))),
            Visibility(
                visible: _urlParameters.isNotEmpty, child: Text(_urlParameters)),
            const Padding(padding: EdgeInsets.all(8)),
            TextField(
              enabled: _adobeOrgSet,
              controller: _knownIdController,
              autocorrect: true,
              decoration:
                  const InputDecoration(hintText: 'Enter a known Id to link.'),
            ),
            TextField(
              enabled: _adobeOrgSet,
              controller: _dataProviderIdController,
              autocorrect: true,
              decoration:
                  const InputDecoration(hintText: 'Enter the dataProviderId.'),
            ),
            const Padding(padding: EdgeInsets.all(8)),
            DropdownButton<int>(
              value: _authStateSelection,
              hint: const Text("(Optional) Select an AuthState."),
              elevation: 16,
              onChanged: (int? value) {
                setState(() {
                  _authStateSelection = value!;
                });
              },
              items: _authStateOptions,
            ),
            TealiumButton(
                disabled: !_linkEcidReady,
                title: 'Link known Id',
                onPressed: () =>
                    TealiumAdobeVisitor.linkEcidToKnownIdentifier(
                        _knownIdController.text,
                        _dataProviderIdController.text,
                        _getSelectedAuthState())
                    .then((visitor) => _setAdobeVisitor(visitor))),
            const Padding(padding: EdgeInsets.all(8)),
            const Padding(
              padding: EdgeInsets.all(4),
              child: Text("Visitor:",
                  style: TextStyle(fontWeight: FontWeight.bold, fontSize: 20)),
            ),
            Text(_adobeVisitor != null
                ? const JsonEncoder.withIndent("    ").convert(_adobeVisitor)
                : "No visitor retrieved yet.")
          ],
        ));
  }

  AuthState? _getSelectedAuthState() {
    var authState = _authStateSelection;

    if (authState == null) {
      return null;
    } else {
      return AuthState.fromIntValue(authState);
    }
  }

  void _fetchAdobeVisitor() {
    TealiumAdobeVisitor.getAdobeVisitor()
        .then((visitor) => {_log(visitor), _setAdobeVisitor(visitor)});
  }

  void _resetVisitor() {
    TealiumAdobeVisitor.resetVisitor();
    _fetchAdobeVisitor();
  }

  void _setAdobeVisitor(AdobeVisitor? adobeVisitor) {
    setState(() {
      _adobeVisitor = adobeVisitor;
    });
  }

  void _validateLinkSettings() {
    setState(() {
      _linkEcidReady =
          _knownIdController.text != "" && _dataProviderIdController.text != "";
    });
  }

  void _log(dynamic payload) {
    developer.log(const JsonEncoder().convert(payload));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: _listView(),
      ),
    );
  }
}