[Beta]{class="badge informative"}

Shopify Streaming

NOTE
The Shopify Streaming källan är i betaversion. Läs källöversikt om du vill ha mer information om hur du använder betamärkta källor.

Adobe Experience Platform har stöd för inmatning av data från direktuppspelningsprogram. Stöd för strömningsleverantörer innefattar Shopify.

Förutsättningar prerequisites

I följande avsnitt beskrivs de nödvändiga stegen som måste utföras innan du använder Shopify Streaming källa.

Du måste ha en giltig Shopify partnerkonto för att ansluta till Shopify API. Om du inte redan har ett partnerkonto kan du registrera dig med Shopify instrumentpanel för partners.

Skapa ditt program

Med ett giltigt Shopify partnerkontot kan du nu fortsätta och skapa din app med partnerinstrumentpanelen. Om du vill ha mer information om hur du skapar en app i Shopify, läsa Shopify guide för att komma igång.

När appen har skapats kan du klient-ID och klienthemlighet från klientautentiseringsuppgifter -fliken i Shopify instrumentpanel för partners. Klient-ID och klienthemlighet används i nästa steg för att hämta din auktoriseringskod och åtkomsttoken.

Hämta din auktoriseringskod

Hämta sedan din auktoriseringskod genom att ange din domäns myshopify.com URL:en till webbläsaren, tillsammans med frågesträngar som definierar API-nyckeln, omfånget och omdirigerings-URI:n.

Formatet för den här URL:en är följande:

API-format

https://{SHOP}.myshopify.com/admin/oauth/authorize?client_id={API_KEY}&scope={SCOPES}&redirect_uri={REDIRECT_URI}
Parameter
Beskrivning
shop
Din underdomän myshopify.com URL.
api_key
Dina Shopify klient-ID. Du kan hämta ditt klient-ID från klientautentiseringsuppgifter -fliken i Shopify instrumentpanel för partners.
scopes
Den typ av åtkomst som du vill definiera. Du kan till exempel ange omfång som scope=write_orders,read_customers för att tillåta behörigheter att ändra beställningar och läsa kunder.
redirect_uri
URL:en för skriptet som ska generera åtkomsttoken.

Begäran

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

Svar

Ett lyckat svar returnerar din omdirigerings-URL, inklusive den auktoriseringskod som krävs för att generera din åtkomsttoken.

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

Hämta din åtkomsttoken

Nu när du har ditt klient-ID, din klienthemlighet och din behörighetskod kan du hämta din åtkomsttoken. Om du vill hämta din åtkomsttoken gör du en POST-förfrågan till din domäns myshopify.com URL när den här URL:en läggs till med Shopify’s API-slutpunkt: /admin/oauth/access_token.

API-format

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

Begäran

Följande begäran genererar en åtkomsttoken för din Shopify -instans.

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

Svar

Ett lyckat svar returnerar din åtkomsttoken och dina behörighetsområden.

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

Skapa en webkrok för direktuppspelning Shopify data webhook

Med webbhooks kan program förbli synkroniserade med dina Shopify data eller utför en åtgärd efter att en viss händelse inträffar i en butik. För direktuppspelning Shopify data till Experience Platform kan webhooks användas för att definiera http-slutpunkten och avsnitten för prenumeration.

Begäran

I följande begäran skapas en webbkrok för 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"
  }
}'
Parameter
Beskrivning
webhook.address
Den http-slutpunkt dit direktuppspelningsmeddelanden skickas.
webhook.topic
Avsnittet om din webkroprenumeration. Mer information finns i Shopify händelseguide för webkroch.
webhook.format
Dataformatet.

Svar

Ett lyckat svar returnerar information på din webbkrok, inklusive dess motsvarande idoch annan metadatainformation.

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

Begränsningar limitations

Nedan följer en lista över kända begränsningar som du kan stöta på när du använder webbhooks med Shopify Streaming källa.

  • Det är inte säkert att du kan ordna leveransordningen för olika ämnen för samma resurs. Det är till exempel möjligt att en products/update webbkrok levereras innan products/create webbkrok.
  • Du kan ställa in webkroken så att den levererar webkrockhändelser till en slutpunkt minst en gång. Det innebär att en slutpunkt kan ta emot samma händelse flera gånger. Du kan söka efter duplicerade webkrockhändelser genom att jämföra X-Shopify-Webhook-Id huvud till tidigare händelser.
  • Shopify behandlar HTTP 2xx-statussvar som lyckade meddelanden. Andra statuskodssvar betraktas som misslyckanden. Shopify innehåller en återförsöksmekanism för misslyckade webkrockmeddelanden. Om det finns inget svar efter fem sekunder, Shopify försöker ansluta igen 19 gånger under nästa 48 timmar. Om det fortfarande inte finns några svar i slutet av återförsöksperioden Shopify tar bort webkroken.

Nästa steg

I följande självstudiekurser finns anvisningar om hur du ansluter Shopify Streaming för Experience Platform med API och användargränssnittet:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089