[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform fornisce supporto per l’acquisizione di dati da applicazioni di streaming. Il supporto per i provider di streaming include Shopify.

Prerequisiti prerequisites

La sezione seguente illustra i passaggi prerequisiti da completare prima di utilizzare il Shopify Streaming sorgente.

È necessario disporre di un Shopify account partner per connettersi al Shopify API. Se non disponi già di un account partner, registrati utilizzando Shopify dashboard dei partner.

Creare l’applicazione

Con un Shopify account partner, ora puoi procedere e creare la tua app utilizzando la dashboard dei partner. Per passaggi completi su come creare l’app in Shopify, leggi Shopify guida introduttiva.

Una volta creata l’app, recupera ID client e segreto client dal credenziali client scheda di Shopify dashboard dei partner. L’ID client e il segreto client verranno utilizzati nei passaggi successivi per recuperare il codice di autorizzazione e il token di accesso.

Recuperare il codice di autorizzazione

Quindi, recupera il codice di autorizzazione immettendo il myshopify.com URL nel browser, insieme a stringhe di query che definiscono la chiave API, gli ambiti e l’URI di reindirizzamento.

Il formato di questo URL è il seguente:

Formato API

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

Richiesta

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

Risposta

In caso di esito positivo, la risposta restituisce l’URL di reindirizzamento, incluso il codice di autorizzazione necessario per generare il token di accesso.

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

Recuperare il token di accesso

Ora che disponi del tuo ID client, del segreto client e del codice di autorizzazione, puoi recuperare il token di accesso. Per recuperare il token di accesso, effettua una richiesta POST al myshopify.com URL durante l’aggiunta di questo URL a Shopify’s Endpoint API: /admin/oauth/access_token.

Formato API

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

Richiesta

La richiesta seguente genera un token di accesso per il Shopify dell'istanza.

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

Risposta

In caso di esito positivo, la risposta restituisce il token di accesso e gli ambiti delle autorizzazioni.

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

Creare un webhook per lo streaming Shopify dati webhook

I webhook consentono alle applicazioni di rimanere sincronizzate con Shopify o eseguire un'azione dopo che si è verificato un particolare evento in un negozio. Per lo streaming Shopify ad Experience Platform, i webhook possono essere utilizzati per definire l’endpoint http e gli argomenti per la sottoscrizione.

Richiesta

La richiesta seguente crea un webhook per Shopify Streaming dati.

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

Risposta

In caso di esito positivo, la risposta restituisce informazioni sul webhook, incluso il relativo idInformazioni su, indirizzo e altri metadati.

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

Limitazioni limitations

Di seguito è riportato un elenco delle limitazioni note che è possibile incontrare durante l’utilizzo dei webhook con Shopify Streaming sorgente.

Passaggi successivi

I seguenti tutorial illustrano i passaggi necessari per collegare Shopify Streaming da sorgente ad Experience Platform utilizzando l’API e l’interfaccia utente: