Richtlinien für Power BI-VisualsGuidelines for Power BI visuals

Bevor Sie Ihr Power BI-Visual in Microsoft AppSource veröffentlichen, damit andere es verwenden können, stellen Sie sicher, dass Sie die Richtlinien befolgen, um Ihren Benutzern eine hohe Benutzerfreundlichkeit zu bieten.Before you publish your Power BI visual to Microsoft AppSource for others to discover and use, make sure that you follow the guidelines to create a great experience for your users.

Power BI-Visuals mit zusätzlichen KäufenPower BI visuals with additional purchases

Sie können kostenlose Power BI-Visuals beim Marketplace (Microsoft AppSource) einreichen.You can submit Power BI visuals that are free to the Marketplace (Microsoft AppSource). Darüber hinaus können Sie bei Microsoft AppSource Power BI-Visuals anbieten, die mit einer Preisauszeichnung „Möglicherweise sind zusätzliche Käufe erforderlich“ versehen sind.You can also submit to Microsoft AppSource Power BI visuals that have an "additional purchase may be required" price tag. Power BI-Visuals mit der Auszeichnung „Möglicherweise sind zusätzliche Käufe erforderlich“ sind ähnlich wie IAP-Add-Ins (In-App Purchase, Kauf in der App) im Office Store."Additional purchase may be required" Power BI visuals, are similar to in-app purchase (IAP) add-ins in the Office Store.

Analog zu einem kostenlosen Power BI-Visual kann auch ein IAP Power BI-Visual zertifiziert werden.Similarly to a free Power BI visual, an IAP Power BI visual can also be certified. Bevor Sie ein IAP Power BI-Visual zur Zertifizierung einreichen, stellen Sie sicher, dass den Zertifizierungsanforderungen entspricht.Before submitting your IAP Power BI visual for certification, make sure it complies with the certification requirements.

Was ist ein Power BI-Visual mit In-App-Käufen?What is a Power BI visual with IAP features?

Ein IAP Power BI-Visual ist ein kostenloses Visual, das kostenlose Features bietet.An IAP Power BI visual is a free visual that offers free features. Ein solches Visual verfügt auch über einige erweiterte Features, für die zusätzliche Gebühren anfallen können.It also has some advanced features for which extra charges may be applied. Entwickler müssen die Benutzer in der Beschreibung des Power BI-Visuals über die Features informieren, für deren Funktionsweise möglicherweise zusätzliche Komponenten erworben werden müssen.In the Power BI visual's description, developers must notify users about the features that require additional purchases to operate. Derzeit bietet Microsoft keine nativen APIs an, den Erwerb von Apps und Add-Ins unterstützen.Currently, Microsoft does not provide native APIs to support the purchase of apps and add-ins.

Entwickler müssen ein Zahlungssystem von einem Drittanbieter für diese Käufe verwenden.Developers may use any third-party payment system for these purchases. Weitere Informationen finden Sie in den Richtlinien für unseren Store.For more information, see our store policy.

Wichtig

Wenn Sie Ihr Power BI-Visual von „Kostenlos“ zu „Möglicherweise sind zusätzliche Käufe erforderlich“ aktualisieren, müssen den Benutzern im gleichen Umfang kostenlose Funktionen zur Verfügung stehen wie vor der Aktualisierung.If you update your Power BI visual from free to "Additional purchase may be required", users must receive the same level of free functionality as before the update. Sie können zusätzlich zu den vorhandenen kostenlosen Features optionale erweiterte Features hinzufügen, die kostenpflichtig sind.You may add optional advanced paid features in addition to the existing free features.

WasserzeichenWatermarks

Sie können Wasserzeichen verwenden, damit Kunden die erweiterten IAP-Features weiterhin verwenden können, ohne zu bezahlen.You can use watermarks so that customers continue using the IAP advanced features without paying.

Wasserzeichen können verwendet werden, um die gesamte Funktionalität des Power BI-Visuals vorzustellen, bevor ein Kauf erfolgt.Watermarks can be used to showcase the full functionality of the Power BI visual, before a purchase is made.

  • Wasserzeichen können nur in kostenpflichtigen Features verwendet werden, die ohne gültige Lizenz verwendet werden.Watermarks may only be used on paid features that are used without a valid license.
  • Wasserzeichen sind in Power BI-Visuals mit der Preisauszeichnung kostenlos nicht zulässig.Watermarks are not allowed in Power BI visuals with a free price tag.
  • Wasserzeichen sind in IAP-Visuals nicht zulässig, wenn der Benutzer kostenlose Funktionen verwendet.Watermarks are not allowed in IAP visuals, when the user uses free features.

PopupfensterPop-up window

Sie können ein Popupfenster verwenden, um den Lizenzerwerb zu erläutern, wenn eine ungültige (oder abgelaufene) Lizenz mit Ihrem Power BI IAP-Visual verwendet wird.You can use a pop-up window to explain how to purchase a license, when an invalid (or expired) license is used with your Power BI IAP visual.

EinreichungsprozessSubmission process

Führen Sie den Übermittlungsprozess aus. Navigieren Sie dann zur Registerkarte Produkteinrichtung, und aktivieren Sie das Kontrollkästchen Mein Produkt erfordert den Erwerb eines Diensts.Follow the submission process and then navigate to the Product setup tab and check the My product requires the purchase of a service check box.

Sobald das Power BI-Visual überprüft und genehmigt wurde, zeigt das Microsoft AppSource-Listing für das IAP Power BI-Visual den Hinweis „Möglicherweise müssen weitere Komponenten erworben werden“ in den Preisoptionen an.After the Power BI visual is validated and approved, the Microsoft AppSource listing for the IAP Power BI visual states, "Additional purchase may be required" under the pricing options.

KontextmenüContext menu

Das Kontextmenü ist das Rechtsklickmenü, das angezeigt wird, wenn der Benutzer mit der Maus über ein Visual fährt.Context menu is the right-click menu that is displayed when the user is hovering over a visual. Alle Power BI-Visuals sollten das Kontextmenü für eine einheitliche Darstellung aktivieren.All Power BI visuals should enable the context menu to bring a unified experience. Lesen Sie diesen Artikel, um zu erfahren, wie Sie ein Kontextmenü hinzufügen.Please check this article to learn how to add a context menu.

Ein Screenshot eines visuellen Power BI-Kontextmenüs.A screenshot of a Power BI visual context menu.

In diesem Abschnitt werden die Spezifikationen zum Hinzufügen von kommerziellen Logos in Power BI-Visuals erläutert.This section describes the specifications for adding commercial logos in Power BI visuals. Kommerzielle Logos sind nicht obligatorisch.Commercial logos are not mandatory. Wenn sie hinzugefügt werden, müssen Sie diesen Richtlinien entsprechen.If added they must follow these guidelines.

Hinweis

  • Im Rahmen dieses Artikels bezeichnet der Ausdruck „kommerzielles Logo“ beliebige kommerzielle Firmenlogos, wie in den Abbildungen unten beschrieben.In this article, 'commercial logo' refers to any commercial company icon as described in the pictures below.
  • Das kommerzielle Logo von Microsoft wird in diesem Artikel nur als Beispiel verwendet.The Microsoft commercial logo is used in this article only as an example. Verwenden Sie für Ihr Power BI-Visual Ihr eigenes kommerzielles Logo.Use your own commercial logo with your Power BI visual.

Wichtig

Kommerzielle Logos sind nur im Bearbeitungsmodus zulässig.Commercial logos are allowed in edit mode only. Kommerzielle Logos können im Anzeigemodus nicht dargestellt werden.Commercial logos can't be displayed in view mode.

Typ des kommerziellen LogosCommercial logo type

Es gibt drei Arten von kommerziellen Logos:There are three types of commercial logos:

  • Logo: Ein Logo besteht aus zwei Elementen, die fest aneinander gebunden sind, einem Symbol und einem Namen.Logo - A logo is comprised of two elements locked together, an icon and a name.

    Ein Screenshot des Microsoft-Logos.

  • Symbol:-eine Grafik ohne Text.Symbol - A graphic without any text.

    Ein Screenshot des Microsoft-Symbols.

  • Logoschrift-ein Logo ohne -Symbol, das nur aus Text besteht.Logotype - A logo without an icon, comprised only from text.

    Ein Screenshot des Microsoft-Logos ohne Symbol.

Farbe des kommerziellen LogosCommercial logo color

Wenn ein kommerzielles Logo verwendet wird, muss die Farbe des Logos grau sein (Hexadezimal-Farbcode #C8C8C8).When using a commercial logo, the color of the logo must be grey (hex color #C8C8C8). Fügen Sie dem kommerziellen Logo keine Effekte wie Farbverläufe hinzu.Don't add effects such as gradients to the commercial logo.

  • LogoLogo

    Ein Screenshot des Microsoft-Logos in Grau.

  • Symbol:-eine Grafik ohne Text.Symbol - A graphic without any text.

    Ein Screenshot des Microsoft-Symbols in Grau.

  • Logoschrift-ein Logo ohne -Symbol, das nur aus Text besteht.Logotype - A logo without an icon, comprised only from text.

    Ein Screenshot des Microsoft-Logos ohne Symbol in Grau.

Tipp

  • Wenn Ihr Power BI-Visual eine Grafik enthält, fügen Sie Ihrem Logo ggf. einen weißen Hintergrund hinzu (mit Rändern in der Größe von 10 px).If your Power BI visual contains a graphic, consider adding a white background with 10 px margins to your logo.
  • Fügen Sie für Ihr Logo ggf. einen Schlagschatten hinzu (Durchlässigkeit in schwarz von 30 %).Consider adding dropshadow to your logo (30% opacity black).

Größe des kommerziellen LogosCommercial logo size

Für ein Power BI-Visual sind zwei kommerzielle Logos erforderlich, eins für große und eins für kleine Kacheln.A Power BI visual requires two commercial logos, one for large tiles and one for small tiles. Platzieren Sie das Logo in einem Begrenzungsrahmen, der sich in der oberen oder unteren rechten Ecke befindet und Ränder von 4 px Breite aufweist.Place the logo within a bounding box placed at the top or bottom right corner, with 4 px margins.

In der folgenden Tabelle werden die Größenaspekte von Power BI-Visuals beschrieben.The following table describes the size considerations for Power BI visuals.

EinstellungenSettings Kleines Power BI-VisualSmall Power BI visual Großes Power BI-VisualLarge Power BI visual
LogobreiteLogo width Bis zu 240 pxUp to 240 px Größer als 240 pxGreater than 240 px
LogohöheLogo height Bis zu 160 pxUp to 160 px Größer als 160 pxGreater than 160 px
Größe des BegrenzungsrahmensBounding box size 40 x 15 px40 x 15 px 101 x 30 px101 x 30 px
Beispiel für ein kommerzielles LogoCommercial logo example Ein Screenshot der kleinen Version des kommerziellen Logos von Microsoft. Ein Screenshot des kommerziellen Logos von Microsoft.
Beispiel für BegrenzungsrahmenBounding box example Ein Screenshot der Dimensionen eines kleinen Logos. Ein Screenshot der Dimensionen eines großen Logos.

Verhalten von kommerziellen LogosCommercial logo behavior

Kommerzielle Logos sind nur im Bearbeitungsmodus zulässig.Commercial logos are only allowed in edit mode. Wenn Sie darauf klicken, darf ein kommerzielles Logo nur die folgende Funktionalität aufweisen:When clicked, a commercial logo can only include the following functionality:

  • Durch Klicken auf das Logo erfolgt eine Umleitung auf Ihre Website.Clicking the commercial logo redirects to your website.

  • Durch Klicken auf das kommerzielle Logo wird ein Popupfenster mit zusätzlichen Informationen geöffnet.Clicking the commercial logo opens a popup window with additional information. Das Popupfenster sollte in zwei Abschnitte unterteilt sein:The popup window should be divided into two sections:

    • Einen Marketingbereich, der das kommerzielle Logo, ein Visual und Marktbewertungen enthalten kann.A marketing area which can include the the commercial logo, a visual and market ratings.
    • Einen Informationsbereich, der Informationen und Links enthalten kann.An information area which can include information and links.

Dinge, die Sie vermeiden solltenThings to avoid

  • Kommerzielle Logos können im Anzeigemodus nicht dargestellt werden.Commercial logos cannot be displayed in view mode.

  • Ein animiertes kommerzielles Logo kann eine Animation bis zu fünf Sekunden lang anzeigen.An animated commercial logo can display animation for up to five seconds.

  • Wenn Ihr Power BI-Visual im Lesemodus informative Symbole (i) beinhaltet, sollten diese in Farbe, Größe und Positionierung dem kommerziellen Logo entsprechen, wie oben beschrieben.If your Power BI visual includes informative icons (i) in reading mode, they should comply to the color, size, and location of the commercial logo, as described above.

  • Vermeiden Sie ein buntes oder schwarzes kommerzielles Logo.Avoid a colorful or a black commercial logo. Das kommerzielle Logo muss grau sein (hexadezimaler Farbcode #C8C8C8).The commercial logo must be grey (hex color #C8C8C8).

    Ein Screenshot eines nicht autorisierten farbigen Microsoft-Logos. Ein Screenshot eines nicht autorisierten schwarzen Microsoft-Logos.

  • Ein kommerzielles Logo mit Effekten wie Farbverläufen oder starken Schatten.A commercial logo with effects such as gradients or strong shadows.

    Ein Screenshot eines Beispiels für einen nicht autorisierten Stil des Microsoft-Logos.

Bewährte MethodenBest practices

Wenn Sie ein Power BI-Visual veröffentlichen, sollten Sie die folgenden Empfehlungen beachten, um Ihren Benutzern ein gutes Erlebnis zu bieten.When publishing a Power BI visual, consider the following recommendations in order to provide users a great experience.

Startseite für VisualsVisual landing page

Verwenden Sie die Startseite, um den Benutzern zu verdeutlichen, wie sie Power BI-Visuals verwenden und wo Lizenzen erworben werden können.Use the landing page to clarify to users how they can use your Power BI visual and where to purchase the license. Fügen Sie keine Videos ein, die automatisch abgespielt werden.Don't include videos that are automatically triggered. Fügen Sie nur Inhalte hinzu, die das Benutzererlebnis verbessern, z.B. Informationen oder Links zu den Details für den Erwerb von Lizenzen und zum Einsatz von In-App-Features.Add only material that helps improve the user's experience, such as information or links to license purchasing details and how to use IAP features.

Lizenzschlüssel und TokenLicense key and token

Fügen Sie Felder für Lizenzschlüssel oder Token im oberen Teil des Formatierungsbereichs hinzu, sodass Benutzer diese leicht finden können.For the user's convenience, add the license key or token related fields at the top of the format pane.

Häufig gestellte FragenFAQ

Weitere Informationen zu Power BI-Visuals finden Sie in den häufig gestellten Fragen zu Power BI-Visuals mit zusätzlichen Käufen.For more information about Power BI visuals, see Frequently asked questions about Power BI visuals with additional purchases.

Nächste SchritteNext steps

Erfahren Sie, wie Sie ein Power BI-Visual in Microsoft AppSource veröffentlichen, damit es von anderen gefunden und verwendet werden kann.Learn how you can publish your Power BI visual to Microsoft AppSource for others to discover and use.