[Beta]{class="badge informative"}

Shopify Streaming

Adobe Experience Platform은 스트리밍 애플리케이션에서 데이터를 수집할 수 있도록 지원합니다. 스트리밍 공급자에 대한 지원에는 Shopify이(가) 포함됩니다.

전제 조건 prerequisites

다음 단원에서는 Shopify Streaming 원본을 사용하기 전에 완료해야 하는 필수 조건 단계에 대해 설명합니다.

Shopify API에 연결하려면 유효한 Shopify 파트너 계정이 있어야 합니다. 파트너 계정이 아직 없는 경우 Shopify 파트너 대시보드를 사용하여 등록하십시오.

애플리케이션 만들기

이제 올바른 Shopify 파트너 계정을 사용하여 파트너 대시보드를 사용하여 계속 진행하고 앱을 만들 수 있습니다. Shopify에서 앱을 만드는 방법에 대한 포괄적인 단계는 Shopify 시작 가이드를 참조하십시오.

앱이 만들어지면 Shopify 파트너 대시보드의 클라이언트 자격 증명 탭에서 클라이언트 ID 및 클라이언트 암호 ​를 검색합니다. 클라이언트 ID 및 클라이언트 암호는 다음 단계에서 인증 코드 및 액세스 토큰을 검색하는 데 사용됩니다.

인증 코드 검색

그런 다음 API 키, 범위 및 리디렉션 URI를 정의하는 쿼리 문자열과 함께 도메인의 myshopify.com URL을 브라우저에 입력하여 인증 코드를 검색합니다.

이 URL의 형식은 다음과 같습니다.

API 형식

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

요청

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

응답

성공적인 응답은 액세스 토큰을 생성하는 데 필요한 인증 코드를 포함하여 리디렉션 URL을 반환합니다.

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

액세스 토큰 검색

클라이언트 ID, 클라이언트 암호 및 인증 코드가 있으므로 액세스 토큰을 검색할 수 있습니다. 액세스 토큰을 검색하려면 Shopify’s API 끝점 /admin/oauth/access_token을(를) 사용하여 이 URL을 추가하는 동안 도메인의 myshopify.com URL에 POST 요청을 합니다.

API 형식

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

요청

다음 요청은 Shopify 인스턴스에 대한 액세스 토큰을 생성합니다.

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

응답

성공적인 응답은 액세스 토큰과 권한 범위를 반환합니다.

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

Shopify 데이터 스트리밍을 위한 웹후크 만들기 webhook

웹후크를 사용하면 응용 프로그램이 Shopify 데이터와 계속 동기화되거나 특정 이벤트가 상점에서 발생한 후 작업을 수행할 수 있습니다. Shopify 데이터를 Experience Platform으로 스트리밍하기 위해 웹후크를 사용하여 HTTP 끝점과 구독 항목을 정의할 수 있습니다.

요청

다음 요청은 Shopify Streaming 데이터에 대한 웹후크를 만듭니다.

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

응답

성공한 응답은 해당 id, 주소 및 기타 메타데이터 정보를 포함하여 웹후크에 대한 정보를 반환합니다.

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

제한 사항 limitations

다음은 Shopify Streaming 원본과 함께 웹후크를 사용할 때 발생할 수 있는 알려진 제한 사항 목록입니다.

다음 단계

다음 자습서에서는 API 및 UI를 사용하여 Shopify Streaming 소스를 Experience Platform에 연결하는 방법에 대한 단계를 제공합니다.