Jak połączyć App Store Connect z AdMate

App Store Connect zawiera kilka rodzajów danych: metadane aplikacji, recenzje, analizy, sprzedaż, szacowane wpływy i ostateczne raporty finansowe. AdMate może zebrać je w tej samej aplikacji, której używasz do AdMob i RevenueCat, ale połączenie musi mieć właściwe identyfikatory i uprawnienia.

Konfiguracja korzysta z klucza API App Store Connect. Traktuj klucz prywatny jak hasło: importuj go wyłącznie na ekranie danych uwierzytelniających i nigdy nie dołączaj do zgłoszenia do pomocy technicznej.

AdMate

Wszystkie przychody w jednym panelu

Śledź AdMob, AdSense, RevenueCat i App Store Connect na wielu kontach z filtrami według aplikacji, platformy i kraju

Monitoruj przychody, kliknięcia, eCPM, subskrypcje, instalacje i płatności na iPhonie, iPadzie, Macu i Apple Watch

Czego potrzebujesz z App Store Connect

Przygotuj wartości wyświetlane przez Apple w sekcji Użytkownicy i dostęp dla klucza API:

Key ID, identyfikujący klucz API;
Issuer ID, identyfikujący wystawcę API App Store Connect;
zawartość lub plik klucza prywatnego .p8;
czytelny alias konta w AdMate;
numer dostawcy, jeśli wymaga go żądany raport sprzedaży lub finansowy.

Rola przypisana do klucza decyduje o tym, co zwraca Apple. Klucz, który może wyświetlać aplikacje, nadal może nie mieć dostępu do danych sprzedażowych lub finansowych. Używaj najwęższej odpowiedniej roli, ale upewnij się, że obejmuje raporty, które naprawdę chcesz odczytywać.

Apple zwykle pozwala pobrać plik klucza prywatnego tylko raz. Przechowuj oryginał w bezpiecznym miejscu, poza repozytorium i poza zrzutami ekranu. Jeśli plik zginie lub zostanie ujawniony, unieważnij klucz i utwórz nowy, zamiast prosić kogoś o przesłanie go przez czat.

Dodaj konto w AdMate

Otwórz Ustawienia i zarządzanie kontami.
Wybierz dodanie konta App Store Connect.
Wpisz rozpoznawalną nazwę wyświetlaną.
Dodaj Key ID i Issuer ID dokładnie w takiej postaci, w jakiej podaje je Apple.
Zaimportuj lub wklej klucz prywatny na ekranie danych uwierzytelniających.
Dodaj numer dostawcy, jeśli wymagają go raporty finansowe lub sprzedażowe.
Zapisz konto i pozwól AdMate zweryfikować dane uwierzytelniające.
Otwórz podsumowanie konta i sprawdź, czy pojawiają się oczekiwane aplikacje.

Nie edytuj ręcznie nagłówka ani stopki klucza .p8. Dodatkowy tekst, brakujące podziały wierszy lub klucz innego wystawcy uniemożliwią utworzenie tokenu.

Sprawdź każdy obszar danych osobno

Jedno zielone podsumowanie nie dowodzi, że każdy punkt końcowy App Store Connect jest dostępny. Sprawdź obszary, z których zamierzasz korzystać:

Aplikacje i metadane

Sprawdź, czy pojawiają się oczekiwane aplikacje i ikony. Brak aplikacji może oznaczać, że klucz należy do innej organizacji dostawcy albo jego rola jest ograniczona.

Recenzje

Otwórz widok recenzji i sprawdź znaną aplikację. Recenzje to dane zależne od sklepu i kraju; prawidłowy pusty widok może po prostu oznaczać, że nie ma pasujących recenzji.

Analizy

Wybierz pełny okres i uwzględnij, kiedy Apple udostępnia raporty. Niektóre raporty analityczne nie są dostępne od razu i mają własną szczegółowość oraz opóźnienie.

Sprzedaż i wpływy

Oznaczaj osobno sprzedaż dla klientów i wpływy dewelopera. To nie są te same wartości i żadnej z nich nie należy mylić z przelewem bankowym.

Raporty finansowe

Raporty finansowe korzystają z zamkniętych okresów rozliczeniowych Apple i mogą wymagać właściwego numeru dostawcy oraz roli. Używaj ich do uzgadniania danych, zamiast oczekiwać, że pojawi się bieżący dzień.

Rozwiązywanie problemów z połączeniem

Nieprawidłowy klucz lub podpis

Sprawdź ponownie Key ID, Issuer ID i klucz prywatny jako jeden zestaw. Prawidłowy klucz połączony z niewłaściwym wystawcą nadal nie zadziała. Jeśli klucz mógł zostać ujawniony, unieważnij go przed dalszymi testami.

Aplikacje się wczytują, ale raporty finansowe nie

Sprawdź rolę klucza API, numer dostawcy i żądany okres finansowy. Dostęp do metadanych nie gwarantuje dostępu do finansów.

Analizy nie pokazują danych

Użyj obsługiwanego zakresu historycznego, sprawdź, czy raport jest już dostępny, i potwierdź, że wybrana aplikacja wygenerowała żądany wskaźnik.

Pojawiają się aplikacje innej organizacji

Usuń konto i dodaj klucz właściwego dostawcy. Nie łącz sum dwóch organizacji tylko dlatego, że ich aplikacje stosują tę samą konwencję nazewnictwa pakietów.

Kilka kont App Store Connect

AdMate obsługuje więcej niż jedno konto. Używaj aliasów, które identyfikują organizację, a nie osobę, która utworzyła klucz. Gdy klucz zostanie wymieniony, zastąp go we właściwym koncie i osobno przetestuj aplikacje, analizy i finanse.

Aby porównać dane z analizami subskrypcji, przeczytaj, dlaczego sumy App Store Connect i RevenueCat się różnią.

Najczęściej zadawane pytania

Czy AdMate potrzebuje hasła do mojego Apple ID?

Nie. Połączenie korzysta z klucza API App Store Connect, wystawcy i powiązanych identyfikatorów. Nigdy nie wpisuj ani nie udostępniaj hasła Apple ID na potrzeby tej konfiguracji.

Dlaczego aplikacje się wczytują, a wpływy nie?

Klucz może mieć wystarczające uprawnienia do metadanych aplikacji, ale nie do sprzedaży lub finansów, albo brakuje numeru dostawcy i okresu raportu.

Czy mogę używać jednego klucza na kilku urządzeniach z AdMate?

Technicznie te same dane mogą działać, ale każda dodatkowa kopia zwiększa ryzyko ujawnienia. Przestrzegaj zasad zarządzania kluczami w swojej organizacji i unieważniaj klucze na urządzeniach, które nie powinny już mieć dostępu.

Czy szacunki App Store Connect są ostatecznymi wartościami księgowymi?

Nie. Do celów księgowych używaj zamkniętych raportów finansowych i rzeczywistych płatności.