📺

【Shopify.dev和訳】Apps/Channels/Cart permalinks

2021/09/17に公開約5,000字

この記事について

この記事は、Apps/Channels/Cart permalinksの記事を和訳したものです。

記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Build a sales channel with cart permalinks

このガイドでは、顧客が販売チャネルアプリを使ってマーチャントの製品を注文できるように、事前にロードされたアイテムを持つ Shopify チェックアウトへのリンクを構築する方法を説明します。

このガイドでは、パーマリンクに追加のパラメータを追加して、注文を販売チャネルに帰属させる方法も説明します。

前提条件 | Prerequisites

このガイドは、あなたが以下の内容に精通していることを前提としています。

概要 | Overview

カートパーマリンクを使って、マーチャントが簡単に商品をあなたのサイトに追加できる販売チャネルアプリを構築することができます。

カートパーマリンクは、お客様がショッピングカートやチェックアウトに直接アクセスできるようにあらかじめ作成されたリンクです。

これらのパーマリンクは、顧客が 1 つのマーチャントの商品をカートで購入できるようなアプリに最適です。

パーマリンクを使用した販売チャネルの構築は、いくつかの理由により、最も少ない統合作業で済みます。

  • アプリでチェックアウトを作成したり、支払いを処理したりする必要がない。
  • 注文の同期、論争の処理、返金の管理が必要ない。

決済と注文の管理 | Payments and order management

パーマリンクを使って Shopify のチェックアウトを管理する方法は以下の通りです。

  • 1 つまたは複数のバリアント ID をカートやチェックアウトに適用する。
  • 配送情報(住所、料金)や顧客情報を含むチェックアウトパラメータの追加する。

チェックアウト API を使用していないため、チェックアウトと支払い処理の検討を完了する必要はありません。

例:サードパーティのトークン化サービス、Shopify のカードボールトなど。

この例では、2 つの商品バリエーションが適用され、それぞれの数量が 1 であるチェックアウトへのリンクを作成する方法を説明します。

チェックアウトのパーマリンクを作成するには、マーチャントのショップの URL を以下のようにフォーマットして指定します。

http://yourstore.com/cart/#{variant_id}:#{quantity}(,...)

:
以下の例では、7088141270881382が製品のバリアント ID で、1が数量です。

http://your-store.myshopify.com/cart/70881412:1,70881382:1

チェックアウトパラメータの変更 | Modify the checkout parameters

この例では、カートのパーマリンク URL にチェックアウトのクエリパラメータを追加する方法を示します。

パーマリンクを修正するには、マーチャントのショップの URL を以下のような形式で指定します。

http://your-store.myshopify.com/cart/{variant_id}:{quantity}?checkout[email]=somebody@store.com&checkout[shipping_address][city]=thisismyhometown

この例では、[email]はフォーム内の任意のチェックアウトフィールドを表し、[shipping_address] [city]はネスティングを使用して子フィールドを入力する方法を示しています。

サポートされているチェックアウトパラメータのリスト :

Checkout parameter Description
checkout[email] チェックアウトを行うお客様のメールアドレス。
checkout[shipping_address][first_name] 住所 [first_name]
checkout[shipping_address][last_name] 住所 [last_name]
checkout[shipping_address][address1] 住所 [address1]
checkout[shipping_address][address2] 住所 [address2].
checkout[shipping_address][city] 住所 [都市]
checkout[shipping_address][zip] 住所 [zip]

支払いを受ける | Get paid

Shopify のBilling APIを使用して、販売チャネルアプリの料金をマーチャントに請求することができます。

Billing API を使用する場合、マーチャントに毎月の定期的なサブスクリプションを請求するか、または使用料を作成して売上のコミッションを取ることができます。

どちらの課金モデルを使用する場合でも、まずappSubscription リソースを作成する必要があります。

次に、コミッションベースの販売の場合は、使用料を作成する必要があります。

定期的な課金 | Recurring billing

appSubscriptionCreate mutation を使用して、定期的な課金を作成できます。このミューテーションは、アプリのサブスクリプション ID を返します。

手数料の請求 | Charging commissions

コミッションを課金するには、2 つのステップが必要です。

Storefront アクセストークンによる帰属 | Attribution with the Storefront access token

注文を販売チャネルやアプリに帰属させるには、パーマリンクに追加のパラメータを追加します。マーチャントは、売上帰属表示をチャネル別売上レポートで確認できます。

このレポートには、顧客が注文に使用したチャネルまたはアプリの名前が表示されます。

セールスアトリビュートは Shopify admin のサイドバーにも表示されます。以下の例のように、カートのパーマリンクにストアフロントアクセストークンを指定することができます。

/cart/70881412:1,70881382:1?access_token=#{access_token}

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Discussion

ログインするとコメントできます