Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Zanim zaczniesz
Zanim zaczniesz korzystać z funkcji zarabiania w organizacji Apigee, musisz wykonać te wymagane zadania wstępne:
- Utwórz konto Apigee Edge zgodnie z opisem w artykule Tworzenie konta Apigee Edge.
- Zarabianie na zakupach. Edge nie zawiera początkowo interfejsu API do zarabiania ani nie integruje funkcji zarabiania z interfejsem zarządzania. Aby włączyć do Edge interfejs Apigee interfejs API zarabiania i jego komponenty, musisz kupić tę funkcję.
Po zakupieniu funkcji zarabiania musisz wykonać te czynności:
- We współpracy z zespołem ds. konfiguracji Apigee skonfiguruj początkową konfigurację zarabiania. Zobacz Wstępna konfiguracja z Apigee.
- Skonfiguruj zarabianie. Zobacz Konfigurowanie zarabiania.
- Zarabiaj na interfejsach API. Zobacz Zarabianie na interfejsach API.
- Mogą oni m.in. tworzyć raporty i zarządzać saldem kont. Zobacz Zarządzanie zarabianiem.
Początkowa konfiguracja z Apigee
We współpracy z zespołem ds. konfiguracji Apigee Edge przeprowadź wstępną konfigurację zarabiania. Na podstawie podanych przez Ciebie informacji zespół ds. konfiguracji skonfiguruje następujące ustawienia:
- Wskazuje, czy Twoja organizacja jest firmą telekomunikacyjną.
- Który typ płatności chcesz obsługiwać dla deweloperów, którzy kupują Twoje abonamenty: przedpłacony, po wykonaniu usługi lub w obu tych miejscach. Zobacz artykuł Konta przedpłacone a konta abonamentowe.
- Określa, czy szczegółowe lub podsumowujące dane z procesu generowania przychodu mają być wyodrębniane do swojego systemu księgowego oraz jaki jest wymagany format danych.
- Spersonalizowany adres e-mail do odpowiedzi. W przypadku e-maili z powiadomieniami dotyczącymi zarabiania, które są wysyłane do firm i deweloperów, skonfigurowany jest domyślny adres noreply@apigee.com. Musisz poprosić o niestandardową nazwę odpowiedzi i adres swojej organizacji.
Zespół ds. konfiguracji Apigee uruchamia skrypt, aby synchronizować przychody z Twoją organizacją oraz wszystkimi deweloperami, aplikacjami i usługami interfejsów API utworzonymi w Apigee Edge. Zespół pomocy Apigee może w przyszłości poprosić o synchronizowanie organizacji w sposób opisany w artykule Synchronizowanie danych Apigee Edge z monetyzacją, aby dowiedzieć się więcej. Nie synchronizuj danych dotyczących zarabiania, chyba że Apigee otrzyma instrukcję.
Skonfiguruj zarabianie
W tabeli poniżej znajdziesz podsumowanie czynności wymaganych do skonfigurowania zarabiania w organizacji Apigee.| Step | Opis |
|---|---|
| Edytowanie profilu organizacji | W ramach początkowej konfiguracji zarabiania zespół konfiguracji Apigee Edge konfiguruje profil Twojej organizacji.
Musisz edytować profil organizacji, aby odpowiednio dodać lub zaktualizować informacje o swojej organizacji. Może być na przykład konieczne zaktualizowanie typu płatności, ustawień waluty lub modelu podatkowego. |
| Zarządzanie obsługiwanymi walutami | Podczas wstępnej konfiguracji zarabiania zespół konfiguracji Apigee Edge określa waluty obsługiwane przez Twoją organizację i ustawia walutę domyślną.
Możesz pobrać waluty obsługiwane w organizacji oraz dodać lub usunąć te waluty (aby odzwierciedlić waluty używane przez dewelopera lub abonament). Uwaga: funkcja Generowanie przychodu automatycznie uruchamia codzienne zadanie, które pobiera kurs wymiany w dolarach amerykańskich dla każdej obsługiwanej waluty. Domyślnie zadanie jest uruchamiane codziennie o 1 sekundy po północy. Więcej informacji znajdziesz w artykule Planowanie zadań zarabiania. |
| Określanie warunków korzystania z usługi | Opcjonalnie możesz dodać warunki korzystania z usługi do profilu organizacji przed opublikowaniem planów stawek. Po opublikowaniu planu taryf ich bieżąca wersja będzie widoczna w portalu dla deweloperów. Uwaga: Warunki korzystania z usługi znajdują się poza profilem Twojej organizacji. W profilu organizacji określasz lokalizację (publiczny adres URL) warunków korzystania z usługi. Możesz dodać różne wersje warunków korzystania z usługi, aby odzwierciedlić zmiany zachodzące z upływem czasu. |
| Egzekwowanie limitów zarabiania | Dołącz zasadę MonetizationLimitsCheck do serwerów proxy interfejsu API, aby egzekwować limity zarabiania. Zasada jest wyzwalana w następujących sytuacjach:
|
| Konfigurowanie powiadomień | Skonfiguruj powiadomienia, aby powiadamiać deweloperów lub dostawców interfejsów API o konkretnym zdarzeniu, np. o nowo opublikowanym planie taryfowym. |
Zarabiaj na interfejsach API
Zarabiając na interfejsach API, musisz połączyć co najmniej 1 usługę API w pakiet usług API i zdefiniować powiązany plan taryfowy.
Pakiet produktów interfejsu API nie będzie widoczny dla deweloperów, dopóki nie opublikujesz planu taryfowego dla pakietu (z datą rozpoczęcia przypadającą na datę bieżącą lub przyszłą). Deweloperzy mogą zarejestrować swoje aplikacje w celu korzystania z pakietu produktów API tylko przez zakup jednego z obowiązujących obecnie abonamentów. Jeśli pakiet produktów API nie ma opublikowanego planu stawek, który obowiązuje obecnie, nie generuje przychodów.
W tabeli poniżej znajdziesz podsumowanie czynności wymaganych do zarabiania na interfejsach API.
| Step | Opis |
|---|---|
| Zarządzanie pakietami produktów za pomocą interfejsu API | Utwórz pakiety produktów API, aby pogrupować je. Uwaga: w klasycznym interfejsie użytkownika Edge i interfejsie Monetization API pakiety produktów są nazywane pakietami interfejsu API. Aby zarządzać pakietami produktów za pomocą interfejsu API, zobacz:
|
| Konfigurowanie zasady rejestrowania transakcji | Skonfiguruj zasady rejestrowania transakcji dla każdej usługi API. Zasady rejestrowania transakcji określają, co ma być rejestrowane w rekordach transakcji dotyczących produktu API, w tym w wszelkich atrybutach niestandardowych. Aby skonfigurować zasady rejestrowania transakcji za pomocą interfejsu API, zobacz te artykuły: |
| Zarządzanie planami stawek i ich publikowanie | Utwórz plan opłat, aby zdefiniować metodę zarabiania dla Twoich interfejsów API. np. czy pobierasz stałą czy zmienną stawkę za korzystanie z interfejsu API. Aby zarządzać planami stawek za pomocą interfejsu API, zobacz: |
| Kupowanie opublikowanego abonamentu | Kup opublikowany abonament, a zakupiony abonament wygaśnie lub anuluj, jeśli chcesz, przy użyciu interfejsu API. |
| Konfigurowanie zarabiania w portalu dla deweloperów | Skonfiguruj zarabianie w portalu dla deweloperów, aby zapewnić deweloperom samoobsługowy dostęp do subskrypcji abonamentu, automatycznego przetwarzania płatności i rozliczeń, raportów, katalogów produktów oraz innych ustawień związanych z zarabianiem. |
Zarządzaj monetyzacją
Po skonfigurowaniu funkcji zarabiania i zarabiania na interfejsie API możesz wykonać co najmniej 1 z czynności przedstawionych w tej tabeli:
| Step | Opis |
|---|---|
| Zarządzanie firmami i deweloperami | Zarządzasz firmami i deweloperami, którzy korzystają z Twoich interfejsów API. Deweloper to pojedynczy podmiot, który jest jednoznacznie identyfikowany na podstawie adresu e-mail. Firma to zbiór deweloperów zarządzanych jako jeden podmiot. |
| Tworzenie raportów | Tworzenie raportów dotyczących salda przedpłaconego, przychodów i wariancji. W przypadku deweloperów korzystających z usług przedpłaconych możesz uzgadniać przedpłacone raporty o saldzie z depozytami bankowymi. |
| Wprowadzanie korekt płatności | Wprowadzanie korekt płatności np. w celu korygowania rozbieżności w rejestrach. |
| Wydawanie środków | W razie potrzeby przyznaj środki dla deweloperów. W przypadku dewelopera przedpłaconego środki są postrzegane jako zmniejszenie wykorzystania, które zwiększy saldo przedpłaty dewelopera. W przypadku deweloperów korzystających z opcji płatności po wykonaniu usługi środki są widoczne na fakturze jako osobny wiersz. Zmniejsza to opłata na fakturze. |
| Zarządzanie saldami kont przedpłaconych | Wyświetl bieżące saldo przedpłaconego konta i załaduj ponownie konta przedpłacone lub skonfiguruj automatyczne doładowanie za pomocą zewnętrznego dostawcy usług płatniczych. |
| Zarządzanie saldami po wykonaniu usługi za pomocą limitów kredytu | Gdy dodasz obsługiwaną walutę dla organizacji, możesz ustawić limit kredytu dla deweloperów korzystających z opcji płatności po wykonaniu usługi. Limit kredytu obowiązuje wszystkich deweloperów korzystających z abonamentu w organizacji. Możesz też ustawić limit kredytu dla pojedynczego dewelopera korzystającego z abonamentu. W tym przypadku limit kredytu zastępuje każdy limit ustawiony w walucie tylko w przypadku określonego dewelopera. |
| Po zwrocie środków | Publikowanie informacji o zwrotach środków za transakcje zakupu. |
| Planowanie zadań zarabiania | Funkcja zarabiania obejmuje algorytm szeregowania zadań i zestaw zadań, które są zaplanowane i mają być uruchamiane w wyznaczonych godzinach. Zarządzaj harmonogramem zadań zarabiania za pomocą interfejsu API. |
| Wyświetlanie stanu transakcji | Za pomocą interfejsu API możesz wyświetlić stan transakcji, które miały miejsce w wybranym przedziale czasu. |
| Synchronizowanie danych Apigee Edge z zarabianiem | Jeśli Apigee otrzyma takie polecenie, ponownie zsynchronizuj dane z funkcją zarabiania, aby upewnić się, że są one zsynchronizowane. Możesz synchronizować następujące elementy: organizacja, usługi interfejsu API, programistów i aplikacje. |
| Usuwanie danych o zarabianiu z organizacji | Możesz usunąć dane dotyczące zarabiania z organizacji, aby wyczyścić organizację testową lub usunąć organizację. |