GenderAPIアプリでShopifyの顧客レコードを拡充する

顧客データの拡充にはネイティブアプリを使用する

GenderAPIのShopifyアプリは、既存の顧客と新しい顧客を処理し、推定された性別シグナルを追加し、欠けている名前をメールアドレスから導き出すことができます。対象のShopifyストアから始め、更新したい顧客フィールドに合ったアプリ設定を選択してください。

これは、独自の処理設定とプラン設定を持つネイティブのShopifyアプリです。2026年9月27日に確認した実装は、公開されているV2の推定エンドポイントを呼び出していません。APIキーの残高、V2のAIオプション、V2のレスポンスフィールドがこのアプリに適用されると想定しないでください。

Shopify App Storeの公式掲載ページ

ストアを準備し、変更する内容を決める

Shopify App Storeで「Gender API - Determine gender」を開きます。インストールする前に、Ozan Softによる掲載ページであること、対象のストア、現在の権限、プランを確認してください。
アプリの残高と顧客処理の設定を確認します。既存のレコードを処理するか、新しい顧客の自動処理を有効にするか、またはその両方にするかを決めてください。
名前が入力されている顧客、名前が欠けている顧客、あいまいな入力を含む顧客など、少数の顧客レコードを確認します。結果を確認する間は、既存の名前とタグが見える状態にしておいてください。
メールアドレスから導き出した候補を顧客の名前フィールドに書き込みたい場合にのみ、欠けている名前の補完を有効にしてください。性別の推定と名前の編集は別々の判断です。
セグメントで使用する前に、生成されたタグと顧客メタフィールドを確認します。関係のない顧客情報が変更されていないことを確認してください。

アプリが使用する顧客フィールドを理解する

以下のマッピングは、確認したアプリのソースコードに基づいています。下流のワークフローを接続する前に、インストール済みのアプリと管理されたサンプルで確認してください。

顧客フィールドまたは設定	方向	動作
名前	入力	名前がある場合に優先される入力です。
メールアドレス	入力	名前が欠けている場合に候補の名前を導き出すために使用されます。有用な名前を含まないアドレスは未解決のままになることがあります。
住所の国	任意のコンテキスト	処理では、利用可能な顧客住所の国を名前検索のコンテキストとして使用できます。
顧客タグ	出力	確認した実装ではmale、female、gender_nullを使用し、関係のないタグは保持されます。
custom.gender	出力	推定されたラベルを1行テキストの値として保持する顧客メタフィールドです。
名前の更新	任意の出力	有効にすると、メールアドレスから導き出した候補で欠けている名前を補完できます。実装ではfirst_name_found_from_emailが追加されます。
自動拡充	アプリの設定	新しい顧客イベントの処理を制御します。利用可否はアプリのプランと設定によって異なります。

タグ、不明な結果、既存の分類を確認する

処理済みの顧客をShopifyで開き、タグ、custom.gender、名前を元のレコードと比較します。セグメントには、APIのJSONパスが利用できると想定するのではなく、実際に保存されたフィールドとラベルを使用してください。

確認した処理では、すでにmale、female、gender_nullのタグが付いている顧客はスキップされます。そのため、変更されていないレコードは、新たな検索ではなく既存の分類を示している可能性があります。再度実行する前に、以前の分類をどのように確認するかを決めてください。

gender_nullは未解決として扱ってください。ネイティブのマッピングでは、V2の信頼度スコア、ソースフィールド、リクエストごとのusageレコードは提供されません。スプレッドシートのエクスポートでこれらの値を作り出したり、不明な結果を二値の分類に変えたりしないでください。

結果	推奨される次のステップ
期待どおりのタグとメタフィールド	元の顧客IDを確認し、意図したセグメントまたは下流の更新だけを許可します。
gender_null	未解決のままにし、identifiedの結果を必要とするルールから除外します。
既存の性別タグ	再処理を決める前に、アプリがその顧客をスキップしたかどうかを確認します。
更新がない、または内容が一致しない	グループ全体を再度実行する前に、アプリの処理ステータスを確認します。

アプリのプランとデータアクセスを確認する

顧客処理の上限は、Shopifyアプリの現在のプラン画面と残高で確認してください。確認したアプリはストアごとのクレジット残高とShopifyの購入フローを使用しており、公開されているGenderAPIのAPIキーで設定するものではありません。V2のクレジット料金を適用するのではなく、アプリの掲載ページで現在の価格を確認してください。

このアプリは顧客データへのアクセスを必要とし、顧客レコードを編集できます。処理にはアプリ側のキューが含まれるため、メールアドレスのクエリの保持に関する記述を、このワークフロー中に顧客データがまったく保管されないという約束として読むべきではありません。ストアに対するアプリの権限と公開されているポリシーを確認してください。

推定されたラベルは、不確実性を伴うデータ上のシグナルです。本人が申告した情報とは区別し、適格性、アクセス、価格設定、その他の重大な判断の唯一の根拠として使用しないでください。

構造化されたレスポンスが必要な場合はV2を使用する

カスタム連携では、GenderAPI V2は名前、メールアドレス、ユーザー名を受け付け、結果、信頼度、ソース、使用量を示す明示的なフィールドを返します。この接続は別途設定してください。V2ガイドを読んでも、インストール済みのアプリやその出力列は変更されません。

PythonとNode.jsの例では、単一リクエスト、バッチ、不明な結果、運用上のエラーを扱います。認証ガイドから始め、課金対象のリクエストを送信する前にAIモードを選択してください。

よくある質問

ShopifyアプリはV2 APIキーで設定しますか？

確認したネイティブアプリは、Shopifyでのインストール、独自のプラン設定、ストアごとの残高を使用します。V2を使ったカスタムのHTTPワークフローは別の連携であり、ネイティブアプリの設定を置き換えるものではありません。

顧客の推定ラベルはどこで確認できますか？

確認したアプリは、顧客タグとcustom.genderの顧客メタフィールドに書き込みます。これらの値を基にセグメントを作成する前に、インストール済みのアプリとサンプルの顧客を確認してください。

gender_nullは何を意味しますか？

確認したネイティブアプリにおける未解決のラベルを表します。値をmaleやfemaleに変換するのではなく、その顧客を不明なグループに入れておいてください。

顧客の名前を変更せずに残すことはできますか？

欠けている名前の補完設定は、性別の処理とは別に確認してください。メールアドレスから導き出した候補でアプリに欠けている名前を補完させたい場合にのみ、有効にしてください。

出典とドキュメント

このガイドの最終確認日は2026年9月29日です。インストール方法は各プラットフォームのドキュメントで確認してください。V2連携を別途構築する場合は、以下のAPIドキュメントを使用してください。