[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform biedt ondersteuning voor het opnemen van gegevens uit streaming toepassingen. Ondersteuning voor streaming providers omvat Shopify.

Vereisten prerequisites

In de volgende sectie worden de vereiste stappen beschreven die moeten worden uitgevoerd voordat u de opdracht Shopify Streaming bron.

U moet een geldige Shopify partnerrekening om met te verbinden Shopify API's. Als u nog geen partneraccount hebt, kunt u zich registreren via de Shopify partnerdashboard.

Uw toepassing maken

Met een geldige Shopify partneraccount, kunt u nu doorgaan en uw app maken via het partnerdashboard. Voor uitgebreide stappen over het maken van uw app in Shopify, lees de Shopify gids over aan de slag gaan.

Wanneer uw app is gemaakt, haalt u uw client-id en clientgeheim van de clientgegevens tabblad van het Shopify het dashboard van partners. De cliënt ID en het cliëntgeheim zullen in de volgende stappen worden gebruikt om uw vergunningscode en toegangstoken terug te winnen.

De verificatiecode ophalen

Haal vervolgens de verificatiecode op door de domeingegevens in te voeren myshopify.com URL in uw browser, samen met vraagkoorden die uw API sleutel, werkingsgebied, en redirect URI bepalen.

De notatie voor deze URL is als volgt:

API-indeling

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

Verzoek

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

Antwoord

Een succesvolle reactie keert uw omleidings URL, met inbegrip van de vergunningscode terug die wordt vereist om uw toegangstoken te produceren.

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

Uw toegangstoken ophalen

Nu u uw cliënt identiteitskaart, cliëntgeheim, en vergunningscode hebt, kunt u uw toegangstoken terugwinnen. Om uw toegangstoken terug te winnen, doe een verzoek van de POST aan uw domein myshopify.com URL terwijl het toevoegen van deze URL met Shopify’s API-eindpunt: /admin/oauth/access_token.

API-indeling

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

Verzoek

Het volgende verzoek produceert een toegangstoken voor uw Shopify -instantie.

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

Antwoord

Een succesvolle reactie keert uw toegangstoken en toestemmingswerkingsgebied terug.

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

Webhaak voor streaming maken Shopify data webhook

Met webhaken kunnen toepassingen gesynchroniseerd blijven met uw Shopify gegevens of voer een actie uit nadat een bepaalde gebeurtenis in een winkel voorkomt. Voor streaming Shopify gegevens aan Experience Platform, kunnen de webhooks worden gebruikt om het eindpunt van http en de onderwerpen voor abonnement te bepalen.

Verzoek

Met de volgende aanvraag wordt een webhaak gemaakt voor uw Shopify Streaming gegevens.

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

Antwoord

Een succesvolle reactie retourneert informatie over uw webhaak, inclusief de bijbehorende id, het adres en andere metagegevens.

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

Beperkingen limitations

Hieronder volgt een lijst met bekende beperkingen die u kunt tegenkomen bij het gebruik van webhaken met de Shopify Streaming bron.

Volgende stappen

De volgende zelfstudies bieden stappen voor het tot stand brengen van een verbinding met uw Shopify Streaming bron naar Experience Platform met behulp van de API en de UI: