[Beta 版]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform支持从流应用程序中摄取数据。 对流式提供程序的支持包括Shopify。

先决条件 prerequisites

以下部分概述了在使用Shopify Streaming源之前要完成的先决步骤。

您必须拥有有效的Shopify合作伙伴帐户才能连接到Shopify API。 如果您还没有合作伙伴帐户，请使用Shopify 合作伙伴信息板进行注册。

创建应用程序

现在，使用有效的Shopify合作伙伴帐户，您可以使用合作伙伴仪表板继续创建您的应用程序。 有关如何在Shopify中创建应用程序的完整步骤，请阅读Shopify 入门指南。

创建应用程序后，请从Shopify合作伙伴仪表板的​ 客户端凭据 ​选项卡中检索您的​ 客户端ID ​和​ 客户端密钥。 客户端ID和客户端密钥将在后续步骤中使用，以检索您的授权代码和访问令牌。

检索授权码

接下来，通过在浏览器中输入域的myshopify.com URL以及定义API密钥、范围和重定向URI的查询字符串，检索您的授权代码。

此URL的格式如下：

API格式

https://{SHOP}.myshopify.com/admin/oauth/authorize?client_id={API_KEY}&scope={SCOPES}&redirect_uri={REDIRECT_URI}

请求

https://connnectors-test.myshopify.com/admin/oauth/authorize?client_id=l6fiviermmzpram5i1spfub99shms3j9&scope=write_orders,read_customers&redirect_uri=https://acme.com

响应

成功的响应将返回您的重定向URL，包括生成访问令牌所需的授权代码。

https://www.acme.com/?code=k6j2palgrbljja228ou8c20fmn7w41gz&hmac=68c9163f772eecbc8848c90f695bca0460899c125af897a6d2b0ebbd59d3a43b&shop=connnectors-test.myshopify.com&state=123456×tamp=1658305460

检索您的访问令牌

现在，您已拥有客户端ID、客户端密钥和授权码，您可以检索访问令牌了。 要检索您的访问令牌，请在使用Shopify’s API终结点追加此URL时向域的myshopify.com URL发出POST请求： /admin/oauth/access_token。

API格式

POST /{SHOP}.myshopify.com/admin/oauth/access_token

请求

以下请求为您的Shopify实例生成访问令牌。

curl -X POST \
  'https://connnectors-test.myshopify.com/admin/oauth/access_token' \
  -H 'developer-token: {DEVELOPER_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'Cookie: _master_udr=xxx; request_method=POST'
  -d '{
    "client_id": "l6fiviermmzpram5i1spfub99shms3j9",
    "client_secret": "dajn3caxz9s7ti624ncyv_m4f60jnwi3ii3y3k",
    "code": "k6j2palgrbljja228ou8c20fmn7w41gz"
}'

响应

成功的响应将返回您的访问令牌和权限范围。

{
  "access_token": "shpca_wjhifwfc91psjtldysxd6rqli371tx54",
  "scope": "write_orders,read_customers"
}

创建用于流式传输Shopify数据的webhook webhook

Webhook允许应用程序与您的Shopify数据保持同步，或在商店中发生特定事件后执行操作。 对于流式传输Shopify数据以Experience Platform，可以使用Webhook定义http端点和订阅主题。

请求

以下请求为您的Shopify Streaming数据创建一个webhook。

curl -X POST \
  'https://connnectors-test.myshopify.com/admin/api/2022-07/webhooks.json' \
  -H 'X-Shopify-Access-Token: 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' \
  -H 'Content-Type: application/json' \; request_method=POST' \
  -d '{
  "webhook": {
    "address": "https://dcs.adobedc.net/collection/9d411a24aa3c0a3eded92bac6c64d0da986ee7a8212f87168c5fb42d9ddc3227",
    "topic": "orders/create",
    "format": "json"
  }
}'

响应

成功的响应将返回有关webhook的信息，包括其对应的id、地址和其他元数据信息。

{
  "webhook": {
    "id": 1091138715786,
    "address": "https://dcs.adobedc.net/collection/9d411a24aa3c0a3eded92bac6c64d0da986ee7a8212f87168c5fb42d9ddc3227",
    "topic": "orders/create",
    "created_at": "2022-07-20T07:15:23-04:00",
    "updated_at": "2022-07-20T07:15:23-04:00",
    "format": "json",
    "fields": [],
    "metafield_namespaces": [],
    "api_version": "2021-10",
    "private_metafield_namespaces": []
  }
}

限制 limitations

以下是将webhook与Shopify Streaming源结合使用时可能会遇到的已知限制列表。

后续步骤

以下教程提供了有关如何使用API和UI将Shopify Streaming源连接到Experience Platform的步骤：