[Version bêta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform prend en charge l’ingestion de données à partir d’applications de diffusion en continu. Shopify est compatible avec les fournisseurs de diffusion en continu.

Conditions préalables prerequisites

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

Vous devez disposer d’un compte partenaire Shopify valide pour vous connecter aux API Shopify. Si vous n’avez pas encore de compte de partenaire, inscrivez-vous à l’aide du Shopify tableau de bord des partenaires.

Création de votre application

Avec un compte de partenaire Shopify valide, 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, consultez le Shopify guide de prise en main.

Une fois votre application créée, récupérez votre ID client et secret client à partir de l’onglet informations d’identification client du tableau de bord Shopify 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 l’URL myshopify.com de votre domaine dans votre navigateur, ainsi que les chaînes de requête qui définissent votre clé d’API, les 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 requête de POST à l’URL myshopify.com de votre domaine en ajoutant cette URL avec le point d’entrée de l’API Shopify’s : /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 instance 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"
}'

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 des données Shopify webhook

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

Requête

La requête suivante crée un webhook pour vos données Shopify Streaming.

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 son id correspondant, son 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

Voici une liste des limites connues que vous pouvez rencontrer lors de l’utilisation de webhooks avec la source Shopify Streaming.

Étapes suivantes

Les tutoriels suivants expliquent comment connecter votre source Shopify Streaming à Experience Platform à l’aide de l’API et de l’interface utilisateur :