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

Shopify Streaming

Adobe Experience Platform prend en charge l’ingestion de données à partir d’applications de diffusion en continu. La prise en charge des fournisseurs de diffusion en continu inclut Shopify.

Conditions préalables prerequisites

La section suivante décrit les étapes préalables à suivre avant d’utiliser Shopify Streaming source.

Vous devez disposer d’un Shopify compte du partenaire afin de se connecter à la variable Shopify API. Si vous ne disposez pas déjà d’un compte de partenaire, inscrivez-vous à l’aide de la variable Shopify tableau de bord des partenaires.

Création de votre application

Avec un Shopify compte partenaire, vous pouvez maintenant poursuivre et créer votre application à l’aide du tableau de bord des partenaires. Pour obtenir des instructions complètes sur la création de votre application dans Shopify, lisez le Shopify guide de prise en main.

Une fois votre application créée, récupérez votre ID client et secret client de la informations d’identification client de la Shopify tableau de bord des partenaires. L’ID client et le secret client seront utilisés dans les étapes suivantes pour récupérer votre code d’autorisation et votre jeton d’accès.

Récupération de votre code d’autorisation

Ensuite, récupérez votre code d’autorisation en saisissant le de myshopify.com URL dans votre navigateur, ainsi que les chaînes de requête qui définissent votre clé d’API, vos portées et l’URI de redirection.

Le format de cette URL est le suivant :

Format d’API

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

Requête

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

Réponse

Une réponse réussie renvoie votre URL de redirection, y compris le code d’autorisation requis pour générer votre jeton d’accès.

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

Récupération de votre jeton d’accès

Maintenant que vous disposez de votre ID client, de votre secret client et de votre code d’autorisation, vous pouvez récupérer votre jeton d’accès. Pour récupérer votre jeton d’accès, envoyez une demande de POST à la variable myshopify.com URL lorsque vous ajoutez cette URL avec Shopify’s Point d’entrée de l’API : /admin/oauth/access_token.

Format d’API

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

Requête

La requête suivante génère un jeton d’accès pour votre Shopify instance.

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

Réponse

Une réponse réussie renvoie votre jeton d’accès et vos portées d’autorisation.

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

Création d’un webhook pour la diffusion en continu Shopify data webhook

Les webhooks permettent aux applications de rester synchronisées avec votre Shopify ou effectuer une action après qu’un événement particulier se produit dans un magasin. Pour la diffusion en continu Shopify données à Experience Platform, webhooks peut être utilisé pour définir le point de terminaison http et les rubriques d’abonnement.

Requête

La requête suivante crée un webhook pour votre Shopify Streaming data.

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

Réponse

Une réponse réussie renvoie des informations sur votre webhook, y compris les id, l’adresse et d’autres informations de métadonnées.

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

Limites limitations

Vous trouverez ci-dessous une liste des limites connues que vous pouvez rencontrer lors de l’utilisation de webhooks avec la variable Shopify Streaming source.

Étapes suivantes

Les tutoriels suivants décrivent les étapes à suivre pour connecter votre Shopify Streaming source à Experience Platform à l’aide de l’API et de l’interface utilisateur :