立即购买 API 指南

立即购买 API 指南

以下指南旨在帮助开发人员了解 omacro Buy Now 服务如何工作以开发自定义前端解决方案。如果您不熟悉此类开发，强烈建议您使用 omacro 的预建解决方案。要了解有关“立即购买”的更多信息，请查看我们的“供应商立即购买实施指南” 。

先决条件

配置网络以支持立即购买

可能有必要确保您的网络防火墙配置正确，可以与网络外部的 omacro 网络服务进行通信。详细了解面向网络专业人员的立即购买服务信息。

概述

可以调用“立即购买”服务端点以请求基本客户信息、“立即购买”配置数据以及经销商和产品信息。本指南将概述这些端点及其功能。

omacro 服务基础端点地址

  1. https://services-v2.omacro.com/buynow/

端点中使用的可变术语

请注意，为了调用大多数“立即购买”端点，您可能需要提供以下关键参数：
  • companyId - 从 omacro 分配给贵公司的内部全球唯一标识符（又名“omacro ID”或公司 GUID）。 companyId参数可以在“立即购买”-> “站点代码”页面上找到，也可以通过单击 omacro 导航菜单左上角的公司名称找到。 companyId 将出现在 URL 参数“id”中。
  • productId - 从 omacro 分配给您的产品的内部全球唯一标识符（又名产品 GUID）。此时，可以在 omacro产品 ->管理产品页面中找到 productId 参数，方法是单击产品型号并启动“实时”视图页面。 productid 将作为参数“p”出现在 URL 中。

端点

数据检索
  • 地理定位
  • 公司/ {companyId:guid}
  • 公司/ {companyId:guid} /retailers/online
  • 公司/ {companyId:guid} /retailers/local
  • 公司/ {companyId:guid} /验证
  • 公司/ {companyId:guid} /产品
  • 公司/ {companyId:guid} /products/ {productId:guid} /retailers/online
  • 公司/ {companyId:guid} /products/ {productId:guid} /retailers/local
分析跟踪
  • 经销商交易
  • 产品交易
  • 产品交易简单
  • 经销商交易简单

以下是完全限定端点地址的示例：






    • Related Articles

    • 供应商立即购买实施指南

      以下文章讨论了将“立即购买”作为弹出窗口或作为基于产品的经销商定位器或一般经销商定位器嵌入页面中的各种方式。 Buy Now 可以配置为向特定市场（在线或本地）开放，以显示一个或多个特定经销商类型（租赁提供商、零售商或服务中心）并以多种方式显示，包括与您的品牌相匹配的样式。 先决条件 配置网络以支持立即购买 由于 Buy Now 在您的网站和网络上运行，因此可能有必要确保您的网络防火墙配置为允许 omacro Buy Now 脚本与网络外部的 omacro Web ...

    • 批量管理供应商立即购买链接

      介绍 轻松有效地批量管理您的供应商“立即购买”链接，并使用“立即购买链接”数据网格更好地可视化您的公司可以使用哪些产品。 查看哪些产品可用以及来自哪些供应商： 查看您尚未建立产品链接的潜在产品，以及您应该使用哪些确切的产品标识符来匹配（型号 + SKU 或 GTIN）。我们建议使用产品的 GTIN（如果有）。 查看您已添加到系统中的链接、URL、价格、库存状态和国家/地区的设置，以及链接上次更新的时间。 使用适当的数据网格控件在适当的情况下手动添加、编辑或删除链接。 ...

    • 在“立即购买”弹出窗口中调整地图搜索半径

      由于“立即购买”弹出窗口中的默认搜索半径而难以看到结果？默认情况下，初始地图半径为50 英里（80 公里），后备半径为150 英里（241 公里），可为大多数客户生成结果。 如果默认的半径集不够，例如，如果您使用“立即购买”弹出窗口来严格显示服务中心或租赁提供商，这些位置可能很少而且相距很远，或者如果卖家远离地区中心或热门城市，可能需要增加“立即购买”弹出窗口的主要或次要搜索半径。 要调整主要或次要搜索的半径，请执行以下操作： 从 omacro ...

    • 立即购买面向网络专业人员的服务信息

      Buy Now 弹出式客户端脚本与许多 omacro Web 服务端点结合使用以提供其内容。要成功运行该服务，请务必确保“立即购买”脚本可以与其 Web 服务正确通信。 如果您使用防火墙或其他边缘设备来控制来自您的托管环境和网络服务器的流量，为避免服务中断，请确保正确访问 omacro 服务。在您的托管环境中保护和允许 omacro 服务功能时，以下信息可能对 IT 专业人员有用： omacro Web 服务 IP 地址： 104.42.4.243 omacro 服务基础端点地址： ...

    • 通过电子邮件或外部链接直接触发立即购买经销商定位器

      omacro 的“立即购买”小部件允许您在网站页面加载时触发它自动加载/打开。这将很有帮助，例如，如果您想开展电子邮件活动并包含一个按钮/链接供客户“立即购买”。向电子邮件中的链接添加参数将直接从电子邮件触发您的“立即购买”结果。另一个例子是在 YouTube 视频或您希望将客户直接从另一个目的地发送到您的产品或一般经销商定位器的任何其他位置中放置链接。 简单地使用： 决定应在页面加载时触发哪个“立即购买”按钮。 使用所需按钮的相同产品标识符替换步骤 3 中的 {PRODUCT}。 添加 ...