Business Analyst ライセンスで利用できます。
概要
商圏内の顧客データに基づいて市場占有率を算出します。
使用法
出力フィーチャクラスの空間参照は、市場占有率を算出するためのレイヤーと同じになります。
市場占有率の計算には、Business Analyst データまたは商圏レイヤーを使用します。
顧客レイヤーをポイント フィーチャクラスにする必要があります。
ほとんどの場合、顧客レイヤーの入力フィーチャ レイヤーは Business Analyst の顧客レイヤーになります。
市場占有率を算出する場合は、最終的なパーセンテージはツールで使用されている顧客数の直接的な結果になります。大都市圏に居住する 1,000 人の顧客に基づく顧客の占有率を総人口と比較すると、非常に低い市場占有率が示されます。占有対象の市場を考慮する場合には、この比率が重要になります。
このツールを商圏と組み合わせて使用すると、店舗商圏の業績と市場占有率を算出することができます。この場合は、[市場占有率の計算に使用するレイヤー] パラメーターを自社の商圏レイヤーに設定します。
必要に応じて、顧客数ではなく、顧客レイヤー内の重み付けフィールドに基づいて市場占有率を算出できます。たとえば、郵便番号ごとに 1 世帯あたりの合計売上高に基づいて市場占有率を算出できます。
このツールを Python 内で使用する場合、MarketPenetrationTMCField (市場総数フィールド)、InputGeographyLevel (区画レベル)、および MarketPenetrationTMCSummarization (集計フィールド) パラメーターはオプションではありませんが、これらのパラメーターのうち、設定しないパラメーターに # 値を指定して除外することができます。
構文
arcpy.ba.MarketPenetration(MarketPenetrationLayer, MarketPenetrationAreaID, IN_MP_AREA_DESCR, CustomerLayer, MarketPenetrationTMCType, OutputFeatureClass, {MarketPenetrationUseSelectedMPAreas}, IN_MP_STORE_ID, {UseSelectedCustomers}, {CustomerWeightField}, {MarketPenetrationTMCField}, {InputGeographyLevel}, {MarketPenetrationTMCSummarization}, {IN_CL_STORE_ID}, {ReportTitle}, {MarketPenetrationReportDirectory}, {ReportFormats}, {CreateReport})
パラメーター | 説明 | データ タイプ |
MarketPenetrationLayer | 市場占有率の値の計算に使用される入力フィーチャクラス | Feature Layer |
MarketPenetrationAreaID | 市場占有率レイヤー内でユニークな ID フィールド | Field |
IN_MP_AREA_DESCR | 市場占有率レイヤー内の各フィーチャの説明または名前を入力するフィールド | Field |
CustomerLayer | 市場占有率の計算に使用される入力フィーチャクラス (通常は顧客レイヤー) | Feature Layer |
MarketPenetrationTMCType | 市場占有率の値の計算に使用する方法
| String |
OutputFeatureClass | 市場占有率フィーチャが格納されるフィーチャクラス | Feature Class |
MarketPenetrationUseSelectedMPAreas (オプション) | 市場占有率の計算に使用されるフィーチャ
| Boolean |
IN_MP_STORE_ID | 各店舗に一意の ID | Field |
UseSelectedCustomers (オプション) | 市場占有率カウントの計算に使用される顧客レイヤーのフィーチャ
| Boolean |
CustomerWeightField (オプション) | 顧客数ではなく、顧客レイヤー内の重み付けフィールドを使用して、市場占有率の値を算出します。たとえば、郵便番号ごとに 1 世帯あたりの合計売上高に基づいて市場占有率を算出できます。 | Field |
MarketPenetrationTMCField (オプション) | 市場占有率計算の値が格納される属性フィールド | Field |
InputGeographyLevel (オプション) | 市場占有率の市場数が格納される区画レベル | Feature Layer |
MarketPenetrationTMCSummarization (オプション) | 標準の区画レベルから市場総数を算出する場合に使用される属性 | Field |
IN_CL_STORE_ID (オプション) | 顧客ファイルと店舗ファイルを関連付ける一意の ID | Field |
ReportTitle (オプション) | レポートのタイトル | String |
MarketPenetrationReportDirectory (オプション) | この出力フォルダーにレポートが作成されます。 | Folder |
ReportFormats [ReportFormat,...,...] (オプション) | レポートの出力先の 1 つまたは複数の形式 Python 関数呼び出しを使用する場合は、"FirstFormat; SecondFormat; ThirdFormat; ..." の形式で値を文字列として入力します。例: "html;pdf;s.xlsx;s.xml;xlsx" (セミコロンで区切られた希望の出力形式名の文字列)
| String |
CreateReport (オプション) | レポートを生成します。
| Boolean |
コードのサンプル
MarketPenetration (市場占有率) の例 (スタンドアロン スクリプト)
# Name: MarketPenetration.py
# Description: Calculates how well customers in the San Francisco penetrate the households in that market.
# Author: Esri
# Import system modules
import arcview
import arcpy
arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
# Acquire extension license
arcpy.CheckOutExtension("Business")
# Define input and output parameters for the Market Penetration tool
MarketPenetrationLayer = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
MarketPenetrationAreaID="ID"
IN_MP_AREA_DESCR="NAME"
CustomerLayer = "C:/temp/sf_cust.shp"
MarketPenetrationTMCType = "In the layer attribute table"
OutputFeatureClass = "C:/temp/Marketpenetration.shp"
MarketPenetrationUseSelectedMPAreas = "false"
IN_MP_STORE_ID = "STATE_NAME"
UseSelectedCustomers = "false"
CustomerWeightField = ""
IN_CL_STORE_ID = ""
MarketPenetrationTMCField = "TOTHH_CY"
OutputFeatureClass = "C:/temp/Marketpenetration.shp"
InputGeographyLevel = ""
MarketPenetrationTMCSummarization = ""
ReportTitle = "Determine Market Penetration"
MarketPenetrationReportDirectory = "C:/My Output Data/Projects/Default Project/Reports/MarketPenetration"
ReportFormats = "pdf;xlsx;zip;s.xlsx"
# Create a Market Penetration output
arcpy.MarketPenetration_ba(MarketPenetrationLayer,
MarketPenetrationAreaID,
IN_MP_AREA_DESCR,
CustomerLayer,
MarketPenetrationTMCType,
OutputFeatureClass,
MarketPenetrationUseSelectedMPAreas,
IN_MP_STORE_ID,
UseSelectedCustomers,
CustomerWeightField,
IN_CL_STORE_ID,
MarketPenetrationTMCField,
OutputFeatureClass,
InputGeographyLevel,
MarketPenetrationTMCSummarization,
ReportTitle,
MarketPenetrationReportDirectory,
ReportFormats)
# Release extension license
arcpy.CheckInExtension("Business")
環境
このツールは、ジオプロセシング環境を使用しません。
ライセンス情報
- Basic: 次のものが必要 Business Analyst
- Standard: 次のものが必要 Business Analyst
- Advanced: 次のものが必要 Business Analyst