[Beta]{class="badge informative"}

Shopify Streaming

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

Conditions préalables prerequisites

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

Vous devez disposer d’un compte partenaire Shopify valide pour vous connecter aux API Shopify. Si vous ne disposez pas encore d’un compte partenaire, inscrivez-vous en utilisant le tableau de bord Shopify partenaires.

Création de votre application

Avec un compte partenaire Shopify valide, vous pouvez maintenant continuer 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 guide Shopify de prise en main ​.

Une fois votre application créée, récupérez vos identifiant client et secret client dans l’onglet informations d’identification du client du tableau de bord des partenaires Shopify. L’identifiant 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érer le 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é 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érer votre jeton d’accès

Maintenant que vous disposez de votre identifiant client, secret client et 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 POST à l’URL de myshopify.com de votre domaine tout en ajoutant 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 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 les portées d’autorisation.

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

Créer un webhook pour la diffusion en continu de 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 qu’un événement particulier se soit produit dans un magasin. Pour la diffusion en continu de données de Shopify vers Experience Platform, les webhooks peuvent être utilisés pour définir le point d’entrée http et les rubriques à abonner.

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/114ae3c01f3ac77c704465f83d7d79be150fc39a5a794a214cd4ab65a5901340?x-adobe-flow-id=d9eb4a58-6a6b-4f11-9dba-6d1e0ed43bad",
    "topic": "orders/create",
    "format": "json"
  }
}'

Réponse

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

{
  "webhook": {
    "id": 1091138715786,
    "address": "https://dcs.adobedc.net/collection/114ae3c01f3ac77c704465f83d7d79be150fc39a5a794a214cd4ab65a5901340?x-adobe-flow-id=d9eb4a58-6a6b-4f11-9dba-6d1e0ed43bad",
    "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 décrivent les étapes à suivre pour connecter votre source Shopify Streaming à Experience Platform à l’aide de l’API et de l’interface utilisateur :