README

此 TYPO3 扩展为 marketing_automation 提供适配器，允许使用个性化内容定位用户。

为此，从 Amazon S3 导出导入 Audience Studio 的用户和段，该操作可以在 Audience Studio 中进行配置。

安装

composer require leuchtfeuer/typo3-audience-studio 不要忘记在 TYPO3 扩展管理器中激活扩展。

配置

添加 控制标签 和 cookie 配置

此适配器不负责将控制标签添加到您网站的 HTML 输出中。请确保添加它并将以下 TYPO3 配置放入 AdditionalConfiguration.php 或其他适当位置。

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['audience_studio']['cookieName'] = 'yourcookiename';

验证网站域名上已设置配置中声明的 cookie。适配器依赖于此 cookie 存在并设置。

从本地存储获取 cookie 值

由于 AudienceStudio cookie 未设置在您的网站可用的域名上，因此必须从用户的本地存储中读取 cookie 值。您可以在配置中存储本地存储值的键 localStorageKey。

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['audience_studio']['localStorageKey'] = 'yourlocalstoragekey';

在这种情况下，以下 JavaScript 代码将添加到源代码中

(function() {
    if (window.localStorage) {
        const KUID = localStorage.getItem('YOUR_LOCAL_STORAGE_KEY');
        if (KUID !== null) {
            let date = new Date();
            date.setTime(date.getTime() + (30 * 24 * 60 * 60 * 1000));
            document.cookie = 'YOUR_COOKIE_NAME=' + KUID + ';expires=' + date.toUTCString() + ';path=/';
        }
    }
})();

您也可以手动添加此脚本。然后您只需保留配置为空，扩展就不会向您的页面添加 JavaScript。

S3 访问配置

将以下 TYPO3 配置放入 AdditionalConfiguration.php 或其他适当位置。

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['audience_studio']['storageConfiguration'] = [
    'key' => 'your S3 key',
    'secret' => 'your corresponding S3 secret',
    'region' => 'us-east-1', // Must be the correct region of your bucket
    'bucket' => 'your/bucket',
];

使用扩展提供的以下 CLI 命令导入用户和段

vendor/bin/typo3 audience-studio:import

建议将此命令添加为每天执行的 TYPO3 调度任务。

Persona 配置

在页面树中的任何系统文件夹中创建所需的 Persona 记录。每个 Persona 必须与一个或多个 Audience Studio 段相关联。当用户访问 Persona 记录中选择的任何段所属的网站时，将匹配 Persona。

目标内容

默认情况下，营销自动化扩展允许定位内容和页面记录。可选地可以激活其他记录进行定位。

定位基于 Personas。在内容或页面记录的访问选项卡中，选择应显示此记录的 Persona。