Tento článok vám pomôže získať informácie o bežných chybách a odstraňovať problémy pri zavádzaní odkazov aplikácie alebo univerzálnych odkazov.
Na tejto stránke
- Bežné chyby nastavenia pri zavádzaní odkazov aplikácie
- Bežné chyby nastavenia pri zavádzaní univerzálnych odkazov
Bežné chyby nastavenia pri zavádzaní odkazov aplikácie
Nižšie sú uvedené bežné chyby nastavenia odkazov aplikácie v Androide a informácie o tom, ako problémy odstrániť.
Chyby webu
- Atribút hostiteľa v správnom tvare: uistite sa, že hostiteľom je webová adresa v správnom tvare, napríklad google.sk alebo www.google.sk.
- Chýba súbor JSON pre protokol Digital Asset Links: mal by existovať pre každý jedinečný názov hostiteľa vo filtroch intencií. Príklad: https://[nazov.domeny]/.well-known/assetlinks.json.
- Poznámka: Táto chyba sa môže vyskytnúť aj v prípade, že Google daný súbor JSON neprehľadáva. Môže sa to stať napríklad vtedy, keď je prístup indexového prehľadávača zamietnutý v súbore robots.txt. Ak chcete zistiť, či je to tak, môžete skontrolovať webovú adresu súboru JSON.
- Nesprávny názov balíčka aplikácie v súbore JSON pre protokol Digital Asset Links: tento názov balíčka by sa mal zhodovať s identifikátorom aplikácie deklarovaným v súbore build.gradle aplikácie a aplikácia by mala byť dostupná v Obchode Google Play.
- Nesprávny odtlačok aplikácie (sha256_cert_fingerprints) v súbore JSON pre protokol Digital Asset Links. Prečítajte si viac o odstraňovaní problémov v prípade tejto chyby.
- Nesprávna hlavička content-type v súbore JSON pre protokol Digital Asset Links: hlavička content-type by mala byť application/json v prípade všetkých webových domén.
- Súbor JSON pre protokol Digital Asset Links je dostupný iba na adrese http://, nie na adrese https://: bez ohľadu na to, či aplikácia deklaruje http:// alebo https:// ako odkaz aplikácie, súbor JSON musí byť z bezpečnostných dôvodov vždy hostený na adrese https://.
- Súbor JSON pre protokol Digital Asset Links je dostupný iba prostredníctvom presmerovaní: tento súbor musí byť dostupný priamo, aby bolo možné overiť vlastníctvo aplikácie bez akýchkoľvek presmerovaní 301 alebo 302.
- Súbor robots.txt blokuje prístup k súboru /.well-known/assetlinks.json na účely prehľadávania: tento súbor musí byť dostupný pre roboty.
Chyby aplikácie
- V manifeste aplikácie chýba značka <data>, ktorá obsahuje atribút android:scheme
- Chýba atribút akcie z intencie ACTION_VIEW vo filtri intencií (android.intent.action.VIEW).
- Chýbajú kategórie DEFAULT a BROWSABLE ako atribúty vo filtri intencií (android.intent.category.DEFAULT a android.intent.category.BROWSABLE).
- Vo filtri intencií chýba atribút android:autoVerify=”true”.
- Zahrnutie presmerovaní: všetky webové adresy musia privádzať používateľov priamo do aplikácie.
- Deklarácia odkazov aplikácie s logickým protirečením: prekrývajúca sa webová adresa odkazov aplikácie, napríklad: https://example.com/ spúšťa aktivitu X a https://example.com/Y spúšťa aktivitu Y. Za týchto podmienok systém Android zobrazí dialógové okno výberu aplikácie (čím sa odkaz aplikácie naruší). Nástroj na overovanie priamych odkazov to momentálne nedeteguje a nejde o odporúčané zavedenie.
Bežné chyby nastavenia pri zavádzaní univerzálnych odkazov
Nižšie sú uvedené bežné chyby nastavenia univerzálnych odkazov pre iOS a informácie o tom, ako problémy odstrániť.
Chyby webu
- Chýbajúci asociačný súbor na webovej doméne: ak web používa viacero subdomén (napríklad example.com, www.example.com alebo support.example.com), každá z nich vyžaduje vlastný záznam v oprávnení pre súvisiace domény a musí poskytovať vlastný súbor apple-app-site-association.
- Asociačný súbor hostíte na nesprávnom mieste: asociačný súbor musí byť hostený na rovnakej doméne ako váš univerzálny odkaz. Nie sú povolené žiadne presmerovania. Ak je napríklad váš univerzálny odkaz https://photo.google.com/album, váš asociačný súbor musí byť na adrese https://photo.google.com/.well-known/apple-app-site-association alebo https://photo.google.com/apple-app-site-association.
- Poznámka: /.well-known/ je preferovaný spôsob.
- Pridanie prípony .json k súboru Apple App Site Association (AASA): odstráňte .json, pretože apple-app-site-association.json je nesprávny tvar.
- Poskytovanie asociačného súboru s hlavičkou content-type nastavenou na MIME plain/text: musí mať hodnotu application/json.
- Prekročenie limitov veľkosti súboru: asociačný súbor musí byť menší ako 128 kB (nekomprimovaná veľkosť).
- Nesprávna konfigurácia identifikátora aplikácie: identifikátor aplikácie musí byť vygenerovaný spojením identifikátora tímu a identifikátora balíka pomocou bodky (.).
- Súbor robots.txt alebo iný mechanizmus na doméne blokuje prehľadávanie asociačného súboru.
- Deklarácia univerzálnych odkazov s logickým protirečením: kľúč paths sa bude spracúvať v poradí.
1. príklad
https://apple.com/wwdc/ spustí univerzálne odkazy.
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*", "NOT /wwdc/*" ]
},
2. príklad
Univerzálne odkazy pre druhú aplikáciu (EFGH5678.com.apple.wwdc) nikdy nefungujú.
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
},
{
"appID": "EFGH5678.com.apple.wwdc",
"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
}
Chyby aplikácie
- Použitie vlastnej schémy: použite https alebo http.
- Chýbajúca predpona applinks: formát všetkých pridružených domén by mal byť podobný formátu applinks:yourdomain.com.
- Nesprávna konfigurácia súvisiacich domén: napríklad .google.sk sa zhoduje s adresou www.google.sk, ale nie s adresou google.sk. Ak chcete deklarovať spojenie pre google.sk aj subdomény (napríklad www.google.sk), mali by ste deklarovať applinks:*.google.sk a applinks:google.sk.
Poznámka: Nástroj na overenie priamych odkazov nebude vykonávať kontroly platnosti súboru AASA (JSON) na úrovni aplikácie.
Osvedčené postupy
- Testovanie v telefóne: pošlite webovú adresu do telefónu, v ktorom je aplikácia nainštalovaná. Kliknite na odkaz pomocou aplikácie bez integrovaného prehliadača (Google Keep môže byť skvelý nástroj na toto testovanie).
- Ak sa otvorí aplikácia, ide o platný univerzálny odkaz.
- Ak sa aplikácia neotvorí alebo sa zobrazí dialógové okno s potvrdením otvorenia aplikácie, nemáte platný univerzálny odkaz.
- Na platforme Appify by sa aplikácia v tomto prípade neotvorila.
- Ak sa aplikácia používa v kampani na interakciu s aplikáciou, reklama by bola v tomto prípade zamietnutá.
