[Beta]{class="badge informative"}

Shopify Streaming

O Adobe Experience Platform oferece suporte para assimilação de dados de aplicativos de transmissão contínua. O suporte para provedores de transmissão inclui Shopify.

Pré-requisitos prerequisites

A seção a seguir descreve as etapas de pré-requisito a serem concluídas antes de usar o Shopify Streaming origem.

Você deve ter um válido Shopify conta do parceiro para se conectar à Shopify APIs. Se você ainda não tiver uma conta de parceiro, registre-se usando o Shopify painel de parceiros.

Criar seu aplicativo

Com um válido Shopify conta de parceiro, agora você pode continuar e criar seu aplicativo usando o painel de parceiros. Para obter etapas abrangentes sobre como criar seu aplicativo no Shopify, leia o Shopify guia de introdução.

Depois que o aplicativo for criado, recupere ID do cliente e segredo do cliente do credenciais do cliente guia do Shopify painel de parceiros. A ID do cliente e o segredo do cliente serão usados nas próximas etapas para recuperar o código de autorização e o token de acesso.

Recupere seu código de autorização

Em seguida, recupere o código de autorização inserindo o nome do domínio myshopify.com O URL no navegador, juntamente com as sequências de consulta que definem a chave da API, os escopos e o URI de redirecionamento.

O formato desse URL é o seguinte:

Formato da API

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

Solicitação

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

Resposta

Uma resposta bem-sucedida retorna o URL de redirecionamento, incluindo o código de autorização necessário para gerar o token de acesso.

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

Recupere o token de acesso

Agora que você tem a ID do cliente, o segredo do cliente e o código de autorização, é possível recuperar o token de acesso. Para recuperar o token de acesso, faça uma solicitação POST no myshopify.com URL ao anexar este URL com Shopify’s Endpoint da API: /admin/oauth/access_token.

Formato da API

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

Solicitação

A solicitação a seguir gera um token de acesso para o Shopify instância.

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

Resposta

Uma resposta bem-sucedida retorna o token de acesso e os escopos de permissão.

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

Criar um webhook para transmissão Shopify dados webhook

Os webhooks permitem que os aplicativos permaneçam sincronizados com o Shopify dados ou executar uma ação depois que um evento específico ocorrer em uma loja. Para transmissão Shopify dados para Experience Platform, os webhooks podem ser usados para definir o endpoint http e os tópicos para assinatura.

Solicitação

A solicitação a seguir cria um webhook para o Shopify Streaming dados.

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

Resposta

Uma resposta bem-sucedida retorna informações no webhook, incluindo as correspondentes id, endereço e outras informações de metadados.

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

Limitações limitations

Veja a seguir uma lista de limitações conhecidas que podem ser encontradas ao usar webhooks com o Shopify Streaming origem.

Próximas etapas

Os seguintes tutoriais fornecem etapas sobre como conectar seus Shopify Streaming origem para Experience Platform usando a API e a interface do usuário: