HIKO Social Login

此商店目前未使用传统客户账户，与本应用不兼容。

非传统客户账户采用完全不同的验证机制，不允许第三方应用自定义登录体验。受此技术限制，社交登录、自定义注册字段、登录页面自定义等功能仅在传统客户账户下可用。参阅 Shopify 官方文件了解详情。

新版客户账户是用 email 收到的一次性验证码登录，并没有提供第三方应用完成登录的方式，因此无法在上面提供社交登录。从 Shopify 后台 > 设置 > 客户账户 切回去，就会恢复传统登录表单，这个应用也会立即开始作用。切换不会影响您的客户与他们的订单。

如果必须维持新版客户账户，这个应用仍然可以用在 Headless 店铺上，那里的登录步骤由您自己的代码控制。

Shopify Starter 方案没有会员（客户账户）功能，因此本应用不支持该方案。

自动安装未必适用于所有模板。此时需要在模板文件的适当位置手动插入标签：

container 上可用的可选属性：

• type：register 或 login，决定这个区块要画注册按钮还是登录按钮。
• ignore：不套用自动排版，保留您自己的样式与标记。
• register_tag：通过这个区块注册的每一位客户都会被加上这个值作为标签，用来分辨来自不同页面的注册。

应用后台 > 标志颜色 > 顺序 ，点击上下箭头

在某些模板中，登录表单过宽，导致区块内的登录按钮一起被拉宽。可用 CSS 自定义宽度，例如：

除非已启用 Shopify 的 Multipass 协议，否则客户以社交媒体账户登录时，本应用会将其密码重设为一段随机字符串。客户若要重新使用密码，可走「忘记密码」流程。本应用不会以任何形式存储、记录或显示该字符串。Multipass 协议可让客户以 multipass 密钥加密的登录令牌登录。Multipass 仅在 Shopify Plus 方案提供。

Multipass 在 高级版 > Multipass 启用，secret 取自 Shopify 后台 > 设置 > 客户账户。启用后，应用交给 Shopify 的是一个签名过的登录令牌而不是密码，客户自己的密码完全不会被动到。Multipass 只在 Shopify Plus 方案提供。

高级版 > Google One Tap。One Tap 不需要客户点击任何按钮，就会在店铺前台显示 Google 账号选择界面，因此只会出现在已经登录 Google 的访客面前。

如果您使用自己的 Google API 密钥，必须在 Google Cloud 控制台把店铺域名加入已授权的 JavaScript 来源。没有加入时，Google 会以 origin_mismatch 拒绝请求，页面上不会显示任何错误，One Tap 也完全不会出现。

可以，路径为：在线商店 > 偏好设置 > 垃圾信息防护 > 取消勾选 在登录、创建账户与密码恢复页面启用 hCaptcha

不一定要关。这个应用在提交登录表单之前会先走 Shopify 自己的 captcha 保护，所以 hCaptcha 开着社交登录也能正常运作。要不要关是登录环节摩擦力的取舍，不是这个应用的必要条件。

此应用会请求访问客户的电子邮件、名字、姓氏、电话号码与营销同意状态。

社交资料写进您自己店铺的客户 metafield，而不是我们这边的副本。我们的服务器只保留让登录运作所必需的东西：店铺设置、社交账号与 Shopify 客户之间的绑定，以及法规要求我们保留的日志。卸载会把这些全部移除。

Shopify 上的数据不会被移除。这个应用写入的社交资料存放在每位客户的 hiko.socials metafield，而这个 metafield 属于您的店铺，因此客户、订单与该 metafield 都会原样保留。

在我们这边，卸载会从服务器移除您店铺的设置与社交账号绑定，Shopify 也会在同一时间收回这个应用对店铺的访问权。只有法规要求我们保留的最小量日志会留下。

若要在社交登录的同意画面显示商店名称与标志，需要自行到该社交平台注册应用并通过审核。通过后，将 API 密钥与密文填入本应用的 专业版 > 自定义 API 密钥，验证流程由本应用处理。更多细节可参考业界标准 OAuth2。

若要启用社交登录，需要在该社交平台为商店注册一个应用，过程中需同意使用条款并申请必要权限。通过审核后，平台会提供 API 密钥与密文。客户以社交账户登录时，会被导向该平台的授权服务器进行验证与同意；授权服务器会显示商店名称、条款与所要求的权限，供客户确认。



以下是各社交平台的参考链接：

以 Apple 登录的客户可以选择隐藏电子邮件地址。选择 hide 后，Apple 会生成一个唯一的随机地址，让个人邮箱保持私密。生成地址的网域为 privaterelay.appleid.com。透过 Apple 的私密邮件转发服务，仍可与这些客户往来邮件。

支持。Amazon 分为北美（amazon.com）、欧洲（amazon.co.uk）与远东（amazon.co.jp）三个区域，各区域的客户账户彼此独立。可在 专业版 > 自定义 API 密钥 > Amazon > 为商店选择其中一个区域。

不会。Shopify 会延续首次安装的计费周期，在该周期结束前不会再向商家收费。

方案在每次打开应用时都会向 Shopify 读取您店铺目前生效的订阅，因此跟随的是 Shopify 的账务，而不是我们这边保存的副本。在 订阅 做过任何变更之后，请重新加载页面。

如果看起来仍然不对，以 Shopify 记录的生效扣款为准。把 订阅 页面截图寄给我们，我们会拿去跟 Shopify 的记录核对。

自 2021 年 9 月 30 日起，Google 不再支持在内嵌 WebView 或未知浏览器中登录。内嵌 WebView 指的是手机应用内的浏览器，例如从 Facebook 点开商店链接时，打开的是 Facebook 自带的浏览器，而不是 Chrome 或 Safari。Google 认为第三方 WebView 存在安全风险。 了解详情 。

这一点没有东西可以设置绕过，因为限制来自 Google 且对所有网站一律适用。客户需要用一般浏览器打开您的店铺，而不是用他来源那个 app 内置的浏览器，通常可以从该 app 的 在浏览器中打开 菜单进去。

如果用户以「X」按钮关闭 One Tap，同一浏览器或最后浏览的网站在一段时间内都不会再显示 One-Tap，这称为 exponential cool-down。此时清除浏览器的全部应用数据即可恢复。以 Chrome 为例： F12 > Chrome Developer Tools > Application tab > Clear storage in left tree > Select all data items > click Clear site data

除此之外，除非在 高级版 > Google One Tap 勾选 ITP 支持，One Tap 在 iOS 与 Safari 上也不会显示。要注意即使勾了，这些浏览器仍然不支持自动登录。

如果一条客户资料的电话或 email 已经属于同一家店铺的其他客户，Shopify 会拒绝，客户看到的就是这个拒绝消息。这是客户名单里的重复数据，不是社交账号的问题。

在 Shopify 后台 > 客户 找出持有该电话或 email 的另一位客户，把两条合并或清掉重复的字段。电话号码必须在整家店铺内唯一，这是最常见的原因。

这个应用以 json 类型写入 hiko.socials。如果您的店铺已经把这个 metafield 定义成其他类型，Shopify 会拒绝写入，社交资料就会被略过。登录仍然正常，账号绑定也仍然会记录下来，只有 metafield 这份副本不会被动到。

要让数据回来，请在 Shopify 后台 > 设置 > 自定义数据 > 客户 把定义改成 JSON 类型，或是把您的定义整个移除，交给应用自己建立。

社交媒体数据以 JSON 格式存放在客户 metafield 中，JSON 结构如下：

以 liquid 读取客户 metafield 中社交媒体数据的示例：

这个 metafield 的 namespace 是 hiko、key 是 socials、类型是 json。有哪些字段取决于社交平台返回了什么，所以使用前请先确认字段存在。

设置 > Headless。请求以店铺的 Hydrogen 公开访问令牌签名；React 与 Hydrogen 店铺另有现成的组件包 hiko-social-login-react。

完整的 endpoint 说明（含请求签名方式）请与支持联系获取。