推送通知不再是你的推送：Apple 与 Google 如何悄悄变成品牌与用户之间的"中介"

你的业务服务器 → APNs / FCM → 用户设备 → 通知中心展示

# fcm_push_demo.py
# 运行前：pip install firebase-admin
# 需要下载 Firebase 项目的服务账号 JSON 文件

import firebase_admin
from firebase_admin import credentials, messaging

# 1. 初始化——平台已经在这里介入：你的项目必须通过 Firebase 注册
cred = credentials.Certificate("service-account-key.json")
firebase_admin.initialize_app(cred)

# 2. 构造消息——注意 notification 和 data 的区别
#    notification 字段的内容会被系统自动展示，受摘要/分组规则控制
#    data 字段由你的 App 自行处理，但不会在通知中心直接显示
message = messaging.Message(
    notification=messaging.Notification(
        title="您的订单已发货",
        body="预计周三送达，点击查看物流详情",
    ),
    data={
        # 这些数据你的 App 可以在后台读取，但用户在通知中心看不到原文
        "order_id": "ORD-20250618-001",
        "tracking_url": "https://track.example.com/ORD-20250618-001",
        "urgency": "high",  # 自定义字段，但平台不认——它有自己的优先级算法
    },
    android=messaging.AndroidConfig(
        # 3. Android 通知渠道——你必须预先在 App 中注册渠道
        #    用户可以在系统设置中关闭某个渠道，你的推送就永远送达不了
        notification_channel_id="order_updates",
        priority="high",
    ),
    apns=messaging.APNSConfig(
        payload=messaging.APNSPayload(
            aps=messaging.Aps(
                # 4. iOS threadIdentifier 决定分组，但摘要逻辑由系统 AI 控制
                thread_id="order_updates",
                # 5. 如果要突破专注模式，需要 Critical Alerts entitlement
                #    普通推送在专注模式下会被静默
                # sound="default",  # 普通声音
            ),
        ),
    ),
    token="<目标设备的 FCM 注册令牌>",
)

# 6. 发送——FCM 可能因为用户关闭权限而返回错误
#    你无法知道通知最终是否被用户看到
try:
    response = messaging.send(message)
    print(f"发送成功，消息 ID: {response}")
except messaging.UnregisteredError:
    print("设备令牌已失效——用户可能卸载了 App 或关闭了通知权限")
except messaging.SenderIdMismatchError:
    print("发送者 ID 不匹配——你的服务账号不属于目标项目")

# 直接调用 APNs（需要 .p8 token 签名，此处仅展示请求结构）
# 实际运行需要：openssl 生成 JWT，curl 支持 HTTP/2

# 生成 JWT token（简化示例，生产环境应使用库）
JWT_HEADER=$(echo -n '{"alg":"ES256","kid":"YOUR_KEY_ID"}' | base64)
JWT_CLAIM=$(echo -n '{"iss":"YOUR_TEAM_ID","iat":'$(( $(date +%s) ))'}' | base64)

# 发送推送
curl -v \
  --http2 \
  -H "authorization: bearer $JWT_HEADER.$JWT_CLAIM.$JWT_SIGNATURE" \
  -H "apns-topic: com.yourapp.bundleid" \
  -H "apns-push-type: alert" \
  -d '{"aps":{"alert":{"title":"订单已发货","body":"预计周三送达"},"thread-id":"order_updates"}}' \
  https://api.push.apple.com/3/device/<DEVICE_TOKEN>

# 改造后的推送策略：通知只做提醒，完整内容在 App 内展示

message = messaging.Message(
    notification=messaging.Notification(
        # 简短标题——即使被 AI 概括，核心信息"有新消息"仍然保留
        title="订单更新",
        body="查看详情",  # 不在通知正文放关键信息，因为可能被摘要吞掉
    ),
    data={
        # 完整内容在这里，App 打开后自行渲染
        "type": "order_shipped",
        "order_id": "ORD-20250618-001",
        "estimated_delivery": "2025-06-21",
        "tracking_url": "https://track.example.com/ORD-20250618-001",
        "full_message": "您的订单 ORD-20250618-001 已发货，预计6月21日送达。点击查看实时物流。",
    },
    android=messaging.AndroidConfig(
        notification_channel_id="order_updates",
    ),
    apns=messaging.APNSConfig(
        payload=messaging.APNSPayload(
            aps=messaging.Aps(
                thread_id="order_updates",
                mutable_content=1,  # 允许 App 修改通知内容（iOS 10+）
            ),
        ),
    ),
    token="<DEVICE_TOKEN>",
)