はじめの設定 6 / 14

Shopify をつなぐ

Shopify のストアをつなぐと、「この案を使う」を選んだ案を、ストアにそのまま反映できます。反映できるのは、商品・コレクション・ページ・ブログ記事の SEO のタイトルと説明文と、ページ・ブログ記事のタイトルです。つなぐには、ご自身のストアだけに入れる小さなアプリを Shopify の Dev Dashboard で作り、その Client ID と Client secret を管理画面に入れます。

必須かどうか
任意(Shopify のみ)
作業をする場所
Shopify の Dev Dashboard

始める前に

  • 必要なアカウント: ストアのオーナーか、アプリを作れる権限(App developer など)のあるアカウントです。アプリはストアと同じ組織の Dev Dashboard で作ります。ほかの組織で作ったアプリでは、この方法でつなげません。
  • ドメイン: get1pct に登録したサイトのドメインが、ストアのドメイン(独自ドメインか xxx.myshopify.com)と同じである必要があります。
  • つながなくても使えます: つながない場合は、届いた案の文をコピーして、Shopify の管理画面でご自身で反映します。
  • 画面の写真について: 検証用のストアが無いため、Shopify の画面の写真は載せていません。手順は Shopify の公式の説明にもとづいています。ボタンの名前は英語の画面のものです。

付ける権限(スコープ)

アプリに付ける Admin API のスコープは、次の 2 つだけです。書き込みのスコープには読み取りも含まれるので、read_ で始まるスコープを別に足す必要はありません。

  • write_products: 商品とコレクションを探して、SEO のタイトルと説明文(SEO のメタフィールド)を書き換えます。商品名は書き換えません。
  • write_content: ページとブログ記事を探して、タイトルと、SEO のタイトル・説明文を書き換えます(pageUpdate、articleUpdate、SEO のメタフィールド)。代わりに write_online_store_pages を付けても構いません。

商品だけ、またはページと記事だけを対象にするなら、どちらか 1 つだけでもつなげます。その場合は、つないだときに「反映できるのは商品とコレクションだけです」のような注意が出ます。スコープが無い種類の案は、文をコピーしてご自身で反映します。

注文・顧客・テーマ・ファイル・在庫・割引などのスコープは付けないでください。キーの保管のしかたや、漏れたかもしれないときの止め方は、API キーの扱いと安全にまとめています。

手順

手順 1Dev Dashboard でアプリを作る

  1. Shopify の Dev Dashboard(dev.shopify.com)を開きます。Shopify の管理画面の「設定」→「アプリ」から進むこともできます。
  2. 「Apps」の画面の右上にある Create app を押し、Start from Dev Dashboard を選びます。
  3. 分かる名前(例: get1pct)を入れて、Create を押します。

手順 2スコープを付けて、版を公開する

  1. アプリの Versions を開き、Scopes に write_products,write_content を入れます。ほかの欄は画面の案内どおりに埋めます。
  2. Release を押して、この版を公開します。版を 1 つ公開しないと、アプリをストアに入れられません。

手順 3ご自身のストアに入れる

アプリの画面で Install app を押し、つなぐストアを選んで Install を押します。

手順 4Client ID と Client secret をコピーする

アプリの Settings を開き、Credentials の欄にある Client ID と Client secret をコピーします。

Client secret は、パスワードと同じように扱います。メールやチャットに貼らないでください。

手順 5管理画面に入れて「接続する」を押す

管理画面の「サイトの接続」を開きます。「サイトの更新方法」の欄で、「Shopify・Webflow・Contentful・microCMS・その他のサービス」を選びます。

管理画面の「CMS をトークンでつなぐ」で Shopify を選んだ画面。ストアのドメイン、認証の方法、Client ID、Client secret の入力欄と接続のボタンがある
  1. 「お使いの CMS」で「Shopify」を選びます。
  2. 「ストアのドメイン」に、xxx.myshopify.com の xxx を入れます。
  3. 「認証の方法」は「Dev Dashboard のアプリ」のままにします。
  4. 「Client ID」に、アプリの Client ID を貼ります。
  5. 「Client secret またはトークン」に、アプリの Client secret を貼ります。
  6. 「接続する」を押します。

「接続中」と出れば完了です。「つないだときの注意」が出たときは、目を通しておきます(スコープが 1 つだけのときなどに出ます)。

2026 年 1 月より前に Shopify の管理画面で作ったカスタムアプリがあれば、そのトークン(shpat_ で始まるもの)も使えます。そのアプリに上と同じスコープが付いているかを確かめてから、「認証の方法」を「既存のカスタムアプリ(shpat_)」にして、トークンを貼ります。新しいカスタムアプリは、いまは管理画面では作れません。

この連携の基準

この接続で案を反映するとき、get1pct は毎回次の決まりで動きます。

  • 書き換えるのは、タイトル(title タグ)・説明文(meta description)・見出し(h1)の 3 種類で、接続のときに指定した項目だけです。本文は書き換えません。
  • CMS の今の値が、案の「変更前」(公開ページの文)とそっくり同じときだけ書き換えます。少しでも違えば、別の記事か、サイト側で文を足している(「|サイト名」など)ので、書かずにコピーで使ってもらいます。
  • 案の「変更後」が変更前と同じもの、2,000 文字を超えるもの、< > [ ] や制御文字を含むものは書きません(CMS 側でタグやショートコードとして読まれることがあるため)。
  • 書く前に「どの項目を、どの値から、どの値へ」の予定を残し、書いたあとは読み直して確かめます。保存された値が違えば、元の値に書き戻して失敗とします。
  • 途中で止まったときは、次に今の値を読み、書き終わっていれば済み、元のままなら続き、どちらでもなければ失敗とします。同じ書き込みを二重にしません。
  • 取り消しは、今の値が get1pct の書いた値のままのときだけ、元の値に戻します。そのあと人が直していれば、戻しません。
  • 呼ぶ先は、その CMS の公式の API のホストだけです。転送(リダイレクト)には従わず、15 秒で打ち切り、2MB を超える応答は読みません。
  • SEO のタイトルと説明文は、どの種類も SEO のメタフィールド(global の title_tag・description_tag)に書きます。送るのは書き換える方の値だけです。もう片方は送らないので、同じ時にほかの方が直していても上書きしません。
  • ストアの主言語の値だけを書き換えます。翻訳した言語のページ(/en/products/… など)の案は、コピーで使っていただきます。

Shopify・Webflow・Contentful・microCMS の違いは、CMS ごとにできることの表で比べられます。

つないだら確かめる

つないだら、「サイトの接続」の CMS の下にある「つながっているかを確かめる」を使います。記事やアイテムの公開ページの URL を 1 つ入れます。

  • 疎通テスト: CMS の記事を探し、タイトル・説明文・見出しのそれぞれで、CMS の値が公開ページの文とそっくり同じかを表で出します。同じ欄だけが自動で反映されます。違う欄は、表に理由が出ます。何も書き換えません。
  • 更新テスト: 自動で反映できる欄の 1 つに、今の値をそのまま書き直し、読み直します。公開ページの文は変わりません。トークンに書き込みの権限が無いときや、CMS が保存するときに文を変えるときは、その結果が出ます。

先に疎通テスト、次に更新テストの順に行ってください。更新テストで「次の反映ができません」と出たら、CMS でサイト(記事)を公開し直し、運営にお知らせください。

つないだあと

  • 対象は、商品(/products/…)・コレクション(/collections/…)・ページ(/pages/…)・ブログ記事(/blogs/…/…)です。どれに当たるかは公開ページの URL から自動で探します。ページと記事の対応を指定する必要はありません。
  • 見出し(h1)の案は、ページとブログ記事ではタイトルそのものを書き換えます。商品とコレクションの見出しの案は、自動では反映しません。商品名は注文・メール・Google ショッピングなどにも出るためです。文をコピーして、ご自身で反映します。
  • 書き換えるのは、ストアの今の値が公開ページの文とまったく同じときだけです。書き換えると、公開中のストアにすぐ出ます。反映した案は管理画面から取り消せます。
  • SEO のタイトルや説明文が空の商品やページ(Shopify が自動で文を作っているもの)は、公開ページの文と一致しないので書き換えません。トップページなど、上の 4 種類に当たらないページも同じです。どちらも文をコピーして、ご自身で反映します。
  • アプリのトークンは 24 時間で切れるので、get1pct は反映のたびに Client ID と Client secret からトークンを作り直します。

うまくいかないとき

「接続できませんでした」と出る
ストアのドメイン(xxx.myshopify.com の xxx)、Client ID、Client secret が合っているかを確かめます。次に、アプリをストアに入れたか、スコープを付けた版を公開(Release)したか、アプリとストアが同じ組織かを確かめます。get1pct に登録したサイトのドメインがストアのドメインと違う場合も、つながりません。
商品は反映されるが、ページやブログ記事は反映されない
アプリのスコープに write_content(または write_online_store_pages)が付いているかを確かめます。スコープを変えたら、新しい版を公開します。付いているスコープはつなぐときに読み取るので、そのあと「接続を切る」を押して、つなぎ直してください。
「つなぎ直しが必要」と出る
アプリをアンインストールした、Client secret を作り直した、などの理由で、トークンを受け取れなくなっています。Client ID と Client secret を確かめ、「接続を切る」を押してから、つなぎ直します。
案が自動で反映されない
SEO の欄が空の商品やページと、ストアの値が公開ページの文と違うものは、安全のため書き換えません。反映の方法は、案の画面に出ます。

やめるとき

管理画面の「サイトの接続」で「接続を切る」を押すと、お預かりした Client secret を消します。アプリは Shopify の側に残るので、Shopify の管理画面の「設定」→「アプリ」で get1pct 用のアプリをアンインストールするか、Dev Dashboard でアプリを削除してください。アンインストールすると、そのアプリではストアを読み書きできなくなります。

ほかの CMS の手順は、Webflow・Contentful・microCMSのページにあります。

手順のとおりに進まないときは、お問い合わせから、対象のサイトの URL と、どの画面で止まったかをお知らせください。パスワードは送らないでください。