Wytyczne dotyczące interfejsu

Wprowadzenie

Interfejs Mobile Data Plan Sharing API umożliwia abonentom sieci komórkowych wyświetlanie informacji o abonamencie w Ustawieniach przy użyciu sprawdzonych wzorców interfejsu użytkownika Androida. Opcjonalnie umożliwia też użytkownikom wyświetlanie planu i zarządzanie nim na innych platformach, np. za pomocą Asystenta. Wielu użytkowników po raz pierwszy zobaczy pakiet danych mobilnych w powiadomieniu informującym o możliwości wyświetlenia pakietu i zarządzania nim. Po wyrażeniu zgody na udostępnianie informacji o abonamencie na mobilną transmisję danych między operatorem a Google subskrybenci będą mogli wyświetlać abonament na mobilną transmisję danych z informacjami przesyłanymi przez interfejs API.

Interfejs po prawej stronie to przykład integracji w Usługach Google Play w wersji 20.1. Przewiń obraz, aby zobaczyć więcej.

Podstawowe zasady

1. Dokładność
   Operator dokłada wszelkich starań, aby za pomocą interfejsu API dostarczać dokładne i aktualne informacje. Wszelkie nieścisłości negatywnie wpłyną na wiarygodność abonamentu na mobilną transmisję danych i pogorszą wrażenia użytkownika z aplikacji Google, które korzystają z tych informacji.
2. Jasność
   Użytkownik może sprawdzić, co subskrybuje lub kupuje, korzystając ze struktury interfejsu API planu i modułu. Nazwy i opisy planów oraz modułów są napisane w jak najbardziej przejrzysty sposób. Pamiętaj, że niektórzy użytkownicy mogą mieć mniejsze umiejętności cyfrowe lub używać telefonu w języku, który nie jest ich językiem ojczystym. Zamiast używać terminów technicznych, takich jak „ograniczona przepustowość”, w odpowiednich przypadkach używaj słów nietechnicznych, np. „prędkość przesyłania danych zostanie zmniejszona do…”.
3. Zwięzłość
   Użytkownicy często skanują tekst, zamiast go czytać, aby znaleźć kluczowe informacje. Umieść słowa kluczowe na początku zdań i usuń słowa, które nie zmieniają ich znaczenia, oraz wykorzystaj kontekst. Na przykład w kontekście salda konta użytkownika zdanie „When you top up your account your account balance validity will be extended” (Gdy doładujesz konto, ważność salda konta zostanie przedłużona) można skrócić do „Extend validity by topping up your balance” (Przedłuż ważność, doładowując saldo).

Opcje konfiguracji

1 Logo 2 Nazwa marki operatora

Logo

Przed przetestowaniem integracji członek zespołu poprosi Cię o plik z logo, które będzie wyświetlane obok Twojego imienia i nazwiska. Zapoznaj się z wytycznymi dotyczącymi marki operatora, aby dowiedzieć się, w jakich przypadkach możesz używać logo. Prześlij kwadratowe logo o wymiarach co najmniej 600 × 600 pikseli na nieprzezroczystym tle, najlepiej w formacie PNG lub SVG, ale akceptujemy też wysokiej jakości pliki JPG.

Logo operatora w połączeniu z nazwą marki to dla użytkowników sygnał, że informacje o pakiecie i koncie są wiarygodne. Wybór odpowiedniego logo interfejsu jest ważny, ponieważ powinno być rozpoznawalne na pierwszy rzut oka nawet w małych rozmiarach. Znaki marki sprawdzają się najlepiej z tych powodów. Jeśli kolor jest silnie związany z Twoją marką, rozważ użycie wersji logo, która w pełni wykorzystuje ten kolor. Jeśli to możliwe, unikaj używania znaków słownych, ponieważ mogą być słabo czytelne w małym rozmiarze, a obok nich będzie wyświetlana nazwa operatora. Nie łącz logo marki i logo słownego w jednym obrazie, ponieważ będzie to jeszcze mniej czytelne.

Używaj znaków towarowych lub skróconych znaków słownych.

Unikaj długich znaków słownych ze względu na czytelność i duplikowanie.

Nie używaj logotypów ani logo z dodatkowymi elementami.

Nazwa marki operatora

Nazwa marki powinna być łatwo rozpoznawalna dla użytkowników, a jednocześnie jak najkrótsza. Nie używaj sloganów ani nie rozwijaj skrótów, jeśli jest to możliwe. Oto kilka przykładów:

Dobre: „MyTelco”, „ACG”

Unikaj: „MyTelco Wireless”, „American Cellular Group”

Nieprawidłowe: „MyTelco – Innovation unbound”, „ACG Inc.”

Wskazówki dotyczące pisania

1. Krótko
   Miejsce jest ograniczone, więc użytkownikom będzie łatwiej przejrzeć informacje. Jest to szczególnie ważne w przypadku użytkowników, którzy po raz pierwszy korzystają z internetu.
2. NIE UŻYWAJ WIELKICH LITER
   Użytkownicy mogą odnieść wrażenie, że na nich krzyczysz. Tekst napisany wielkimi literami jest też trudniejszy do odczytania i przejrzenia. Nie dotyczy to akronimów ani nazw marek.
3. Unikaj zbędnych znaków interpunkcyjnych
   Nie przesadzaj! Ostatnie zdanie zawsze kończ kropką. Jeśli jest tylko jedno zdanie lub wyrażenie, nie używaj kropek.
4. Nie uwzględniaj adresów URL
   O ile w dokumentacji interfejsu API nie podano inaczej, nie będzie można w nie kliknąć w interfejsie.

Typ planu

W przypadku większości operatorów jest to po prostu „przedpłata” lub „płatność z dołu”, ale czasami użytkownicy identyfikują się z unikalnym lub promowanym typem abonamentu, który wykupili. Nie używaj opisowej nazwy planu, która może się zmieniać z miesiąca na miesiąc lub zawierać szczegóły planu, takie jak stawki za połączenia lub SMS-y. Jeśli nie jest to konieczne, możesz pozostawić to pole puste.

1 planStatus.title 2 planStatus.updateTime

Należy	Nie	Liczba znaków	Skracanie
Przedpłata Abonament SuperMetro GoJUMP	Nieograniczone połączenia w sieci, 20 centów za SMS-a Brak subskrypcji Super Internet 5GB 129b	Zalecana liczba znaków: mniej niż 50	Wielokropek po 2 wierszach

Nazwa modułu

Dokumentacja API: PlanModule.moduleName

1 PlanModule.moduleName 2 Plan.expirationTime 3 PlanModule.description

Nazwy modułów powinny być krótkie i unikalne, biorąc pod uwagę wszystkie możliwe nazwy abonamentów, które mogą się tu pojawić. Użyj opisu modułu, aby przekazać szczegóły planu. Nie umieszczaj w tytule informacji o limicie ani ważności, ponieważ będą one wyświetlane w pasku danych i nad nim.

Jeśli nazwa modułu pozostanie pusta, interfejs domyślnie użyje wartości „Dane” w przypadku danych mierzonych i „Nieograniczone dane” w przypadku danych niemierzonych.

Należy	Nie	Liczba znaków	Skracanie
Maksymalna szybkość internetu Pakiet społecznościowy Wieczór filmowy Transmisja danych 3G Nieograniczony transfer danych z szybkością 1 Mb/s	1 GB dodatkowego internetu Nieograniczony dostęp do filmów w iFlix, Netflix, YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM i BEC TERO RADIO	Zalecana liczba znaków: mniej niż 24	brak

Opis modułu

Dokumentacja API: PlanModule.description

Opisz szczegóły, które nie zostały uwzględnione w tytule. Na przykład w zwięzły sposób wyjaśnij korzyści z pakietu „Ultra entertainment pack”. Unikaj języka marketingowego lub promocyjnego, powtarzania nazwy planu oraz szczegółów dotyczących połączeń telefonicznych lub SMS-ów.

Należy	Nie	Liczba znaków	Skracanie
Nielimitowany streaming rozrywki z szybkością 2 Mb/s w YouTube, LINE TV, JOOX, Apple Music, Fungjai, TIDAL, AtimeOnline, Deezer, Cat Radio, COOLISM i BEC TERO RADIO	Ciesz się 12 godzinami nielimitowanego internetu i 24 godzinami nielimitowanych połączeń. Nowe plany SuperMetro zapewniają, że Twoje konto pozostanie aktywne przez cały okres subskrypcji.	Zalecamy, aby nie przekraczać 180 znaków	brak

Saldo konta

Dokumentacja API: AccountInfo

Użytkownicy korzystający z usług przedpłaconych mogą sprawdzić aktualne saldo konta i jego ważność, a także opcjonalnie tekst opisujący zasady operatora dotyczące ważności i wykorzystania salda.

1 AccountInfo.accountBalance 2 AccountInfo.validUntil 3 Tekst pomocy dotyczący salda konta (skontaktuj się z nami, aby go skonfigurować)

Saldo kredytu

Dokumentacja API: AccountInfo

W przypadku użytkowników korzystających z płatności z góry stan pożyczki może być wyświetlany obok salda konta. Obejmuje to kwotę pożyczki i dostępne saldo pożyczki, które można wykorzystać. Musisz podać użytkownikowi krótki opis sposobu pobierania kwoty pożyczki.

1 AccountInfo.accountBalance + AccountInfo.loanBalance 2 AccountInfo.unpaidLoan 3 AccountInfo.loanBalance 4 Tekst pomocy dotyczący pożyczki (skontaktuj się z nami, aby go skonfigurować)

Nazwa oferty

Dokumentacja API: Offer.planName

Użyj jak najkrótszej, unikalnej lub opisowej nazwy, biorąc pod uwagę wszystkie możliwe nazwy abonamentów. Opis oferty powinien zawierać szczegóły oferty, takie jak zasady uczciwego użytkowania lub inne ograniczenia. Nie używaj zbędnych sformułowań promocyjnych ani marketingowych, jeśli wystarczy nazwa opisowa. Unikaj podawania ceny w nazwie, ponieważ pojawia się ona obok oferty.

1 Offer.planName 2 Offer.planDescription 3 PlanOffer.FormOfPayment 4 Warunki zakupu

Należy	Nie	Liczba znaków	Skracanie
Go No Limit 1 Mbps Day Pass Doładowanie 1 GB 1 GB transmisji danych 3G Nieograniczony dostęp do internetu na 1 dzień	Najlepsze doładowanie 4 GB! 1 GB dodatkowych danych ze zniżką	Zalecana liczba znaków: mniej niż 40	brak

Opis oferty

Dokumentacja API: Offer.planDescription

Podaj krótkie i jak najbardziej szczegółowe informacje o ograniczeniach dotyczących użytkowania, prędkości, daty ważności lub przedziału czasowego, jeśli ma to zastosowanie. Unikaj nadmiernego używania języka promocyjnego i marketingowego.

Należy	Nie	Liczba znaków	Skracanie
Dane 4G z maksymalną prędkością 10 Mb/s. Ważny przez 24 godziny.	Najszybszy internet 4G. Odbierz już dziś. Nieograniczona transmisja danych LTE w najlepszej sieci komórkowej w kraju	Zalecaj najważniejsze informacje (do 50 znaków), które mają się pojawiać na liście ofert.	Wielokropek w 2 wierszach na liście ofert Brak obcinania w oknie oferty

Karuzela z ponownymi zakupami

Gdy oferty są oznaczone jako ponowny zakup, pojawiają się nad wszystkimi innymi ofertami, dzięki czemu użytkownicy mogą łatwo znaleźć i szybko odnowić ulubione plany i pakiety. Zobacz, jak to wygląda we wstępie

Forma płatności

Ten tekst dostarczony przez GTAF jest tłumaczony i dołączany do opisu oferty. Jest on ustawiany dla wszystkich ofert wysyłanych do użytkownika. Np. „Odjęto od salda konta” w przypadku większości użytkowników korzystających z przedpłaty lub „Obciążono zapisaną formę płatności” w przypadku użytkowników, którzy mają zapisaną kartę kredytową lub debetową. Treść komunikatów może ulec zmianie. Zobacz inne opcje

Warunki zakupu

Abonament na dane komórkowe może obsługiwać wszelkie warunki zakupu, które obecnie pojawiają się w ofertach w innych kanałach sprzedaży. Jeśli na przykład podatek VAT jest zwykle wyłączony z ceny, podaj informację „Cena nie zawiera 7% podatku VAT”. Jest to konfigurowane podczas rejestracji operatora.

Limity i wykorzystanie

Abonament na dane mobilne umożliwia użytkownikom łatwe śledzenie wykorzystania danych i pozostałego limitu. Niektóre pola są wymagane, ale wszyscy operatorzy powinni wypełnić jak najwięcej pól, aby pomóc użytkownikowi śledzić, co zostało wykorzystane, a co jeszcze zostało. W interfejsie pokazanym poniżej wszystko z wyjątkiem tytułu modułu „Limit internetu” jest sformatowane i przetłumaczone przez Google.

1 Ikona zależy od typu danych określonego w PlanModuleTrafficCategory. Poniższe ikony będą wyświetlane w przypadku wymienionych kategorii ruchu. Nie ustawiaj arbitralnie kategorii ruchu, aby wymusić wyświetlenie określonej ikony.

2quotaBytes mniej remainingBytes

3 Pasek postępu pojawia się tylko wtedy, gdy wypełnione są pola quotaBytes i remainingBytes.

4expirationTime

5quotaBytes

6remainingBytes

7planState ustawione na INACTIVE w przypadku tymczasowej nieaktywności funkcji abonamentu

Powiadomienia

Powiadomienia są kluczowe dla użytkowników, którzy chcą skutecznie zarządzać danymi mobilnymi. Operatorzy mogą wysyłać do swoich subskrybentów za pomocą interfejsu API konkretne powiadomienia o swoich abonamentach. Tekst powiadomienia jest generowany, tłumaczony i wysyłany przez GTAF na podstawie wymaganych pól interfejsu API. Aktualną listę obsługiwanych powiadomień i wymaganych pól znajdziesz w przewodniku po interfejsie Notifications API. Są one zgodne z wytycznymi dotyczącymi powiadomień na Androidzie w Material Design. Ich celem jest dostarczanie użytkownikom aktualnych, kontekstowych, dokładnych i szczegółowych powiadomień, aby mogli zarządzać swoimi danymi.

Przykłady obsługiwanych powiadomień: (treść może ulec zmianie)
1 Niskie saldo danych 2 Brak danych 3 Przypomnienie o wygaśnięciu 4 Powiadomienie powitalne 5 Ostrzeżenie dotyczące płatności za wykorzystane dane 6 Doładowanie salda konta

Strona Pomocy

Stronę pomocy można skonfigurować tak, aby kierować użytkowników do Twoich kanałów pomocy zamiast do narzędzia do przesyłania opinii Google. Od wersji 15.3 Usług Google Play użytkownicy mogą uzyskać do niej dostęp z menu Więcej opcji u góry sekcji Transmisja danych mobilnych. Aby skonfigurować udostępnianie, skontaktuj się z członkiem zespołu ds. udostępniania abonamentu na mobilną transmisję danych.

1 Pomoc 2 Tytuł linku 3 Podtytuł linku

Użytkownicy mogą zobaczyć listę opcji pomocy przez e-mail, SMS-y, połączenia i internet, a także fragment tekstu, który pomoże im zrozumieć kontekst. Linkowanie do innych aplikacji ani pobieranie innych aplikacji ze Sklepu Play nie jest obsługiwane. Tytuł i podtytuł linku są podane w języku angielskim i przetłumaczone przez Google.

Intencje e-maili i SMS-ów mogą zawierać treść i temat (tylko w przypadku e-maili). Użyj ich, jeśli chcesz, aby użytkownik podał odpowiednie informacje, które pomogą w rozpatrzeniu jego prośby o pomoc.

Wskazówki dotyczące strony pomocy
Jak użytkownicy mają wiedzieć, którą opcję wybrać? Jeśli niektóre opcje są przeznaczone dla określonych typów kont, wyraźnie to zaznacz. Użyj podtytułu, aby poinformować użytkowników, kiedy lub dlaczego powinni skorzystać z tej opcji, podając oczekiwany czas odpowiedzi, godziny otwarcia lub inne przydatne informacje.