顧客の検索

Shopifyの顧客プロフィールを検索します。

オプション

フィールド 定義 タイプ 必須

結果セット(Result Set)

検索がFirst Matching RecordまたはAll Matching Recordsのどちらを返すかを選択します。

ドロップダウン

入力

フィールド 定義 タイプ 必須

顧客(Customer)

名(First Name)

顧客の名。

テキスト FALSE

姓(Last Name)

顧客の姓。

テキスト FALSE

メール(Email)

顧客のメールアドレス。

テキスト FALSE

電話(Phone)

顧客の電話番号。

テキスト FALSE

状態(State)

店舗における顧客アカウントの状態。オプションは以下のとおり。

  • enabled

  • disabled

  • invited

  • declined

ドロップダウン FALSE

マーケティングに同意?(Accepts Marketing?)

メールでマーケティング資料を受け取ることに顧客が同意したかどうかを示します。

True/False FALSE

タグ(Tag)

顧客に追加されたタグ。

テキスト FALSE

確認されたメール?(Verified Email?)

顧客がメールアドレスを確認済みかどうかを示します。

True/False FALSE

マルチパス識別子(Multipass Identifier)

マルチパスログインで使用される、顧客の一意な識別子。

テキスト FALSE

住所(Address)

名(First Name)

顧客の名。

テキスト FALSE

姓(Last Name)

顧客の姓。

テキスト FALSE

会社(Company)

顧客の会社名。

テキスト FALSE

住所1(Address1)

顧客住所の最初の行。

テキスト FALSE

住所2(Address2)

顧客住所の2番目の行。

テキスト FALSE

市区町村(City)

顧客の市。

テキスト FALSE

都道府県(Province)

顧客の都道府県。

テキスト FALSE

国(Country)

顧客の国。

テキスト FALSE

カスタムフィルター(Custom Filters)

カスタムフィルター(Custom Filters)

クエリ構文を使った、Shopifyプラットフォーム全体に適用されるカスタム検索フィルター。フィルターには接続語、用語、修飾子、比較演算子を使用できます。フィルターでは用語、フィールド値、ブール演算子、範囲、除外を使った検索も実行できます。

たとえば、 query=-first_name:Bob AND orders_count:>1 orders_count:<=6というクエリーは、これまでの注文数が6回以下(ただし1回より多い)で、Bobという名の顧客を検索します。

Shopify APIの検索構文を参照してください。

テキスト FALSE

出力

フィールド 定義 タイプ

ID

顧客のグローバルな一意の識別子。

数値

メール(Email)

顧客のメールアドレス。

テキスト

作成日時(Created At)

オブジェクトが作成された日時。 日時

更新日時(Updated At)

顧客プロファイルが最後に更新された日時。

日時

名(First Name)

顧客の名。

テキスト

姓(Last Name)

顧客の姓。

テキスト

注文数(Orders Count)

顧客がこれまでにストアで注文した回数。

数値

状態(State)

店舗における顧客アカウントの状態。オプションは以下のとおり。

  • enabled

  • disabled

  • invited

  • declined

テキスト

合計支出(Total Spent)

顧客がこれまでに注文に支払った合計金額。

テキスト

最終注文ID(Last Order ID)

顧客が最後に行った注文のグローバルな一意の識別子。

数値

注(Note)

顧客に関するメモ。

テキスト

確認されたメール?(Verified Email?)

顧客がメールアドレスを確認済みかどうかを示します。

True/False

マルチパス識別子(Multipass Identifier)

マルチパスログインで使用される、顧客の一意な識別子。

テキスト

非課税?(Tax Exempt?)

顧客からの注文が非課税かどうかを示します。

True/False

電話(Phone)

顧客の電話番号。

テキスト

タグ(Tags)

顧客に追加されたタグをカンマで区切ったリスト。

テキスト

最終注文名(Last Order Name)

注文に表示される注文の一意な識別子。(#1000_Store1001など)。この値は複数の店舗間で一意ではありません。

テキスト

通貨(Currency)

ストアで使用している通貨。

テキスト

住所(Addresses)

ID

住所オブジェクトの一意の識別子。

数値

顧客ID(Customer ID)

顧客のグローバルな一意の識別子。

数値

名(First Name)

顧客の名。

テキスト

姓(Last Name)

顧客の姓。

テキスト

会社(Company)

顧客の会社名。

テキスト

住所1(Address1)

顧客住所の最初の行。

テキスト

住所2(Address2)

顧客住所の2番目の行。

テキスト

市区町村(City)

顧客の市。

テキスト

都道府県(Province)

顧客の都道府県。

テキスト

国(Country)

顧客の国。

テキスト

郵便番号(ZIP)

顧客の郵便番号。

テキスト

電話(Phone)

顧客の電話番号。

テキスト

名前(Name)

顧客のフルネーム。

テキスト

都道府県コード(Province Code)

顧客の都道府県コードまたは都道府県の略称。

テキスト

国番号(Country Code)

顧客の国コード。

テキスト

国名(Country Name)

顧客の標準化された国名。

テキスト

デフォルト?(Default?)

この住所が、顧客のデフォルト住所かどうかを示します。

True/False

免税(Tax Exemptions)

顧客に適用される免税のリスト。

テキストのリスト

GraphicQL API ID

パターン//shopify/Customer/{customer_id}に基づく、顧客の一意な識別子。

テキスト

デフォルトの住所(Default Address)

ID

住所オブジェクトの一意の識別子。

数値

顧客ID(Customer ID)

顧客のグローバルな一意の識別子。

数値

名(First Name)

顧客の名。

テキスト

姓(Last Name)

顧客の姓。

テキスト

会社(Company)

顧客の会社名。

テキスト

住所1(Address1)

顧客住所の最初の行。

テキスト

住所2(Address2)

顧客住所の2番目の行。

テキスト

市区町村(City)

顧客の市。

テキスト

都道府県(Province)

顧客の都道府県。

テキスト

国(Country)

顧客の国。

テキスト

郵便番号(ZIP)

顧客の郵便番号。

テキスト

電話(Phone)

顧客の電話番号。

テキスト

名前(Name)

顧客のフルネーム。

テキスト

都道府県コード(Province Code)

顧客の都道府県コードまたは都道府県の略称。

テキスト

国番号(Country Code)

顧客の国コード。

テキスト

国名(Country Name)

顧客の標準化された国名。

テキスト

デフォルト?(Default?)

この住所が、顧客のデフォルト住所かどうかを示します。

True/False

メールマーケティング同意(Email Marketing Consent)

状態(State)

顧客の現在のメールマーケティング状態。

テキスト

オプトインレベル(Opt In Level)

M3AAWG送信者の共通ベストプラクティスで説明されているマーケティングサブスクリプションのオプトインレベル。メールによるマーケティング資料の受け取りに顧客が同意したレベル。

テキスト

更新日時(Updated At)

メールによるマーケティング資料の受け取りに顧客が同意した日時。値を指定しない場合、顧客情報が送信された日時が使用されます。

日時

SMSマーケティング同意(SMS Marketing Consent)

状態(State)

顧客の現在のSMSマーケティング状態。

テキスト

オプトインレベル(Opt In Level)

M3AAWG送信者の共通ベストプラクティスで説明されているマーケティングサブスクリプションのオプトインレベル。マーケティング情報の受け取りに顧客が同意した時点で設定されます。

テキスト

更新日時(Updated At)

SMSによるマーケティング資料の受け取りに顧客が同意した日時。値を指定しない場合、顧客情報が送信された日時が使用されます。

日時

収集元(Collected From)

顧客のマーケティング情報が収集されたソース。

テキスト