什么是 Shopify Customer Privacy API?

Shopify 的 Customer Privacy API 是应用开发者和店铺所有者遵守全球数据隐私法律(如 GDPR、CCPA 及其他地区性法规)的重要工具。该 API 提供了结构化的方法来收集、存储和管理客户关于其个人数据使用的同意,确保您的店铺或应用具有透明性和安全性。

工作原理

Consent Management Platform (CMP) 使用 Customer Privacy API 来跟踪用户授予或撤回同意的时间和方式。然后,这些同意数据会提供给应用和自定义代码,使它们能够实时调整行为——例如,当用户拒绝同意时禁用跟踪。

使用示例

以下 JavaScript 代码片段展示了如何加载 Customer Privacy API 并获取当前访问者的同意状态:

window.Shopify.loadFeatures(
  [
    {
      name: 'consent-tracking-api',
      version: '0.1',
    },
  ],
  (error) => {
    if (error) {
      // Handle loading error
      return;
    }

    // API is ready—check visitor consent
    const consent = window.Shopify.customerPrivacy.currentVisitorConsent();
    console.log(consent); // Outputs consent categories and their status
  }
);

同意类别

该 API 返回以下类别的同意状态:

  • analytics
  • marketing
  • preferences
  • sale_of_data

每个类别将返回 'yes''no',使您可以根据用户的偏好有条件地加载或阻止第三方脚本。

essential(必要类别)始终由 Shopify 启用,无法切换。