BFAN-App

==Vorbemerkungen==
Zur Saison 2020/21 starten die Volleyball Bundesliga und bFAN eine Kooperation zum Betrieb von Fan-Apps bei den Vereinen der 1. Bundesliga. 
==Kooperation und nicht-technische Informationen==
===Präsentation der App / Anbieter bFAN===
*
*
===Kommunikation mit bFAN===
* Die Kommunikation mit dem Projektmanagement und Support von bFAN erfolgt ausschlißelich über Slack in englischer Sprache
* Bitte installieren Sie sich dazu die Slack-Applikation auf Ihrem Computer. Die Zugangsdaten erhalten Sie auf Anfrage vom bFAN-Support.
* Es gibt im Workspace auch einen deutschsprachigen Channel #allbundesligavolleyclubs zum Erfahrungsaustausch zwischen den Vereinen.
===Vertrag und Abrechnung===
* Die VBL hat mit bFAN einen Rahmenvertrag abgeschlossen. Gegenstand dieses Rahmenvertrags sind
** Preis-/Lizenzmodell auf Grundlage der Mindestzahl teilnehmender Vereine
** Sonderkündigungsrecht für Vereine bei Ausscheiden aus der VBL (Abstieg, Insolvenz)
** Anbindung SAMS-API
** Durchführung von Workshops
* Jeder Verein schließt mit bFAN einen individuellen Vertrag mit dreijähriger Laufzeit.
* Die Rechnungsstellung durch bFAN an die Vereine erfolgt jährlich; erstmals erfolgt eine Rechnungsstellung beim Go-live der App.
* Soweit die VBL den Vereinen eine Finanzierung aus den Medienrechteerlösen gewährt, überweist die VBL den Vereinen das Geld parallel mit der Rechnungsstellung von bFAN.
* Neben der Lizenzgebühr an bFAN sind die Registrierungsgebühren für die Accounts bei Google (25 US$) and Apple (99€) separat zu zahlen. Weitere Kosten fallen nicht an.
==Roadmap bis zum Go-Live==
*§ Step 1: The creation of the Google and Apple stores is handled by bFAN Sports but we will need your assistance at some point for the payment of the accounts.
*§ Step 2: bFAN provides the backend from which you will be able to manage all the content related to your app
*§ Step 3: The club gets access to the backend platform and their test application. This test application will be made available for download for the club via an email invitation sent by bFAN Sports. The instructions must then be followed on the smartphone and the Firebase app and the non-public club app installed. This test app will be used to set up the club’s application until it is deemed ready to be launched in the stores.
*§ Note: If no email arrives after several hours, you should contact bFAN. Then another mail is triggered.
*§ Step 4: The club implement the basic graphics and information in their test application from their backend
*§ Step 5: Changes are incorporated and checked in the app. The adjustment usually takes no longer than a few seconds.
*§ Note 1: If there is no change after a few seconds, the club app should be restarted.
*§ Note 2: Content looks different on Android and iOS. Only you can see the current status of the club app. No external person can see the current status of the app.
*§ Note: Additional admins can be added in the backend under Settings then Admins.
*§ Step 7: When you consider your app to be ready for launch, please inform your bFAN Sports contact about it, he will double check the app and approve it for public launch.
*§ Note: Screenshots (homepage, social media, roster, calendar, news) must be made ready for bFAN Sports tech team to be able to take the screenshots which will be used to present your app in the stores. A short and a long description for the presentation of your app in the stores must also be sent to bFAN beforehand. Please, make sure that you have reviewed all the app’s content (name of the app, logos, descriptions, name of the club etc.) beforehand as any changes to those information could take up to a few days.
*§ Step 8: Your app is submitted for review by the Google and Apple stores by bFAN Sports. The review usually takes between 2 to 14 days. Please note that Apple and Google determine the schedule here and thus bFAN Sports has no power over the length of this review.
*§ Step 8: Once the app is approved by the stores it can be made available to the public in a matter of hours.
*§ Step 9: The fans have access to the app by downloading it from the stores.
==Administration der App außerhalb des bFAN-Backends==
===Vorbereitungen auf der Vereinsseite===
* Richten Sie (optional) folgende Services/Accounts ein:
** Facebook
** Instagram
** Twitter
** Youtube
* Ihre Homepage sollte einen RSS-Newsfeed ausliefern, damit Sie die News in der App und auf Ihrer Homepage nicht einzeln pflegen müssen.
** RSS Feed Specifications
*** RSS is the method we use to retrieve automatically new articles from your website. That way you won’t have to put every single article by hand into the bFAN console, it will be automated. 
***RSS specifications: ​https://en.wikipedia.org/wiki/RSS 
***To do so, you need to add a new RSS feed into the bFan console (News -> + Add rss feed). An URL will be required. This URL will be given by your Website provider and should look something like this: ​https://www.feedforall.com/sample.xml 
***Your articles are represented using XML which allow us to programmatically read them and get the proper data. See XML specifications: ​https://en.wikipedia.org/wiki/XML 
***bFAN Sports RSS system supports RSS 2.0 version. Make sure to generate your RSS feed with the right version. 
***Even if the RSS feed system is automated, it won’t instant. There might be a delay between when the article is posted and when the article is available into your mobile application. 
***Our system checks if there are new articles every 15 minutes, so 15 minutes is the maximum delay you might encounter between the publication and its appearance on the bFAN Sports platform.
 
***Important​: 
****If you are publishing an article, be careful of the publishing time. If two articles have the exact same publish time, they will override each other, even across different RSS feeds. 
****There cannot be more than one article at the same time. If you face this issue, shift one of
* Richten Sie folgende Unterseiten auf Ihrer eigenen Homepage ein. Die Seiten sollten verteckt sein, d.h. nicht über das Menü der Homepage aufrufbar sein.
** Datenschutzerklärung für App-Nutzung
** ggf. Nutzungsbedingungen
===Anbindung der SAMS-Schnittstelle===
* Ziel ist es, so viele Inhalte wie möglich aus SAMS in die App zu übernehmen, so dass der zusätzliche Administrationsaufwand in der App für die Vereine möglichst gering gehalten werden kann.
* Zum weiteren Vorgehen und den vertraglichen Vereinbarungen von VBL und bFAN zur Schnittstellenanbindung folgender Status:
** umgesetzt: Spiele/Events werden über API synchronisiert, ebenso Endstand des Spiels nach Spielende - Vertragsumfang und bezahlt
*** Anleitung zur Synchronisierung, ohne dass Bestandsdaten überschrieben werden
** Prio 2: Anbindung Live-Ticker für Einzelspiel - bislang keine vertragliche Vereinbarung dazu, aber gleiches Verständnis, dass dies ein "must have" ist
** Prio 3: Spielplan und Tabelle der Liga werden derzeit über externe Links eingefügt; Menüpunkte hierfür muss jeder Verein im Backend anlegen (siehe unten); bFAN macht Angebot für native Einbindung über API - bislang kein Vertragsumfang
** Prio 4: Mannschaftsliste wird über API synchronisiert - Vertragsumfang und bezahlt, Umsetzung jedoch erst für 2021/22 vereinbart; in Saison 2020/21 einmalige Pflege der Daten
** ohne Prio: Einbindung Spielstatistiken, Live-Statistiken sind bislang weder Vertragsgegenstand noch technisch projektiert
* Diese Liste bietet eine Übersicht der Datenfelder und deren Datenherkunft: 
===Nutzungsbedingungen, Datenschutzerklärung, Impressum===
* Der Verein ist Anbieter der App; bFAN ist nur technischer Dienstleister. Daher ist der Verein verantwortlich für Nutzungsbedingungen, Datenschutzerklärung und Impressum.
* Die VBL hat auf Grundlage der englischsprachigen Vorlagen von bFAN deutschte Texte für Nutzungsbedingungen und Datenschutzerklärung erstellt.
* Die Texte sind auf der eigenen Homepage des Vereins einzubinden (siehe oben) und im Backend der App zu verlinken (siehe unten).
**
**
* Es ist vorgesehen, dass die Texte zukünftig native in der App eingebunden und im dortigen Backend administriert werden.
* Weiterhin beabsichtigt die VBL, zur Saison 2021/22 eine Neufassung zur Verfügung zu stellen.
==Zentrale Administration der App im bFAN-Backend==
* Folgende Daten und Einstellungen werden zentral administriert und sind nicht für Vereine zugänglich:
** deutsche Sprachdatei für Systemtexte und Funktionen in der App --> Fehlermeldungen bitte an VBL-Support
** Stammdaten
*** Saison (aus SAMS)
*** Wettbewerbe/Ligen (aus SAMS)
*** Spielplan der offiziellen Wettbewerbe
*** Vereine (aus SAMS)
**** Teamnamen
**** Vereinslogos (montiert auf weißem Hintergrund, wie von VBL-Homepage bekannt)
** Spielhallen (aus SAMS)
==Administration der App durch Verein im bFAN-Backend==
===Übersicht===
* Nachfolgend geht es insbesondere darum, spezielle Hinweise und Konventionen für die Vereine der VBL zu dokumentieren.
* Dies ist kein vollständiges Handbuch für das bFAN-Backend, das im Übrigen weitgehend selbsterklärend ist. Zusätzlich gibt es eine (französischsprachige) Hilfeseite bei bFAN.
* Spezielle Fragen richten Sie bitte direkt an den bFAN-Support.
* Die Administration der APP für Android und IOS erfolgt im identischen Backend. Allerdings ist das Verhalten der App und die Darstellung der Inhalte in den verschiedenen Anwendungen nicht durchgängig identisch. 
* Änderungen an der App müssen daher von den Vereinen immer in beiden Anwendungen getestet werden.
===Settings===
====Organization====
*Hier werden die Kontaktdaten der Geschäftsstelle und der zuständigen Mitarbeiter:innen eingefügt. Dabei sollte der Standard-Kontakt von bFan (support@bfan...) gegen eine aktuelle Vereinsadresse ausgetauscht werden.
=====Information & Settings=====
=====Links=====
* An dieser Stelle werden externe Standard-Links verwaltet, die an verschiedenen Stellen der App verwendet werden, z.B. im Menü
* Diese Standard-Link-Liste stammt aus einer früheren Entwicklungsphase der App; zwischenzeitlich können Links auch direkt an den indviduellen Menüpunkten verwaltet werden
* Erfassen Sie folgende Links:
** (1) Store URL: Webshop für Fanartikel
** (2) Ticketing URL: Webshop für Ticketverlauf oder Landingpage der Homepage mit Ticketinfos
** (3) Ranking URL: Links zur VBL-Homepage mit der aktuellen Bundesligatabelle; bitte Redirect nutzen:
*** https://www.volleyball-bundesliga.de/1blftabelle
*** https://www.volleyball-bundesliga.de/1blmtabelle
*** Beachten Sie hierzu - abweichend - auch untenstehende Empfehlung für einen individuellen Menüpunkt.
** (4) Terms und conditions URL: Nutzungsbedingungen, sofern abweichend von Standard (siehe Mustertext)
** (5) Privacy policy URL: Datenschutzerkärung (siehe Mustertext)
 700 px
=====Championships=====
* Aktivieren Sie die Wettbewerbe, in denen Ihre Mannschaft spielt.
 700 px
* Wettbewerbe der VBL sind mittels API angebunden; bitte ändern Sie nichts an den Einstellungen.
 500 px
* Weitere Wettbewerbe, z.B. Europacupwettbewerbe können durch den bFAN-Support angelegt werden.
====Styles====
*Die angezeigten ausgegrauten Kästchen (Platzhalter) für die Grafiken können mithilfe der ?-Buttons einem Ort in der zugeordnet werden. Der einfachste Weg ist, wenn eine markante Grafik jeweils an verschiedenen Orten in der App platziert wird. Dann wird der Ort am einfachsten visualisiert.
Die Farben werden von im HEX-Code verwendet. Für einen Transfer von RGB und CYMK reicht ein Konverter bei Google aus.
=====Branding=====
* Erfassen die Primär- und Sekundärfarbe Ihres Vereins.
* Erfassen Sie die Grafikdateien für Ihre App.
** Bitte beachten Sie, dass der Austausch der Bilder im mittleren Block eine neue Veröffentlichung der App erfordert.
=====Menus=====
* Gestalten Sie das Menü Ihrer App:
** Nutzen Sie Standard-Menüpunkte aus dem Angebot von bFAN.
** Erstellen Sie eigene Menüpunkte.
** Wollen Sie Menüpunkte temporär ein-/ausblenden, können Sie diese per Drag & Drop verschieben.
 700 px
* Fügen Sie folgende Menüpunkte in Ihr App-Menü ein:
** Tabelle
*** Es gibt zwar bereits einen Menüpunkt Tabelle in der Auswahlliste. Dieser greift auf die externe URL zurück, die in den Einstellungen hinterlegt ist.
*** Wir empfehlen, einen inividuellen Menüpunkt an dieser Stelle zu erstellen und bei diesem die Redirects (URL) und das VBL-Logo zu hinterlegen.
**** https://www.volleyball-bundesliga.de/1blftabelle
**** https://www.volleyball-bundesliga.de/1blmtabelle
*** Nutzen Sie folgende Logo-Datei: 
** Spielplan (empfohlen)
*** Hinterlegen Sie die Redirects (URL) der VBL-Homepage:
**** https://www.volleyball-bundesliga.de/1blfspielplan
**** https://www.volleyball-bundesliga.de/1blmspielplan
*** Nutzen Sie folgende Logo-Datei:
** VBL-Live-Ticker
*** Hinterlegen Sie die URL zum VBL Live-Ticker:
**** https://www.vbl-ticker.de
*** Nutzen Sie folgende Logo-Datei:
** Livestream
*** Hinterlegen Sie die URL der sporttotal-Homepage:
**** https://sporttotal.tv/volleyball
**** alternativ können Sie die Unterseiten der jeweiligen Ligen nutzen
*** Nutzen Sie folgende Logo-Datei: 
** optional: CEV Champions League oder andere EC-Wettbewerbe
 300 px
=====Homepage=====
* Gestalten Sie die Homepage Ihrer App:
** Nutzen Sie Standard-Böcke aus dem Angebot von bFAN.
** Erstellen Sie eigene Blöcke.
** Wollen Sie Blöcke temporär ein-/ausblenden, können Sie diese per Drag & Drop verschieben.
====My account====
====Admins====
====Integrations====
* Bitte erfassen Sie hier Ihre Social-Media-Accounts.
====Loyalty Program====
====Team Roster====
* In der Saison 2020/21 muss die Mannschaftsliste im Backend von bFAN manuell administriert werden. Es ist geplant, dass ab der Saison 2021/22 die Mannschaftsliste aus SAMS synchronisiert werden kann. Dazu sind neben der API-Anbindung auch Erweiterungen im SAMS-Backend erforderlich.
*Die Anordnung der Spieler*innen bzw. Positionen ist mithilfe der Nummerierung möglich. Dafür muss bei "Last Name" bzw. "Position" Zahl- Nachname oder Zahl- Position eingefügt werden wie z. B. 1- Müller oder 1-Außenangriff. Dann taucht diese Person bzw. Position an Stelle 1 auf.
* Bitte erfassen Sie die Mannschaftsliste Ihres Vereins.
 700 px
* Ergänzen Sie die Personenprofile.
 500 px
* Es bieten sich folgende Gruppierungen für eine übersichtliche Darstellung an:
 800 px
===Dashboard===
===Events===
====Eventliste erstellen und aktualisieren====
* Offzielle Spiele in VBL-Wettbewerben werden über die Schnittstelle aus SAMS angeliefert.
* Zur Einbindung und Synchroniserung der Spiele siehe bFAN-Guideline: 
 700 px
* Es wurden sm 23.09. alle Teamnamen und Logos in der Datenbank nochmals aktualisiert. Daher sind alle bislang angelegten Events nochmals zu synchronisieren.
** Langversion der Teamnamen (statt Kurznamen)
** kreisrunde Teamlogos auf weißem Hintergrund
====Einzelevent bearbeiten====
=====Live=====
=====Photos=====
=====Games=====
=====Informations=====
* Erfassen Sie die URL zum Livestream auf Sporttotal oder Sport1 und laden Sie das Logo des TV-Senders hoch.
** 
** 
* Erfassen Sie optional die URL zur Spielseite im Ticketshop.
 700 px
===Library===
*Hier können Bilder und Videos hochgeladen werden. 
*Eine Einbettung von anderen Inhalten von anderen Plattformen (YouTube, ….) ist nicht nativ möglich. 
*Die Erstellung einer neuen Kategorie mit einer Verlinkung zum Angebot auf dritten Seiten ist jedoch möglich. 
*Auch die Verwendung eines Links zu einem Inhalt in der Library ist nicht möglich. 
*Der Name der Kategorie "Mannschaftsfotos" und "Fan Fotos" kann nicht geändert werden. 
*Auch die Sortierung der Inhalte in Ordner ist nicht möglich.
===My Community===
*Hier sind die Informationen über alle angemeldeten Fans sichtbar. Darüber hinaus können die Mitglieder des Business-Club verwaltet sowie weitere Segmente bearbeitet werden.
===User===
*Avater:
**Die Änderung der Userbilder ist nicht möglich. Eine zukünftige Änderung wird angestrebt. Nur mit der Anmeldung über Facebook ist es möglich den eigenen Avatar von Facebook zu kopieren.
===Score===
*Falls der Score händisch durchgeführt werden muss, ist es wichtig zu wissen, dass nur innerhalb eines Satzes der Punktestand verändert werden kann. 
*Nachdem der Score des Satzes finalisiert ist, kann er nicht mehr verändert werden.
===Championships===
*Der Wettbewerb "Other" kann nicht versteckt werden.
===Games===
*Dieser Teil ist das Herzstück der Interaktion der App. Mit etwas Kreativität können hier Quizze, Polls, MVPs, Ergebnisvorhersagen und Verlosungen durchgeführt werden. Bei Quizzen können die Antwortmöglichkeiten als Text und als Text-Bild-Kombination angezeigt werden. Die Antwortmöglichkeiten können nach der Veröffentlichung bearbeitet werden. Die Antworten der Fans werden jedoch gelöscht sobald diese ersetzt wurden. Mithilfe der Zusatzfunktionen "Fullscreen" können die Fragen und Antworten extern außerhalb der App visualisiert werden wie z.B. im Foyer der Arena. Alle anderen Games funktionieren nach dem ähnlichen Prinzip. Wichtig zu wissen ist das die MVP-Bilder im Team Roster eingestellt werden. Die Funktion um Verlosungen durchzuführen zu können ist kostenpflichtig. Hinweis für Vorhersagen: Diese sind ab vier Tage vor dem Event verfügbar. Die nicht-volleyballspezifischen Ergebnisse können nicht eingegrenzt werden. Daher können Fans auch 9:7 tippen.
===Reward===
*Grundsätzlich kann entschieden werden, ob Belohnungen für Fans ausgeschüttet werden sollen oder nicht. Nur falls damit begonnen wird, könnte eine Beendigung des Belohnungssystem für Frustration bei den Fans sorgen. Die Möglichkeiten sind hier grenzenlos. Es können Merchandiseprodukte, Meet&Greets, Freikarten oder Partnervorteile angeboten werden. Diese werden mit Punkten vom Verein "bepreist" und können dann von den Fans eingelöst werden. Sehr wichtig für die Nutzung dieser Funktion ist die richtige Einstellung des Punktesystems unter Settings -> Loyalty Program. Bei Unsicherheit bietet es sich an eine Spielzeit zu schauen was die maximale Punkteanzahl war, um dann Ableitungen über den Wert der Rewards durchführen zu können.
===News===
*Jeder Artikel hat einen eigenen Link und kann in den Menüs extra verlinkt werden.
**Mithilfe dieser Funktion können auch Inhalte wie z.B. ein Impressum in das Side Menu eingefügt werden.
**Mithilfe des Tools "Yumpu" kann so auch die Einbindung des Saisons- bzw. Spieltagsmagazins gelingen. Dafür muss das PDF auf Yumpu hochgeladen werden und mithilfe der URL in die Vereinsapp integriert werden.
===Social===
*Hier können Benachrichtigungen versendet werden. Wie die Anzeige der verschiedenen Textfelder schlussendlich auf dem Smartphone aussehen wird, könnt ihr in der Testapp überprüfen oder solange die App noch nicht live ist. Bilder, Hashtags und Emojis können dafür verwendet werden.
*Hinweis Social Media: Es können pro Kanal die Inhalte mehrerer Accounts gezeigt werden. Ein Auswahl des Contents ist nicht möglich. Es werden immer alle Inhalte gezeigt.
===Events -> Live Chat===
*Nur Admins können aus dem Backend Nachrichten in den Chat schreiben. Es besteht keine Möglichkeit auf den Chat als Admin per App zuzugreifen.
*Die Änderung der Userbilder (Avatar) ist nicht möglich. Eine zukünftige Änderung wird angestrebt. Nur mit der Anmeldung über Facebook ist es möglich einen Avatar vom Facebookprofilbild zu kopieren.
===Partners===
*Hier können Partner des Vereins vorgestellt werden sowie Banner innerhalb der App aktiviert werden. Mithilfe der richtigen Grafiken kann für jeden Sponsor der richtige Inhalt in der App mit Bannern ausgestattet werden. So kann z.B. Unternehmen A1 bei allen Games sichtbar werden und Unternehmen B2 bei den MVPs werben. Zusätzlich ist es möglich über die Homepage den Fans Partnerangebote zukommen zu lassen.
===Food & Drinks===
*Diese Funktion ist wie eine Art Speise- und Getränkekarte für die Gastronomie in der Arena zu verstehen. Eine Anbindung an einen Zahlungsdienstleister ist nicht vorgenommen.
===Shop products===
*Diese Funktion ersetzt nicht den Fanshop. Hier können Produkte vorgestellt werden. Die Zahlung kann jedoch nicht abgewickelt werden. Schlussendlich ist es eine Verlinkung auf den Online-Shop mit ausführlicher Vorstellung des Merchs vorher.
===Com cards===
===Weitere Features===
*Segmentierungsmodul (kostenpflichtig):
**Damit ist es möglich alle Inhalte einer bestimmten Zielgruppe zukommen zu lassen. Jeder Inhalt kann dann über ein Auswahlmenü an vorher angefertigte Gruppen ausgespielt werden. So können z.B. Inhalte über den Breitensport nur Vereinsmitgliedern angezeigt werden oder Fans von konkreten Spieler*innen mehr Inhalte zur Person angezeigt werden.
*Business Club (kostenpflichtig):
**Netzwerkplattform zum Austausch zwischen Klub und Partnern und untereinander. Technische Basis bleibt Vereinsapp. Durch anderen Login wird Zugang zu vielen weiteren Möglichkeiten wie z.B. Events, Chats, Visitenkarten, Partner-Vorteile möglich. Bei Interesse kontaktieren Sie bitte bFAN für dieses kostenpflichtige Feature.
*Stats:
**Über das Statistik-Widget werden Spielstand, Live-Ticker, und Starting Six automatisch im Event angezeigt. Ebenso wird die Darstellung der Tabelle und des Spielplans automatisch von SAMS nativ in der App möglich.
*Test-App:
**Dort können alle Inhalte ohne Auswirkungen auf die Fans getestet werden. Hilfreich ist sie hauptsächlich für die Benachrichtigungen. Hier können diese in einem geschützten Raum ausprobiert werden. Bitte kontaktiere bFAN sobald du die App nutzen möchtest. Bitte nennt dabei bFAN eine zweite Mailadresse, die nicht schon für eure Vereinsapp verwendet wird. Zukünftig wird es möglich sein dort den Business Club und das Segmentierungsmodul zu testen.
==Downloads==
*https://www.magentacloud.de/share/0whobkya9q
Kategorie:PRKategorie:Vermarktung