Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
Zanim zaczniesz
Zanim zaczniesz korzystać z monetyzacji w organizacji Apigee, musisz wykonać te czynności wstępne:
- Utwórz konto Apigee Edge zgodnie z instrukcjami w artykule Tworzenie konta Apigee Edge.
- Zarabianie na zakupach. Edge nie zawiera początkowo interfejsu API do zarabiania ani nie integruje zarabiania z interfejsem zarządzania. Aby włączyć interfejs API generowania przychodu i komponenty interfejsu generowania przychodu w Edge dla organizacji Apigee, musisz kupić funkcję zarabiania.
Po zakupie funkcji zarabiania musisz wykonać te czynności:
- Współpracuj z zespołem ds. konfiguracji Apigee, aby dokończyć wstępną konfigurację zarabiania. Zobacz Konfiguracja początkowa w Apigee.
- Skonfiguruj zarabianie. Zobacz Konfigurowanie zarabiania.
- Zarabiaj na interfejsach API. Zobacz Zarabianie na interfejsach API.
- zarządzać zarabianiem, tworząc raporty, zarządzając saldami kont itp.; Zobacz Zarządzanie zarabianiem.
Konfiguracja początkowa w Apigee
Współpracuj z zespołem ds. konfiguracji Apigee Edge, aby dokończyć konfigurację początkową monetyzacji. Na podstawie podanych przez Ciebie informacji zespół ds. konfiguracji skonfiguruje te elementy:
- Czy Twoja organizacja jest firmą telekomunikacyjną.
- Rodzaj rozliczeń, który chcesz obsługiwać w przypadku deweloperów kupujących Twoje abonamenty: przedpłacony, popłacony lub oba. Więcej informacji znajdziesz w artykule Konta z przedpłatą a konta z płatnością po wykonaniu usługi.
- Czy chcesz, aby do systemu księgowego były wyodrębniane szczegółowe czy podsumowane dane dotyczące zarabiania, oraz jaki format danych jest wymagany.
- Niestandardowy adres e-mail do odpowiedzi. W przypadku powiadomień e-mail dotyczących zarabiania, które są wysyłane do firm i programistów, skonfigurowany jest domyślny adres noreply@apigee.com. Musisz poprosić o niestandardową nazwę i adres odpowiedzi dla swojej organizacji.
Zespół ds. konfiguracji Apigee uruchamia skrypt, aby zsynchronizować monetyzację z Twoją organizacją oraz deweloperami, aplikacjami i usługami API utworzonymi za pomocą Apigee Edge. Zespół pomocy Apigee może w przyszłości poprosić Cię o zsynchronizowanie organizacji zgodnie z opisem w artykule Synchronizowanie danych Apigee Edge z zarabianiem. Nie synchronizuj danych o przychodach, chyba że otrzymasz taką instrukcję od zespołu Apigee.
Konfigurowanie zarabiania
W tabeli poniżej znajdziesz podsumowanie czynności wymaganych do skonfigurowania zarabiania w organizacji Apigee.| Krok | Opis |
|---|---|
| Edytowanie profilu organizacji | W ramach początkowej konfiguracji zarabiania zespół ds. konfiguracji Apigee Edge tworzy profil Twojej organizacji.
Aby dodać lub zaktualizować informacje o organizacji, musisz edytować jej profil. Może być konieczne na przykład zaktualizowanie typu rozliczeń, ustawień waluty lub modelu podatkowego. |
| Zarządzanie obsługiwanymi walutami | W ramach początkowej konfiguracji generowania przychodu zespół ds. konfiguracji Apigee Edge określa waluty obsługiwane przez Twoją organizację i ustawia walutę domyślną.
Możesz pobrać listę walut obsługiwanych przez Twoją organizację oraz dodawać i usuwać obsługiwane waluty (aby odzwierciedlały waluty używane przez dewelopera lub w ramach planu cenowego). Uwaga: w ramach zarabiania automatycznie uruchamiane jest codzienne zadanie, które pobiera kurs wymiany na dolary amerykańskie dla każdej obsługiwanej waluty. Domyślnie zadanie jest uruchamiane codziennie o 1 sekundę po północy. Więcej informacji znajdziesz w artykule Planowanie zadań zarabiania. |
| Określ warunki | Opcjonalnie możesz dodać warunki do profilu organizacji przed opublikowaniem planów cenowych. Po opublikowaniu planu cenowego w portalu dla programistów wyświetla się bieżąca wersja warunków. Uwaga: warunki korzystania z usługi znajdują się poza profilem organizacji. W profilu organizacji podaj lokalizację (publiczny adres URL) warunków. Możesz dodać wiele wersji warunków, aby odzwierciedlały zmiany zachodzące z upływem czasu. |
| Egzekwowanie limitów zarabiania | Dołącz zasadę MonetizationLimitsCheck do serwerów proxy interfejsu API, aby wymusić limity zarabiania. Zasady są egzekwowane w tych sytuacjach:
|
| Konfigurowanie powiadomień | Skonfiguruj powiadomienia, aby informować deweloperów lub dostawców interfejsów API o określonym zdarzeniu, np. o nowo opublikowanym planie taryfowym. |
Zarabianie na interfejsach API
Gdy zarabiasz na interfejsach API, łączysz co najmniej jedną usługę API w pakiet usług API i określasz powiązany plan taryfowy.
Pakiet usług API nie jest widoczny dla deweloperów, dopóki nie opublikujesz planu taryfowego dla pakietu (z datą rozpoczęcia przypadającą na bieżący lub przyszły dzień). Deweloperzy mogą zarejestrować swoje aplikacje, aby korzystać z pakietu produktów interfejsu API, tylko przez zakup jednego z obecnie obowiązujących planów cenowych. Jeśli pakiet usług API nie ma opublikowanego planu taryfowego, który jest obecnie w użyciu, pakiet nie jest spieniężany.
W tabeli poniżej znajdziesz podsumowanie kroków wymaganych do zarabiania na interfejsach API.
| Krok | Opis |
|---|---|
| Zarządzanie pakietami produktów API | Twórz pakiety usług API, aby grupować usługi API. Uwaga: w klasycznym interfejsie Edge i interfejsie API do zarabiania pakiety produktów są nazywane pakietami interfejsu API. Aby dowiedzieć się, jak zarządzać pakietami produktów API za pomocą interfejsu API, zapoznaj się z tymi artykułami:
|
| Konfigurowanie zasad rejestrowania transakcji | Skonfiguruj zasady rejestrowania transakcji dla każdej usługi API. Zasady rejestrowania transakcji określają, co chcesz rejestrować w rekordach transakcji dotyczących produktu API, w tym wszelkie atrybuty niestandardowe. Aby skonfigurować zasady rejestrowania transakcji za pomocą interfejsu API, zapoznaj się z tymi artykułami: |
| Zarządzanie planami cenowymi i ich publikowanie | Utwórz plan taryfowy, aby określić sposób zarabiania na interfejsach API. Na przykład czy pobierasz stałą czy zmienną opłatę za korzystanie z interfejsu API. Aby zarządzać planami cenowymi za pomocą interfejsu API, zapoznaj się z tymi artykułami: |
| Kupowanie opublikowanego planu taryfowego | Za pomocą interfejsu API możesz kupić opublikowany plan taryfowy, a w razie potrzeby anulować go lub spowodować jego wygaśnięcie. |
| Konfigurowanie zarabiania w portalu dla programistów | Skonfiguruj zarabianie w portalu dla programistów, aby zapewnić programistom samoobsługowy dostęp do subskrypcji planu cenowego, automatycznego przetwarzania płatności i rozliczeń, raportów, katalogów produktów i innych ustawień związanych z zarabianiem. |
Zarządzaj monetyzacją
Po skonfigurowaniu zarabiania i włączeniu go w interfejsie API możesz wykonać co najmniej jedną z czynności podsumowanych w tej tabeli:
| Krok | Opis |
|---|---|
| Zarządzanie firmami i deweloperami | zarządzać firmami i programistami, którzy korzystają z Twoich interfejsów API; Deweloper to pojedynczy podmiot, który jest jednoznacznie identyfikowany przez adres e-mail. Firma to zbiór deweloperów zarządzanych jako pojedynczy podmiot. |
| Tworzenie raportów | Tworzenie raportów dotyczących salda z przedpłaty, przychodów i odchyleń. Deweloperzy korzystający z płatności przedpłaconych mogą porównywać raporty o saldzie z przedpłaty z wpłatami na konto bankowe. |
| Wprowadzanie korekt płatności | Możesz na przykład wprowadzać korekty płatności, aby korygować rozbieżności w swoich rekordach. |
| Przyznawanie środków | W razie potrzeby przyznaj deweloperowi środki. W przypadku dewelopera korzystającego z przedpłaty środki pojawiają się jako zmniejszenie wykorzystania, które zwiększa saldo z przedpłaty dewelopera w przyszłości. W przypadku dewelopera korzystającego z płatności z dołu kredyt pojawia się na fakturze w osobnym wierszu, zmniejszając opłatę. |
| Zarządzanie środkami na koncie przedpłaconym | Sprawdzaj bieżące saldo konta przedpłaconego i doładuj je lub skonfiguruj automatyczne doładowanie za pomocą zewnętrznego dostawcy usług płatniczych. |
| Zarządzanie saldami płatności z dołu za pomocą limitów kredytowych | Gdy dodasz obsługiwaną walutę dla organizacji, możesz ustawić limit kredytowy dla dewelopera korzystającego z płatności odroczonych. Limit kredytowy dotyczy wszystkich deweloperów korzystających z płatności odroczonych w organizacji. Możesz też ustawić limit kredytowy dla poszczególnych deweloperów korzystających z płatności odroczonych. W takim przypadku limit kredytu zastępuje limit ustawiony dla waluty tylko w przypadku określonego dewelopera. |
| publikować zwroty środków, | przekazywać deweloperom zwroty środków za transakcje zakupu; |
| Planowanie zadań związanych z zarabianiem | Monetyzacja udostępnia harmonogram zadań i zestaw zadań, które są wstępnie zaplanowane do uruchamiania w wyznaczonych godzinach. Zarządzanie harmonogramem zadań związanych z zarabianiem za pomocą interfejsu API. |
| Wyświetlanie stanu transakcji | Wyświetlaj stan transakcji, które miały miejsce w określonym przedziale czasu, za pomocą interfejsu API. |
| Synchronizowanie danych Apigee Edge z danymi o przychodach | Jeśli Apigee wyda takie polecenie, ponownie zsynchronizuj dane z monetyzacją, aby mieć pewność, że są one zsynchronizowane. Możesz zsynchronizować te elementy: organizację, produkty 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ę. |