[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform biedt ondersteuning voor het opnemen van gegevens uit streaming toepassingen. Tot de ondersteuning voor streamingproviders behoren Shopify .

Vereisten prerequisites

In de volgende sectie worden de vereiste stappen beschreven die moeten worden uitgevoerd voordat de Shopify Streaming -bron wordt gebruikt.

U moet een geldige Shopify partneraccount hebben om verbinding te kunnen maken met de Shopify API's. Als u nog geen partnerrekening hebt, gelieve te registreren gebruikend het Shopify partners dashboard.

Uw toepassing maken

Met een geldig Shopify partneraccount kunt u nu doorgaan en uw app maken via het partnerdashboard. Voor uitvoerige stappen op hoe te om uw app in Shopify tot stand te brengen, lees de Shopify gids op begonnen worden.

Zodra uw app wordt gecreeerd, wint uw cliëntidentiteitskaart en cliëntgeheim van het cliëntgeloofsbrieven lusje van het Shopify partnerdashboard terug. 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

Vervolgens haalt u uw machtigingscode op door de myshopify.com URL van uw domein in te voeren in uw browser, samen met querytekenreeksen die uw API-sleutel, bereik en de omleidings-URI definiëren.

De notatie voor deze URL is als volgt:

API formaat

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

Reactie

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. Als u uw toegangstoken wilt ophalen, vraagt u een POST aan naar de URL van uw domein myshopify.com terwijl u deze URL toevoegt met het Shopify’s API-eindpunt: /admin/oauth/access_token .

API formaat

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

Verzoek

Met de volgende aanvraag wordt een toegangstoken voor de instantie Shopify gegenereerd.

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

Reactie

Een succesvolle reactie keert uw toegangstoken en toestemmingswerkingsgebied terug.

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

Webhaak maken voor streaming Shopify -gegevens webhook

Met webhaken kunnen toepassingen gesynchroniseerd blijven met uw Shopify -gegevens of een actie uitvoeren nadat een bepaalde gebeurtenis in een winkel heeft plaatsgevonden. Voor het stromen 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 voor uw Shopify Streaming -gegevens gemaakt.

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

Reactie

Een geslaagde reactie retourneert informatie over de 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 websites met de Shopify Streaming -bron.

Volgende stappen

De volgende zelfstudies bieden stappen voor het aansluiten van de Shopify Streaming -bron op een Experience Platform met behulp van de API en de UI: