Instructions for the App Publisher
Below are listed all inputs from the apps publisher (e.g. a football association) that are required to setup the iOS and Android Apps.
1. Name of the App
The name of the App will be shown on Google Play and App Store. It should have a maximum of 30 characters (incl. spaces), but it should be as concise as possible because the name of the App will be shown below the icon on the Home screen of the device and if the name is too long, it will be truncated with three points at the end (…). Examples of App Names:
Cymru Football
Belarus Football
CFA Official App
FSF Fótbóltur
2. App Icon and Banner
The icon of the app should be a square image (PNG) of dimensions 1024x1024. It should NOT have transparent background.
Below are app icon guidelines from Google Play and App Store respectively
https://developer.android.com/distribute/google-play/resources/icon-design-specifications
https://developer.apple.com/design/human-interface-guidelines/ios/icons-and-images/app-icon/
We will also need a horizontal banner with dimensions 1024x512 that will be displayed in Google Play. This is however, less important than the icon.
3. Google Account
If your organization does not have a Google Developer Account, you will need to open one by going to the Google Play Console
https://play.google.com/console
After clicking on Go To Console in the upper right corner, you will get the login screen, where you will select Create Account → To manage my business
You will then be guided through the process of creating and verifying your Google Developer Account. An important field to setup in the process is the Developer Name. The developer name will be displayed in Google Play, after the app is published. Therefore it should be a concise and recognizable name of your organization, such as e.g. Cyprus Football Association.
You may be required to upload some identification and company incorporation documents, for Google to verify your Account.
After the Account has been verified, and you are able to login into the Google Play Console, you will need to give us admin authorizations so that we can publish the app and act on your behalf on all technical matters. Below are the steps:
Login to Google Play Console, and click on Users and Permissions menu
Enter analyticom.de@gmail.com address
Go to tab Account permissions and check Admin
Click on Invite user
4. Apple Account
If your organization does not have an Apple Developer Account, you will need to open one by going to the Apple Developer page:
After clicking on Account in the upper right corner, you will get the login screen, where you will select the option Don’t have an Apple ID? Create yours now.
You will then be guided through the process of creating and verifying your Apple Developer Account. An important field to setup in the process is the Developer Name. The developer name will be displayed as publisher in App Store, after the app is published. Therefore it should be a concise and recognizable name of your organization, such as e.g. Cyprus Football Federation.
You may be required to upload some identification and company incorporation documents, for Apple to verify your Account. They may also call you via phone during the verification process.
Please note that the verification process is in practice much more stringent and lengthy with Apple than with Google. You will be required to provide a DUNS number of your Organization. If your Organization does not yet have a DUNS profile as a Legal Entity, then you will need to send an e-mail to DUNS directly. This process is explained in the following article:
https://developer.apple.com/support/D-U-N-S/
You will also be required to provide a Credit Card of the organization, because the Apple Developer Account is not free ($100 per year).
After the Account has been verified, you will need to give us admin authorizations so that we can publish the app and act on your behalf on all technical matters. Below are the steps:
Login to App Store Connect: https://appstoreconnect.apple.com/
Click on Users and Access
Enter comet@analyticom.de e-mail address (and COMET Analyticom as Name)
Under Roles, check Admin
Click on Invite
5. Legal Documents
All published apps need to have at minimum the publisher’s Privacy Policy and ideally Terms of Use (or Terms and Conditions) which will apply to all end-users of the apps. Links to these legal documents will be displayed in the Settings section of the Apps.
You can decide to have everything in one document (screenshot below in the middle) or in multiple documents (screenshot below on the left). Whatever you decide, for each such legal document you will need to provide us:
Document name, as it will displayed in the apps, e.g. FAW Privacy Policy
Document link, which will be opened when user clicks on the Document name, e.g. https://www.faw.cymru/en/about-faw/privacy-policy/
You can also decide to force that all users explicitly accept the legal documents after downloading the app, and before starting to use it. The example is shown on the screenshot above on the right.
You should publish links to legal document ideally on your website under your official domain. While creating the documents, your legal advisors may find useful the below examples of legal documents, which are already productively used:
https://www.analyticom.de/live-privacy-terms/
https://faw.cymru/privacy-policy/
https://support.faiconnect.ie/wp-content/uploads/2023/12/FAI-Connect-Privacy-Notice.pdf
6. App Description
You need to provide an App Description, which will be displayed in the App Store and Google Play for your Apps. Please note that App Description will be presented in one language only, and you may decide what will be your default language. The App Description must have a maximum of 4.000 characters (incl. spaces). You can use this tool to calculate the total number of characters:
https://zutrix.com/word-counter
Below is the standard COMET LIVE App Description, which you should use as a basis, and then customize to your specific needs:
7. App Short Promotional Texts
You need to provide short promotional texts for the apps, which will be displayed in the App Store and Google Play. The short promotional texts must have:
a maximum of 170 characters (incl. spaces) for iOS
a maximum of 80 characters (incl. spaces) for Android
You can use this tool to calculate the total number of characters:
https://zutrix.com/word-counter
Below is an example of COMET LIVE short promotional texts, which you can use as a basis, and then customize to your needs:
iOS: Fixtures, results, detailed match reports and statistics from all official football competitions in Cyprus, including club and player profiles and past performances.
Android: Fixtures, results & statistics of all official football competitions in Cyprus
8. App Keywords
You need to provide App Keywords, which will be used to optimize search results in the App Store and Google Play. Please note that keywords will be presented in one language only, and you may decide what will be your default language. The keywords must have a maximum of 100 characters (incl. spaces). You can use this tool to calculate the total number of characters:
https://zutrix.com/word-counter
Below is an example of COMET LIVE App Keywords, which you can use as a basis, and then customize to your needs:
fixtures schedules football soccer cfa cyprus live results scores matches stats statistics comet
9. COMET Authorizations
In order to engage the end-users of the apps, the matches should be managed in COMET in real-time mode, which means tracking the live status, and entering match events as they happen. This can be done either via the Web/Browser version of COMET, or ideally with COMET Football mobile apps. Please refer to the article below:
https://kb.analyticom.de/live/live-match-status
You can decide who (which COMET role) will be responsible for managing the matches in real-time mode and we will setup the COMET system configuration accordingly.
Most commonly, the Club Admin of the Home Team is granted authorizations to manage the match and enter match events in the system. Of course, only the Main Referee can officially confirm the match (set status to PLAYED).
10. News Sources
In the News Section, you can have one or more News Sources, such as your YouTube Account, or RSS Feed
For each News Source, we will need:
Display Name (e.g. Videos)
Type (e.g. YouTube, RSS)
Link (e.g. https://www.youtube.com/user/FAWales/videos)
Default Order Number (1,2,3…)
Default Order Number should be 1 for the default news source, and 2,3,…etc for the others. Every user will see the news sources sorted initially by this default order. Every user will also be able to customize the order of news sources, and enable/disable some of them. However, the users will never be able to disable the default news source.
11. Translations
COMET LIVE Apps are currently available in English, Russian, Croatian and Greek. If you want to have your COMET LIVE Apps localized to another language, then we will send you the most recent resource files in English language which need to be translated to your language.
We only need to translate the values in the resource files, they are positioned:
on iOS between parentheses
on Android, between tags (green example on picture below)
Please make sure you do not touch the system variables (red example on picture)
You can simply delete the English version of the value, and replace it with your language. You can see how labels are correctly translated on iOS on the purple example below
Translate what you know, and what you don't know leave aside, and then we will clarify all such cases to you, by showing you where this label appears in the app.
Note: Translation is a recurring task even after the go-live. Whenever we build some new functionality in COMET LIVE, there will be some new app labels to be translated, but it only relates to new labels (newly developed functionality). So the recurring effort is minor compared to the initial translation.
12. Tester Accounts
Before being published on App Store and Google Play, the COMET LIVE Apps will be distributed from the testing environment to:
one or more test e-mails for IOS (it should be an e-mail linked to an Apple Account, e.g. it can be your e-mail or anyone who is going to check it)
one or more test e-mails for Android (it should be an e-mail linked to Google Account, e.g. any gmail account to which you have access)
These apps will be connected to your COMET DEMO instance. After you test the apps on the Demo environment, check the translations, news sources, legal links, etc, you will give us the green light to publish the Apps on App Store and Google Play.
13. Screenshots
During testing, by using COMET DEMO and Test version of the apps, you will provide us with the screenshots that you want to have shown in Google Play and App Store. Please note that these screenshots and any data displayed on them will be publicly accessible. Please send us up to 8 screenshots on Android and up to 10 screenshots on iOS.
Each screenshot should be in 24-bit PNG (no alpha) format in 2 dimensions - 1284 x 2778 px and 1242 x 2208 px.
You can see examples of screenshots selected by publishers on:
https://play.google.com/store/apps/details?id=de.analyticom.cometlive.by&hl=en
https://play.google.com/store/apps/details?id=de.analyticom.cometlive.faw&hl=en
https://apps.apple.com/la/app/belarus-football/id1570121185
https://apps.apple.com/us/app/cymru-football/id1531345768
14. Letter to App Store and Google Play
In order to accelerate the approval and publication of the apps on Google Play and App Store, please put this text on your memorandum, replace the variable parts (marked red), have it signed, scanned, and sent back to us, so that we can attach it when submitting the app for review.
Dear Sir/Madam,
The Cyprus Football Association (hereinafter “CFA”) is the governing body of all football in the Republic of Cyprus and is a member association of FIFA (Fédération Internationale de Football Association).
Our app named CFA Official App (hereinafter “App”) presents team line-ups, match events, statistics, contacts, and other information of public interest, for all official football competitions, registered clubs and players in Cyprus.
We guarantee that CFA is the lawful holder and processor of any data (such as match data and statistics) and files (such as pictures and logos) published in the Apps.
We also confirm that the software development company Analyticom d.o.o. is our technological service provider, and is continuously operating and maintaining the app.
Should you have any further queries on relation to this matter, please do not hesitate to contact us.
Best Regards,
Firstname Lastname, Title, Cyprus Football Association
___________________________
15. Contact email
An email address that Google Play and App Store users can use to contact you about this application.