[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform unterstützt die Erfassung von Daten aus Streaming-Anwendungen. Unterstützung für Streaming-Anbieter umfasst Shopify.

Voraussetzungen prerequisites

Im folgenden Abschnitt werden die erforderlichen Schritte beschrieben, die vor Verwendung der Shopify Streaming -Quelle.

Sie müssen über gültige Shopify Partnerkonto, um eine Verbindung zum Shopify APIs. Wenn Sie noch kein Partnerkonto haben, registrieren Sie sich bitte über das Shopify Partner-Dashboard.

Anwendung erstellen

Mit gültigen Shopify Partnerkonto verwenden, können Sie jetzt mit dem Partner-Dashboard fortfahren und Ihre App erstellen. Umfassende Schritte zum Erstellen Ihrer App in Shopify, lesen Sie die Shopify Erste Schritte.

Rufen Sie nach der Erstellung Ihrer App Ihre Client-ID und Client-Geheimnis aus dem Client-Anmeldeinformationen des Shopify Partner-Dashboard. Die Client-ID und das Client-Geheimnis werden in den nächsten Schritten verwendet, um Ihren Autorisierungscode und Ihr Zugriffstoken abzurufen.

Abrufen des Autorisierungscodes

Rufen Sie als Nächstes Ihren Autorisierungscode ab, indem Sie die myshopify.com URL in Ihren Browser sowie Abfragezeichenfolgen, die Ihren API-Schlüssel, Bereiche und den Umleitungs-URI definieren.

Das Format dieser URL lautet wie folgt:

API-Format

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

Anfrage

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

Antwort

Bei einer erfolgreichen Antwort wird Ihre Umleitungs-URL zurückgegeben, einschließlich des Autorisierungscodes, der zum Generieren Ihres Zugriffstokens erforderlich ist.

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

Zugriffstoken abrufen

Nachdem Sie nun Ihre Client-ID, Ihr Client-Geheimnis und Ihren Autorisierungscode haben, können Sie Ihr Zugriffstoken abrufen. Um Ihr Zugriffstoken abzurufen, stellen Sie eine POST-Anfrage an die myshopify.com URL beim Anhängen dieser URL an Shopify’s API-Endpunkt: /admin/oauth/access_token.

API-Format

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

Anfrage

Die folgende Anfrage generiert ein Zugriffstoken für Ihre Shopify -Instanz.

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

Antwort

Bei einer erfolgreichen Antwort werden Ihr Zugriffstoken und die Berechtigungsbereiche zurückgegeben.

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

Webhook für Streaming erstellen Shopify data webhook

Webhooks ermöglichen es Anwendungen, mit Ihrer Shopify Daten oder eine Aktion ausführen, nachdem ein bestimmtes Ereignis in einem Shop auftritt. Streaming Shopify -Daten an Experience Platform übergeben, können Webhooks verwendet werden, um den HTTP-Endpunkt und die Themen für die Anmeldung zu definieren.

Anfrage

Die folgende Anfrage erstellt einen Webhook für Ihre Shopify Streaming Daten.

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

Antwort

Eine erfolgreiche Antwort gibt Informationen zu Ihrem Webhook zurück, einschließlich der zugehörigen id, Adresse und andere Metadateninformationen.

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

Einschränkungen limitations

Im Folgenden finden Sie eine Liste bekannter Einschränkungen, auf die Sie bei der Verwendung von Webhooks mit dem Shopify Streaming -Quelle.

Nächste Schritte

In den folgenden Tutorials erfahren Sie, wie Sie Ihre Shopify Streaming -Quelle zum Experience Platform mithilfe der API und der Benutzeroberfläche: