[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform es compatible con la ingesta de datos desde aplicaciones de flujo continuo. Los proveedores de streaming admiten Shopify.

Requisitos previos prerequisites

En la siguiente sección se describen los pasos necesarios que deben seguirse antes de utilizar Shopify Streaming origen.

Debe tener un válido Shopify cuenta de socio para conectarse a Shopify API. Si todavía no tiene una cuenta de socio, regístrese en Shopify panel de socios.

Cree su aplicación

Con un válido Shopify cuenta de socio, ahora puede continuar y crear la aplicación mediante el panel socios. Para ver los pasos detallados sobre cómo crear la aplicación en Shopify, lea la Shopify guía de introducción.

Una vez creada la aplicación, recupere el ID de cliente y secreto de cliente desde el credenciales de cliente de la pestaña Shopify panel de socios. El ID de cliente y el secreto de cliente se utilizarán en los siguientes pasos para recuperar el código de autorización y el token de acceso.

Recupere el código de autorización

A continuación, recupere el código de autorización introduciendo el de su dominio myshopify.com Dirección URL en el explorador, junto con cadenas de consulta que definen la clave de API, los ámbitos y el URI de redirección.

El formato de esta URL es el siguiente:

Formato de API

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

Solicitud

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

Respuesta

Una respuesta correcta devuelve la dirección URL de redireccionamiento, incluido el código de autorización necesario para generar el token de acceso.

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

Recuperación del token de acceso

Ahora que tiene su ID de cliente, secreto de cliente y código de autorización, puede recuperar su token de acceso. Para recuperar el token de acceso, realice una solicitud de POST al myshopify.com URL al anexar esta URL con Shopify’s Extremo de API: /admin/oauth/access_token.

Formato de API

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

Solicitud

La siguiente solicitud genera un token de acceso para su Shopify ejemplo.

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"
}'

Respuesta

Una respuesta correcta devuelve el token de acceso y los ámbitos de permisos.

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

Crear un webhook para streaming Shopify datos webhook

Los webhooks permiten que las aplicaciones permanezcan sincronizadas con su Shopify datos o realizar una acción después de que un evento en particular se produzca en una tienda. Para streaming Shopify datos para el Experience Platform, se pueden utilizar webhooks para definir el extremo http y los temas para la suscripción.

Solicitud

La siguiente solicitud crea un webhook para su Shopify Streaming datos.

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"
  }
}'

Respuesta

Una respuesta correcta devuelve información sobre el gancho web, incluido su correspondiente id, dirección y otra información de metadatos.

{
  "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": []
  }
}

Limitaciones limitations

A continuación se muestra una lista de limitaciones conocidas que pueden surgir al utilizar los webhooks con Shopify Streaming origen.

Pasos siguientes

Los siguientes tutoriales proporcionan pasos sobre cómo conectar su Shopify Streaming origen al Experience Platform mediante la API y la IU: