行为
配置
使用 Access Content Markup 以及显示购买列表
样式设置
本地化
分析
结合使用 AMP Access LaterPay 和 AMP Access
相关文档
验证

Important: this documentation is not applicable to your currently selected format email!

amp-access-laterpay

Description

可让发布商轻松集成 LaterPay 微支付平台。

Required Scripts

<script async custom-element="amp-access-laterpay" src="https://cdn.ampproject.org/v0/amp-access-laterpay-0.2.js"></script>

<script async custom-element="amp-access-laterpay" src="https://cdn.ampproject.org/v0/amp-access-laterpay-0.1.js"></script>

可让发布商轻松集成 LaterPay 微支付平台。amp-access-laterpay 基于 AMP Access，而且必须使用该组件。

必需的脚本

请注意，您需要“amp-access-laterpay”、“amp-access”和“amp-analytics”的脚本。

<script async custom-element="amp-access" src="https://cdn.ampproject.org/v0/amp-access-0.1.js">

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js">

<script async custom-element="amp-access-laterpay" src="https://cdn.ampproject.org/v0/amp-access-laterpay-0.2.js">

示例请参阅 AMP By Example 的 amp-access-laterpay 示例（带注释）。

行为

LaterPay 是一个微支付平台，用户只需点击两次即可购买任何在线内容，并立即获得访问权限，无需预先注册，也无需提供个人数据或付款。仅当用户在各网站的购物总额达到 5 美元或 5 欧元时，他们才需要付款。内容提供商可以销售单项商品或限时访问权限，以便用户按固定费率或按规定的时间访问内容。

如果您要通过 Connector Script 集成来集成 LaterPay，将无法在 AMP 网页上使用该集成。amp-access-laterpay 与 Connector Script 类似，可提供一组类似的功能，但只适用于 AMP 网页。

您也可以通过 LaterPay 销售内容，只需使用 amp-access-laterpay 作为唯一集成方法即可。

amp-access-laterpay 组件在内部使用 AMP Access 来提供与 AMP Access 类似的行为，但它进行了量身定制，可与 LaterPay 服务搭配使用。

如果您有自己的付费墙服务，并希望将其与 AMP Access 搭配使用，而且希望在同一网页上将其与 LaterPay 一起使用，那么也可以这样做。

amp-access-laterpay 组件不需要授权或 pingback 配置，因为它已预先配置为与 LaterPay 服务一起使用。该组件也不需要手动设置登录链接。

您可以在发布商的 LaterPay 帐号中配置不同的购买选项，该组件将检索相应配置并创建可用购买选项的列表。

您可以参阅有关如何配置 LaterPay Connector（LaterPay 的现有前端集成）的文档，了解如何配置购买选项。

可以根据发布商的偏好对生成的列表进行样式设置以及呈现该列表。

该组件还依赖于 Access Content Markup 来显示和隐藏内容。

配置

配置与 AMP Access 类似，但不需要授权、pingback 和登录链接。

<script id="amp-access" type="application/json">
  {
    "vendor": "laterpay",
    "laterpay": {
      "property": value
      }
    }
</script>

您可以在 laterpay 配置对象中设置以下值：

属性	值	说明
`articleTitleSelector`	CSS 选择器（必需）	一种 CSS 选择器，用于确定网页中包含文章标题的元素。这将确保在购买文章时呈现的网页包含此标题，以便用户了解他们购买的内容。
`articleId`	以英文逗号分隔的标识符列表	默认情况下，系统会使用文章的网址将文章与购买选项进行匹配，但您可以在 LaterPay Connector 界面中设置文章 ID，然后使用 `articleId` 属性将文章与购买选项相匹配，而不是指定购买选项的网址路径。如果不能足够灵活地按照文章的网址来匹配购买选项，则有必要使用此属性。请参阅 LaterPay Connector() 的配置页面，了解展示了此属性的实用性的一些示例场景。
`jwt`	用于动态付款配置的 JWT 令牌	通过此选项，您可以借助配置为可用付费内容指定已签名的 JSON 网络令牌。这意味着，您可以提供一种在网页中以编程方式生成的页内配置，而不是在 LaterPay 的 Connector 管理界面上手动指定配置。在为很多不同的文章配置“单次购买”时，这可能会特别有用。如果您想详细了解如何创建此令牌以及可以在其中指定哪些内容，请参阅 LaterPay 的 JWT Paid Content API 文档中有关 Connector Script 集成的内容。
`locale`	字符串	指定适合相应语言区域的价格格式样式。
`localeMessages`	对象	允许发布商对生成的购买选项列表中的文字进行自定义或本地化。如需了解详情，请参阅本地化部分。
`scrollToTopAfterAuth`	布尔值	如果值为 true，则在授权流程成功后将网页滚动到顶部。如果对话框的显示位置位于网页上很靠下的地方，用户在返回该网页后可能对当前滚动位置感到困惑，那么此属性将非常有用。
`region`	字符串	指定您是位于 `eu` 还是 `us` LaterPay 区域。
`sandbox`	布尔值	仅在使用沙盒模式测试服务器配置时才需要此属性。此外，您还需要使用 AMP 的开发模式。

使用 Access Content Markup 以及显示购买列表

Access Content Markup 的使用方式应与 AMP Access 的使用方式相同。

当用户无权查看相应文章时，ID 为 amp-access-laterpay-dialog 的元素将呈现购买选项列表。该列表具有一些非常基本的样式，您可以对该列表进行自定义，使其显示在发布商的网页中时看起来更加和谐。

如果您要使用默认样式，请务必添加 amp-access-laterpay 类。

<section amp-access="NOT error AND NOT access" amp-access-hide="">
  <div id="amp-access-laterpay-dialog" class="amp-access-laterpay"></div>
</section>

<section class="error-section" amp-access="error" amp-access-hide="">
  Oops... Something broke.
</section>

<div amp-access="access" amp-access-hide="">
  <p>...article content...</p>
</div>

样式设置

系统会对生成的标记中的一些元素应用多个类。可以通过 CSS 元素选择器明确引用未应用类的元素。

已存在一些基本布局 CSS，但建议发布商根据自己网页的外观和风格来设置其样式。

为对话框创建的结构如下所示：

<div id="amp-access-laterpay-dialog" class="amp-access-laterpay">
  <div class="amp-access-laterpay-container">
    <p class="amp-access-laterpay-header">
      Optional, appears if header locale message is defined.
    </p>
    <ul>
      <li>
        <label>
          <input name="purchaseOption" type="radio">
            <div class="amp-access-laterpay-metadata">
              <span class="amp-access-laterpay-title">Purchase option title</span>
              <p class="amp-access-laterpay-description">Purchase option description</p>
            </div>
          </label>
          <p class="amp-access-laterpay-price-container">
            <span class="amp-access-laterpay-price">0.15</span>
            <sup class="amp-access-laterpay-currency">USD</sup>
          </p>
        </li>
        <!-- ... 其他购买选项对应的更多列表项 ... -->
      </ul>
      <button class="amp-access-laterpay-purchase-button">Buy Now</button>
      <p class="amp-access-laterpay-already-purchased-container">
        <a href="…">I already bought this</a>
      </p>
      <p class="amp-access-laterpay-footer">
        Optional, appears if footer locale message is defined.
      </p>
    </div>
    <p class="amp-access-laterpay-badge">Powered by <a href="https://laterpay.net" target="_blank">LaterPay</a></p>
  </div>

本地化

对话框中针对购买选项显示的文字将由发布商在 LaterPay Connector 界面中指定。

其余文字是扩展组件的一部分，可以通过如下配置选项进行更改和本地化：

<script id="amp-access" type="application/json">
  {
    "vendor": "laterpay",
    "laterpay": {
      "localeMessages": {
        "messageKey": "message value"
        }
      }
    }
</script>

以下消息键可以进行转换或自定义，但请注意，这些键应保留其原有含义和意图。

键	说明	默认值
`payLaterButton`	购买按钮中显示的文字，表示可以稍后付款的选项。	“Buy Now, Pay Later”
`payNowButton`	购买按钮中显示的文字，表示必须在购买时付款的选项。	“Buy Now”
`defaultButton`	在选择任何选项之前，购买按钮中显示的默认文字。	“Buy Now”
`alreadyPurchasedLink`	如果用户曾经购买过相应文章，但丢失了 Cookie（或者是使用其他设备购买的），则可以使用该链接登录到 LaterPay 并检索其购买交易。	“I already bought this”
`header`	标题文字（可选）。
`footer`	页脚文字（可选）。

分析

由于 amp-access-laterpay 基于 amp-access，因此它支持 amp-access 发送的所有分析事件。

如果您想通过更完整的示例来了解这在实践中会是什么样子，请参阅 https://ampexample.laterpay.net/ 中的示例，它们均配置为发送这些分析事件。

结合使用 AMP Access LaterPay 和 AMP Access

如果您已有订阅系统，且打算仅将 LaterPay 用于单个文章销售，则可以在同一网页中同时使用两种销售方法，即同时使用 AMP Access 和 AMP Access LaterPay。

首先，请参阅 AMP Access 文档，了解如何使用现有的付费墙配置 AMP Access。

多个提供商部分介绍了如何使用命名空间设置多个提供商。

将该组件与 LaterPay 和现有的付费墙集成结合使用时，必要的配置大致如下所示：

<script id="amp-access" type="application/json">
  [
    {
      "vendor": "laterpay",
      "laterpay": {
        "region": "us"
      },
      "namespace": "laterpay"
    },
    {
      "authorization":
          "https://pub.com/amp-access?rid=READER_ID&url=SOURCE_URL",
      "pingback":
          "https://pub.com/amp-ping?rid=READER_ID&url=SOURCE_URL",
      "login":
          "https://pub.com/amp-login?rid=READER_ID&url=SOURCE_URL",
      "authorizationFallbackResponse": {"error": true},
      "namespace": "publishername"
    }
  ]
</script>

内容访问标记最终可能如下所示：

<section amp-access="NOT error AND NOT laterpay.access AND NOT publishername.access" amp-access-hide>
  <p>
    <a on="tap:amp-access.login-publishername">Login here to access your PublisherName subscription.</a>
  </p>

  <div id="amp-access-laterpay-dialog" class="amp-access-laterpay"></div>
</section>

<section class="error-section" amp-access="error" amp-access-hide>
  Oops... Something broke.
</section>

<div amp-access="laterpay.access OR publishername.access" amp-access-hide>
  <p>...article content...</p>
</div>

如需查看更完整的示例，请访问 https://ampexample.laterpay.net/dual-amp-access.html

验证

请参阅 AMP 验证工具规范中的 amp-access-laterpay 规则。

需要更多帮助？

您已多次阅读本文档，但它仍未能涵盖您的所有问题？也许其他人也这么觉得：在 Stack Overflow 上与他们联系。

前往 Stack Overflow

发现错误或缺少功能？

AMP 项目强烈鼓励您参与并做出贡献！我们希望您能成为我们开放源代码社区的持续参与者，但我们也欢迎您对所热衷问题做出一次性贡献。

前往 GitHub

amp-access-laterpay 0.2 0.1