Disponible avec une licence Business Analyst.
Résumé
Calcule le taux de pénétration en fonction des données clients au sein d'une zone.
Utilisation
La référence spatiale de la classe d'entités en sortie sera la même que celle de la couche qui permet de calculer le taux de pénétration.
La couche permettant de calculer le taux de pénétration doit être une couche de zones de chalandise ou être composée de données Business Analyst.
La couche de clients doit être une classe d'entités ponctuelles.
Dans la plupart des cas, la couche d'entités en entrée Couche de clients sera une couche de clients Business Analyst.
Lors du calcul du taux de pénétration, les pourcentages finaux découlent directement du nombre de clients utilisés dans l'outil. Si vous comparez le taux de pénétration de vos clients (en vous basant sur 1 000 clients) dans une grande agglomération à la population totale, le taux de pénétration (pourcentage) sera très faible. Ces pourcentages constituent toutefois un outil précieux si l'on prend en compte le marché que vous tentez de pénétrer.
Vous pouvez utiliser cet outil avec les zones de chalandise pour calculer les performances et le taux de pénétration des zones de chalandise de vos points de vente. Dans ce cas, définissez le paramètre Couche pour le calcul du taux de pénétration sur votre couche de zones de chalandise.
Vous pouvez également calculer le taux de pénétration en fonction d'un champ de pondération dans la couche de clients au lieu du nombre de clients. Par exemple, vous pouvez calculer le taux de pénétration en fonction des ventes totales par ménage pour chaque code postal.
Lorsque vous utilisez cet outil dans Python, les paramètres MarketPenetrationTMCField (Champ de potentiel de marché), InputGeographyLevel (Niveau géographique) et MarketPenetrationTMCSummarization (Champ de récapitulatif) ne sont pas facultatifs, mais ils peuvent être ignorés en attribuant la valeur # aux paramètres que vous ne souhaitez pas configurer.
Syntaxe
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})| Paramètre | Explication | Type de données |
MarketPenetrationLayer | Classe d'entités en entrée utilisée pour calculer les valeurs du taux de pénétration. | Feature Layer |
MarketPenetrationAreaID | Champ ID unique dans la couche du taux de pénétration. | Field |
IN_MP_AREA_DESCR | Champ utilisé pour décrire ou nommer chaque entité dans la couche du taux de pénétration. | Field |
CustomerLayer | Classe d'entités en entrée (généralement une couche de clients) qui sera utilisée pour déterminer le taux de pénétration. | Feature Layer |
MarketPenetrationTMCType | Méthode qui sera utilisée pour calculer les valeurs du taux de pénétration.
| String |
OutputFeatureClass | Classe d'entités devant contenir les entités du taux de pénétration. | Feature Class |
MarketPenetrationUseSelectedMPAreas (Facultatif) | Entités utilisées pour calculer le taux de pénétration.
| Boolean |
IN_MP_STORE_ID | Identifiant unique associé à chaque point de vente. | Field |
UseSelectedCustomers (Facultatif) | Entités de la couche de clients permettant de calculer les valeurs du taux de pénétration.
| Boolean |
CustomerWeightField (Facultatif) | Utilise un champ de pondération dans la couche de clients au lieu du nombre de clients pour calculer les valeurs du taux de pénétration. Par exemple, vous pouvez calculer le taux de pénétration en fonction des ventes totales par ménage pour chaque code postal. | Field |
MarketPenetrationTMCField (Facultatif) | Champ attributaire contenant les valeurs du calcul du taux de pénétration. | Field |
InputGeographyLevel (Facultatif) | Niveau géographique contenant le nombre de marchés pour le taux de pénétration. | Feature Layer |
MarketPenetrationTMCSummarization (Facultatif) | Attribut qui servira à calculer le nombre total de marchés dans le niveau géographique standard. | Field |
IN_CL_STORE_ID (Facultatif) | ID unique servant de liaison entre le fichier des clients et le fichier des points de vente. | Field |
ReportTitle (Facultatif) | Titre du rapport. | String |
MarketPenetrationReportDirectory (Facultatif) | Le rapport est créé dans ce dossier en sortie. | Folder |
ReportFormats [ReportFormat,...,...] (Facultatif) | Un ou plusieurs formats dans lesquels le rapport sera généré. Si vous utilisez l'appel de fonction Python, entrez les valeurs sous forme de chaîne au format suivant : "PremierFormat; DeuxièmeFormat; TroisièmeFormat", etc. Par exemple : "html;pdf;s.xlsx;s.xml;xlsx" (Une chaîne des noms de format souhaités délimités par des points-virgules.)
| String |
CreateReport (Facultatif) | Génère un rapport.
| Boolean |
Exemple de code
Exemple d'utilisation du script MarketPenetration (script autonome)
# 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")
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Requiert Business Analyst
- Standard: Requiert Business Analyst
- Advanced: Requiert Business Analyst