概述

支付宝营销服务包括灯火推广、商家券等功能，用于支付宝小程序的营销推广。本文档详细介绍营销服务的架构、流程和开发细节。

架构设计

核心组件

营销服务模块
├── AliLightPromotionService (灯火推广平台)
│   ├── getTemplateInfo()          # 转化数据模板生成
│   ├── convertDataSendBack()      # 转化数据回传API
│   ├── createAppQRCode()          # 小程序推广二维码生成
│   └── buildBizNo()               # 生成32位转化流水号
│
├── MerchantCouponsServices (商家券服务)
│   └── createOrdervoucher()       # 商家券创建（未完成）
│
└── AlipayMarketServices (营销服务)
    └── （空壳，未实现）

代码来源：app/services/alipay/AliLightPromotionService.phpapp/services/alipay/MerchantCouponsServices.phpapp/services/alipay/AlipayMarketServices.php

灯火推广

功能说明

灯火推广是支付宝的广告推广平台，支持转化数据回传、广告归因等功能。

核心方法

转化数据模板生成

// 灯火推广转化数据模板生成
$promotionServices = app()->make(AliLightPromotionService::class);
$result = $promotionServices->getTemplateInfo();

返回值：

• 成功：返回转化数据模板
• 失败：抛出异常

代码来源：app/services/alipay/AliLightPromotionService.php:327

转化数据回传

// 转化数据回传API（广告归因）
$result = $promotionServices->convertDataSendBack($data);

参数说明：

• $data — 转化数据

返回值：

• 成功：返回回传结果
• 失败：抛出异常

代码来源：app/services/alipay/AliLightPromotionService.php:547

小程序推广二维码生成

// 小程序推广二维码生成（V2版）
$result = $promotionServices->createAppQRCode($params);

参数说明：

• $params — 二维码参数

返回值：

• 成功：返回二维码URL
• 失败：抛出异常

代码来源：app/services/alipay/AliLightPromotionService.php:659

生成转化流水号

// 生成32位转化流水号
$bizNo = $promotionServices->buildBizNo();

返回值：

• 32位转化流水号

代码来源：app/services/alipay/AliLightPromotionService.php:761

商家券服务

功能说明

商家券服务用于创建和管理支付宝商家券。

核心方法

商家券创建

// 商家券创建
$couponServices = app()->make(MerchantCouponsServices::class);
$result = $couponServices->createOrdervoucher($params);

参数说明：

• $params — 券参数

返回值：

• 成功：返回创建结果
• 失败：抛出异常

注意： 当前该方法为空实现，需要根据业务需求完善。

代码来源：app/services/alipay/MerchantCouponsServices.php:81

小程序推广

推广二维码生成

通过 AlipayServices::getQrcodeUrl() 生成小程序推广二维码：

// 小程序推广二维码生成
$alipayServices = app()->make(AlipayServices::class);
$result = $alipayServices->getQrcodeUrl($params);

代码来源：app/services/alipay/AlipayServices.php:2006

配置项

配置项	说明	代码位置
alipay_app_id	支付宝应用ID	AlipayServices.php
alipay_private_key	应用私钥	AlipayServices.php
alipay_public_key	支付宝公钥	AlipayServices.php

常见问题

Q: 灯火推广数据回传失败怎么办？

A: 检查以下条件：

1. 转化数据格式是否正确
2. 转化流水号是否唯一
3. 支付宝接口是否正常
4. 应用权限是否开通

Q: 商家券创建失败怎么办？

A: 当前商家券服务为空实现，需要根据业务需求完善 createOrdervoucher() 方法。

Q: 推广二维码生成失败怎么办？

A: 检查以下条件：

1. 二维码参数是否正确
2. 小程序是否已授权
3. 支付宝接口是否正常