Az App Store Connect csatlakoztatása az AdMate-hez

Az App Store Connect többféle adatot tartalmaz: alkalmazás-metaadatokat, értékeléseket, elemzéseket, értékesítéseket, becsült bevételeket és végleges pénzügyi jelentéseket. Az AdMate ezeket ugyanabba az alkalmazásba hozhatja, amelyet az AdMobhoz és a RevenueCathoz is használsz, de a kapcsolathoz megfelelő azonosítók és engedélyek kellenek.

A beállítás App Store Connect API-kulcsot használ. A privát kulcsot kezeld jelszóként: csak a hitelesítő adatok képernyőjén importáld, és soha ne csatold támogatási kérelemhez.

AdMate

Minden bevétele egyetlen irányítópulton

Kövesse az AdMob, AdSense, RevenueCat és App Store Connect adatait több fiókban, alkalmazás, platform és ország szerinti szűrőkkel

Figyelje a bevételeket, kattintásokat, eCPM-et, előfizetéseket, telepítéseket és kifizetéseket iPhone-on, iPaden, Macen és Apple Watchon

Mire van szükséged az App Store Connectből

Készítsd elő azokat az értékeket, amelyeket az Apple a Felhasználók és hozzáférés részben mutat az API-kulcshoz:

Key ID, amely az API-kulcsot azonosítja;
Issuer ID, amely az App Store Connect API kibocsátóját azonosítja;
a privát .p8 kulcs tartalmát vagy fájlját;
egy egyértelmű fiókálnevet az AdMate-hez;
a szállítói számot, ha a kért értékesítési vagy pénzügyi jelentés igényli.

A kulcshoz rendelt szerepkör határozza meg, mit ad vissza az Apple. Egy kulcs, amely ki tudja listázni az alkalmazásokat, még nem biztos, hogy hozzáfér az értékesítési vagy pénzügyi adatokhoz. A legszűkebb megfelelő szerepkört használd, de győződj meg róla, hogy lefedi azokat a jelentéseket, amelyeket valóban olvasni szeretnél.

Az Apple általában csak egyszer engedi letölteni a privát kulcsfájlt. Az eredetit biztonságos helyen tárold, a kódtáron és a képernyőképeken kívül. Ha a fájl elveszett vagy kiszivárgott, vond vissza a kulcsot, és hozz létre újat, ahelyett hogy megkérnél valakit, hogy csevegőn küldje el.

A fiók hozzáadása az AdMate-ben

Nyisd meg a Beállítások menüt és a fiókkezelést.
Válaszd egy App Store Connect-fiók hozzáadását.
Adj meg egy jól felismerhető megjelenítendő nevet.
Add meg a Key ID-t és az Issuer ID-t pontosan úgy, ahogy az Apple megadja őket.
Importáld vagy illeszd be a privát kulcsot a hitelesítő adatok képernyőjén.
Add meg a szállítói számot, ha a pénzügyi vagy értékesítési jelentésekhez szükséges.
Mentsd a fiókot, és hagyd, hogy az AdMate ellenőrizze a hitelesítő adatokat.
Nyisd meg a fiók összesítőjét, és ellenőrizd, hogy megjelennek-e a várt alkalmazások.

Ne szerkeszd kézzel a .p8 kulcs fejlécét vagy láblécét. A fölösleges szöveg, a hiányzó sortörések vagy egy másik kibocsátótól származó kulcs megakadályozza a token létrehozását.

Ellenőrizz minden adatterületet külön

Egy zöld összesítő nem bizonyítja, hogy minden App Store Connect-végpont elérhető. Ellenőrizd azokat a területeket, amelyeket használni szeretnél:

Alkalmazások és metaadatok

Ellenőrizd, hogy megjelennek-e a várt alkalmazások és ikonok. Egy hiányzó alkalmazás arra utalhat, hogy a kulcs egy másik szolgáltatói szervezethez tartozik, vagy korlátozott a szerepköre.

Értékelések

Nyisd meg az értékelések nézetét, és ellenőrizz egy ismert alkalmazást. Az értékelések áruház- és területfüggő adatok; egy érvényes üres állapot egyszerűen azt is jelentheti, hogy nincs megfelelő értékelés.

Elemzések

Válassz egy teljes időszakot, és számolj azzal, mikor teszi elérhetővé az Apple a jelentéseket. Egyes elemzési jelentések nem azonnaliak, és saját részletességük és késleltetésük van.

Értékesítések és bevételek

Külön jelöld a vásárlói értékesítést és a fejlesztői bevételt. Nem ugyanaz az érték, és egyiket sem szabad összekeverni egy banki kifizetéssel.

Pénzügyi jelentések

A pénzügyi jelentések az Apple lezárt jelentési időszakait használják, és szükség lehet hozzájuk a megfelelő szállítói számra és szerepkörre. Egyeztetésre használd őket, ne várd, hogy az aktuális nap is megjelenjen.

A kapcsolat hibaelhárítása

Érvénytelen kulcs vagy aláírás

Ellenőrizd újra egy csomagként a Key ID-t, az Issuer ID-t és a privát kulcsot. Egy érvényes kulcs rossz kibocsátóval párosítva is hibát ad. Ha a kulcs kiszivároghatott, a további tesztelés előtt vond vissza.

Az alkalmazások betöltődnek, a pénzügyi jelentések nem

Ellenőrizd az API-kulcs szerepkörét, a szállítói számot és a kért pénzügyi időszakot. A metaadatokhoz való hozzáférés nem garantálja a pénzügyi adatokhoz való hozzáférést.

Az elemzések nem mutatnak adatot

Használj támogatott korábbi időszakot, ellenőrizd, hogy a jelentés már elérhető-e, és győződj meg róla, hogy a kiválasztott alkalmazás előállította a kért mutatót.

Egy másik szervezet alkalmazásai jelennek meg

Távolítsd el a fiókot, és add hozzá a megfelelő szolgáltató kulcsát. Ne vond össze két szervezet összesítéseit csak azért, mert az alkalmazásaik ugyanazt a csomagelnevezési konvenciót követik.

Több App Store Connect-fiók

Az AdMate több fiókot is támogat. Olyan álneveket használj, amelyek a szervezetet azonosítják, ne a kulcsot létrehozó személyt. Ha egy kulcsot lecserélnek, cseréld le a megfelelő fiókban, és teszteld külön az alkalmazásokat, az elemzéseket és a pénzügyeket.

Az előfizetési elemzésekkel való összehasonlításhoz olvasd el, miért térnek el az App Store Connect és a RevenueCat összesítései.

Gyakori kérdések

Szüksége van az AdMate-nek az Apple ID-jelszavamra?

Nem. A kapcsolat App Store Connect API-kulcsot, a kibocsátót és a kapcsolódó azonosítókat használja. Ehhez a beállításhoz soha ne adj meg és ne ossz meg Apple ID-jelszót.

Miért töltődnek be az alkalmazások, a bevételek pedig nem?

Lehet, hogy a kulcsnak elég jogosultsága van az alkalmazás-metaadatokhoz, de az értékesítésekhez vagy a pénzügyekhez nem, vagy hiányzik a szállítói szám és a jelentési időszak.

Használhatok egy kulcsot több AdMate-eszközön?

Technikailag ugyanaz a hitelesítő adat működhet, de minden további másolat növeli a kockázatot. Kövesd a szervezeted kulcskezelési szabályzatát, és vond vissza a kulcsokat azokról az eszközökről, amelyeknek már nem kell hozzáférniük.

Az App Store Connect becslései végleges számviteli értékek?

Nem. A könyveléshez lezárt pénzügyi jelentéseket és tényleges kifizetéseket használj.