Jak propojit App Store Connect s AdMate

App Store Connect obsahuje několik druhů dat: metadata aplikací, recenze, analytiku, prodeje, odhadované výnosy a konečné finanční výkazy. AdMate je může zobrazit ve stejné aplikaci, kterou používáte pro AdMob a RevenueCat, ale propojení musí mít správné identifikátory a oprávnění.

Nastavení používá klíč API App Store Connect. Se soukromým klíčem zacházejte jako s heslem: importujte jej pouze na obrazovce přihlašovacích údajů a nikdy jej nepřikládejte k požadavku na podporu.

AdMate

Všechny vaše příjmy na jednom panelu

Sledujte AdMob, AdSense, RevenueCat a App Store Connect napříč více účty s filtry podle aplikace, platformy a země

Monitorujte příjmy, kliknutí, eCPM, předplatná, instalace a platby na iPhonu, iPadu, Macu a Apple Watch

Co potřebujete z App Store Connect

Připravte si hodnoty, které Apple pro klíč API zobrazuje v části Uživatelé a přístup:

Key ID, který identifikuje klíč API;
Issuer ID, který identifikuje vydavatele App Store Connect API;
obsah nebo soubor soukromého klíče .p8;
jasný alias účtu pro AdMate;
číslo dodavatele, pokud jej požadovaný prodejní nebo finanční výkaz vyžaduje.

Role přiřazená klíči určuje, co Apple vrací. Klíč, který dokáže vypsat aplikace, nemusí mít přístup k prodejním nebo finančním datům. Použijte co nejužší vhodnou roli, ale ověřte, že pokrývá výkazy, které opravdu chcete číst.

Apple obvykle dovolí stáhnout soubor se soukromým klíčem jen jednou. Originál uchovávejte bezpečně mimo repozitář a mimo snímky obrazovky. Pokud se soubor ztratí nebo vyzradí, klíč odvolejte a vytvořte nový, místo abyste někoho žádali o jeho zaslání přes chat.

Přidejte účet v AdMate

Otevřete Nastavení a správu účtů.
Zvolte přidání účtu App Store Connect.
Zadejte snadno rozpoznatelný zobrazovaný název.
Přidejte Key ID a Issuer ID přesně tak, jak je poskytuje Apple.
Importujte nebo vložte soukromý klíč přes obrazovku přihlašovacích údajů.
Pokud to finanční nebo prodejní výkazy vyžadují, přidejte číslo dodavatele.
Uložte účet a nechte AdMate ověřit přihlašovací údaje.
Otevřete souhrn účtu a ověřte, že se zobrazují očekávané aplikace.

Neupravujte ručně záhlaví ani zápatí klíče .p8. Text navíc, chybějící zalomení řádků nebo klíč jiného vydavatele znemožní vytvoření tokenu.

Každou oblast dat ověřte zvlášť

Jeden zelený souhrn nedokazuje, že je dostupný každý koncový bod App Store Connect. Zkontrolujte oblasti, které chcete používat:

Aplikace a metadata

Ověřte, že se zobrazují očekávané aplikace a ikony. Chybějící aplikace může znamenat, že klíč patří jiné organizaci poskytovatele nebo že je jeho role omezená.

Recenze

Otevřete zobrazení recenzí a zkontrolujte známou aplikaci. Recenze jsou data podle obchodu a území; platný prázdný stav může jednoduše znamenat, že žádné odpovídající recenze neexistují.

Analytika

Zvolte celé období a počítejte s tím, kdy Apple výkazy zpřístupní. Některé analytické výkazy nejsou okamžité a mají vlastní podrobnost a zpoždění.

Prodeje a výnosy

Prodeje zákazníkům a výnosy vývojáře označujte zvlášť. Nejde o stejnou hodnotu a žádnou z nich nezaměňujte s bankovní platbou.

Finanční výkazy

Finanční výkazy používají uzavřená vykazovací období Apple a mohou vyžadovat správné číslo dodavatele a roli. Používejte je pro odsouhlasení, místo abyste čekali zobrazení aktuálního dne.

Řešení potíží s propojením

Neplatný klíč nebo podpis

Znovu zkontrolujte Key ID, Issuer ID a soukromý klíč jako jednu sadu. Platný klíč se špatným vydavatelem stejně selže. Pokud mohlo dojít k vyzrazení, klíč před dalším testováním odvolejte.

Aplikace se načtou, ale finanční výkazy ne

Zkontrolujte roli klíče API, číslo dodavatele a požadované finanční období. Přístup k metadatům nezaručuje přístup k financím.

Analytika nezobrazuje žádná data

Použijte podporovaný historický rozsah, ověřte, že je výkaz již dostupný, a potvrďte, že vybraná aplikace požadovanou metriku vygenerovala.

Zobrazují se aplikace jiné organizace

Odeberte účet a přidejte klíč správného poskytovatele. Nesčítejte součty dvou organizací jen proto, že jejich aplikace používají stejnou konvenci pojmenování balíčků.

Více účtů App Store Connect

AdMate podporuje více než jeden účet. Používejte aliasy, které identifikují organizaci, ne osobu, která klíč vytvořila. Když se klíč vymění, nahraďte jej ve správném účtu a otestujte aplikace, analytiku a finance zvlášť.

Pro srovnání s analytikou předplatného si přečtěte, proč se součty App Store Connect a RevenueCat liší.

Často kladené otázky

Potřebuje AdMate heslo k mému Apple ID?

Ne. Propojení používá klíč API App Store Connect, vydavatele a související identifikátory. Pro toto nastavení nikdy nezadávejte ani nesdílejte heslo k Apple ID.

Proč se aplikace načtou, ale výnosy ne?

Klíč může mít dostatečné oprávnění pro metadata aplikací, ale ne pro prodeje či finance, nebo chybí číslo dodavatele a období výkazu.

Mohu jeden klíč používat na více zařízeních s AdMate?

Technicky mohou stejné přihlašovací údaje fungovat, ale každá další kopie zvyšuje riziko vyzrazení. Dodržujte zásady správy klíčů ve vaší organizaci a odvolávejte klíče na zařízeních, která už nemají mít přístup.

Jsou odhady z App Store Connect konečné účetní hodnoty?

Ne. Pro účetnictví používejte uzavřené finanční výkazy a skutečné platby.