Mit dem Deeplink-Validator lassen sich die Deeplinks für Ihre komplette Android-App oder für bestimmte App-Links und benutzerdefinierte Schemas in Ihrer App prüfen. Sie erhalten einen detaillierten Bericht mit allen Prüfungen, die für den Link ausgeführt wurden, und erfahren, wie Sie die fehlenden Konfigurationen vornehmen können. Den Bericht können Sie dann versenden oder herunterladen. Weitere Informationen zu Deeplinks
So öffnen Sie den Deeplink-Validator:
- Klicken Sie in Ihrem Google Ads-Konto auf das Werkzeugsymbol
.
- Öffnen Sie das Drop-down-Menü Planung.
- Klicken Sie auf Hub für App-Werbung.
- Den Deeplink-Validator finden Sie im Menü.
Deeplink-Validator verwenden
Deeplinks bieten Ihnen und Ihren Nutzern einen enormen Mehrwert: Mit ihnen lassen sich Nutzererfahrung und -bindung optimieren, mehr Nutzer erreichen bzw. noch einmal ansprechen und die Zugriffe auf Ihre App steigern.
Mit dem Deeplink-Validator können Sie Folgendes tun:
- Ihre komplette mobile App oder einen bestimmten Link prüfen
- herausfinden, wie Sie Ihre Links richtig konfigurieren
- einen Bericht herunterladen oder senden, um die Dokumentation und Freigabe für alle Verantwortlichen und Beteiligten in Ihrer Organisation zu vereinfachen
- alle erforderlichen Änderungen in Ihrer App und auf Ihrer Website vornehmen
Komplette App oder bestimmte Links prüfen
Mit dem Deeplink-Validator können Sie eine komplette App prüfen und einen vollständigen Bericht aller Links in der Manifestdatei erhalten. Außerdem erfahren Sie, ob die einzelnen Links richtig konfiguriert sind. Alternativ lässt sich auch ein bestimmter Link prüfen und so sicherstellen, dass er wie vorgesehen funktioniert.
Komplette App prüfen
So prüfen Sie alle Deeplinks in Ihrer App:
- Wählen Sie die App aus.
- Wählen Sie im Drop-down-Menü die Option Alle Deeplinks prüfen aus.
- Wählen Sie Validieren aus.
Der Deeplink-Validator ruft jetzt alle Deeplinks aus der App ab und führt die entsprechenden Prüfungen für die einzelnen Links durch.
Funktionen für vollständigen Bericht und Download
Sie sehen, wie viele der Links nicht funktionieren und welche App-Version geprüft wurde. Sie können auch auf die Schaltfläche für den vollständigen Bericht klicken, um ihn herunterzuladen oder an andere Nutzer in Ihrer Organisation zu senden.
Detaillierte Tabelle für die App-Prüfung
Nach der Prüfung sehen Sie eine Tabelle mit bis zu drei Tabs.
Tab „Bei der Websiteprüfung gefundene fehlerhafte Domains“:
- Diesem Tab liegen Domains zugrunde, da eine Domain mehreren Apps zugeordnet sein kann und umgekehrt.
- In der Tabelle sehen Sie die Liste der Domains, die die Websiteprüfungen nicht bestanden haben, und wie viele Websiteprüfungen die jeweilige Domain nicht bestanden hat.
- Wenn Sie auf „Details anzeigen“ klicken, sehen Sie alle Prüfungen, die für diese Domain durchgeführt wurden, welche sie bestanden hat und welche nicht und was Sie tun müssen, um das jeweilige Problem zu beheben.
- Wenn Sie auf der Seite „Details anzeigen“ auf den Tab „App-Links in Domain“ klicken, werden alle Links angezeigt, die dieser Domain zugewiesen sind.
Hinweis: Falls eine oder mehrere Domains in Ihrer App die Websiteprüfungen nicht bestehen, funktionieren alle App-Links in der App nicht wie vorgesehen. Wenn Nutzer die Links anklicken, wird die App unter Umständen trotzdem geöffnet. Allerdings sehen Nutzer dann ein Dialogfeld, in dem sie die App auswählen müssen, mit der der Link geöffnet wird.
Tab „Bei der App-Prüfung gefundene fehlerhafte Links“:
- In der Tabelle sehen Sie die Liste der Links, die App-Prüfungen nicht bestanden haben, ob der jeweilige Link als App-Link oder benutzerdefiniertes URL-Schema geprüft wurde und wie viele App-Prüfungen er nicht bestanden hat.
- Wenn Sie auf „Details anzeigen“ klicken, sehen Sie eine detaillierte Ansicht aller durchgeführten Prüfungen, welche bestanden wurden und welche nicht und was Sie tun müssen, um das jeweilige Problem zu beheben.
Tab „Gültige Links“:
- In der Tabelle sehen Sie die Liste der Links, die App-Prüfungen bestanden haben, und ob der Link als App-Link oder benutzerdefiniertes URL-Schema geprüft wurde.
- Sie können auf „Linkbericht abrufen“ klicken, um eine Vorschau (falls verfügbar) und einen QR-Code für die Landingpage aufzurufen, zu der dieser Deeplink in der App führt. Außerdem wird dort angegeben, welche Prüfungen für den Link durchgeführt wurden.
Filtern
Um sich die Priorisierung der Daten zu erleichtern, können Sie die Domains und Links in den Tabellen nach der Anzahl oder der Art der nicht bestandenen Prüfungen filtern.
Bestimmte Links prüfen
So prüfen Sie einen bestimmten Link:
- Wählen Sie die App aus.
- Wählen Sie im Drop-down-Menü die Option Deeplink prüfen aus.
- Geben Sie den Link ein, den Sie prüfen möchten.
- Klicken Sie auf Validieren.
Nachdem Sie auf „Validieren“ geklickt haben, führt der Deeplink-Validator die entsprechenden Tests für den Link durch.
Ergebnisse
Nach der Validierung sehen Sie die Prüfungen, die für den Link durchgeführt wurden, die Anzahl der bestandenen und nicht bestandenen Prüfungen, ob der Link als App-Link oder benutzerdefiniertes URL-Schema geprüft wurde und die geprüfte App-Version. Wichtig dabei: Falls andere Links und nicht benutzerdefinierte URL-Schemas geprüft werden, ist eine andere Einrichtung erforderlich.
Sie können auch auf die Schaltfläche für den vollständigen Bericht klicken, um ihn herunterzuladen oder an andere Nutzer in Ihrer Organisation zu senden.
Wenn der Deeplink nicht richtig konfiguriert ist, sehen Sie eine Liste der durchgeführten App- bzw. Website-Prüfungen, welche bestanden wurden und welche nicht und was Sie tun müssen, um das jeweilige Problem zu beheben.
Wenn der Link die Prüfungen besteht, sehen Sie eine Vorschau (falls vorhanden) und einen QR-Code für die Landingpage, zu der der Deeplink führt. Außerdem wird angegeben, welche Prüfungen für den Link durchgeführt wurden. Die Deeplink-Vorschau zeigt den Inhalt der App möglicherweise nicht immer korrekt an, insbesondere wenn der Zugriff auf die App eingeschränkt ist (z. B. wenn eine Anmeldung erforderlich ist oder der Zugriff von einem bestimmten Ort aus erfolgen muss). Verwenden Sie daher den QR-Code, um den Deeplink auf Ihrem eigenen Gerät zu testen.
Funktionsweise des Deeplink-Validators
Arten von Deeplink-Prüfungen
Mit dem Deeplink-Validator können zwei Arten von Links geprüft werden: App-Links und benutzerdefinierte URL-Schemas.
- Jeder Link mit HTTP- oder HTTPS-Schema wird als App-Link geprüft.
- Über App-Links, die eine oder mehrere Websiteprüfungen nicht bestehen, dafür aber alle App-Prüfungen (mit Ausnahme der Prüfung auf Android-Systembestätigung), kann die App unter Umständen weiter geöffnet werden. Allerdings sehen Nutzer dann ein Dialogfeld, in dem sie die App auswählen müssen, mit der die URL geöffnet werden soll. Weil sich die Abläufe für Nutzer dadurch schwieriger gestalten, wird dringend empfohlen, alle Probleme mit App-Links zu beheben, damit Nutzer direkt zu Ihrer App weitergeleitet werden.
Prüfung von App-Links
Wenn Sie App-Links implementieren möchten, sind Änderungen an Ihrer App und Website erforderlich.
- Zuerst müssen Sie in Ihrem App-Manifest Intent-Filter erstellen und die App so konfigurieren, dass Daten aus den Intents verwendet werden, um Nutzer zu den richtigen App-Inhalten weiterzuleiten.
- Danach müssen Sie die Verifizierung Ihrer Deeplinks einfügen. Dazu veröffentlichen Sie eine Digital Asset Links-JSON-Datei auf Ihren Websites, damit die Inhaberschaft verifiziert werden kann. Anschließend müssen Sie Ihre App so konfigurieren, dass die Verifizierung von App-Links angefordert wird. Weitere Informationen zur Implementierung von App-Links (in englischer Sprache)
Für App-Links führen wir die folgenden App-Prüfungen und Websiteprüfungen durch.
Prüfung benutzerdefinierter URL-Schemas
Wenn Sie benutzerdefinierte URL-Schemas implementieren möchten, sind nur Änderungen an der App erforderlich. Genauer gesagt müssen Sie in Ihrem App-Manifest Intent-Filter erstellen und Ihre App so konfigurieren, dass Daten aus den Intents verwendet werden, um Nutzer zu den richtigen App-Inhalten weiterzuleiten. Weitere Informationen zur Implementierung von benutzerdefinierten URL-Schemas (in englischer Sprache)
Bei benutzerdefinierten URL-Schemas werden die folgenden App-Prüfungen durchgeführt.
Art der Deeplink-Validator-Prüfungen
Je nach Art des Links führt der Validator App- und/oder Websiteprüfungen durch.
App-Prüfungen
<data>-Tag-Prüfung
Was passiert bei dieser Prüfung?
Hier wird nach einem <data>-Tag gesucht, in dem das Attribut „android:scheme“ enthalten ist. Mit dem <data>-Tag wird sichergestellt, dass die URL von der App geöffnet werden kann.
Wie kann ich potenzielle Probleme beheben?
Die Manifestdatei Ihrer App muss Folgendes enthalten:
- Ein
<data>-Tag, das die Attribute „android:scheme“ und „android:host“ (optional) in den Intent-Filter für diese URL einfügt. - Ein „/“ am Anfang des Attributs „android:path“ im
<data>-Tag. Das Attribut kann auch „android:pathPrefix“ oder „android:pathPattern“ sein.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Attribut ACTION_VIEW
Was passiert bei dieser Prüfung?
Hier wird nach ACTION_VIEW, einem Attribut vom Typ „Intent-Aktion“, gesucht. Ist es vorhanden, kann über die Google Suche auf die URL zugegriffen werden.
Wie kann ich potenzielle Probleme beheben?
Fügen Sie das Attribut ACTION_VIEW im Manifest Ihrer App in den Intent-Filter ein.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Attribut der Kategorie DEFAULT
Was passiert bei dieser Prüfung?
Hier wird nach einem Attribut der Kategorie DEFAULT gesucht. Ist es vorhanden, kann über Webbrowser auf die App zugegriffen werden.
Wie kann ich potenzielle Probleme beheben?
Fügen Sie dem Intent-Filter im Manifest Ihrer App eine Kategorie DEFAULT als Attribut hinzu.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Attribut der Kategorie BROWSABLE
Was passiert bei dieser Prüfung?
Hier wird nach einem Attribut der Kategorie BROWSABLE gesucht. Ist es vorhanden, kann die App geöffnet werden.
Wie kann ich potenzielle Probleme beheben?
Fügen Sie dem Intent-Filter im Manifest Ihrer App eine Kategorie BROWSABLE als Attribut hinzu.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Android-Systembestätigung
Hinweis: Diese Prüfung wird nur für App-Links durchgeführt.
Was passiert bei dieser Prüfung?
Hier wird in der Domain der App-Website nach einer Digital Asset Links-JSON-Datei gesucht. Die Datei wird vom Android-System verwendet, um die App zu verifizieren. Außerdem wird damit die Inhaberschaft der App verifiziert.
Wie kann ich potenzielle Probleme beheben?
Fügen Sie dem Intent-Filter im Manifest Ihrer App das folgende Attribut hinzu: android:autoVerify="true".
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf URL ohne Weiterleitung
Was passiert bei dieser Prüfung?
Hier wird auf Weiterleitungs-URLs geprüft, die von Google Ads nicht unterstützt werden. Über einen Deeplink müssen Nutzer direkt zur App gelangen. Eine Weiterleitung auf externe Server oder Deeplinks von Drittanbietern ist nicht zulässig.
Wie kann ich potenzielle Probleme beheben?
Ersetzen Sie die URL durch eine, über die Nutzer direkt zur App gelangen.
Websiteprüfungen
Host-Attribut – Validierung der Domain
Was passiert bei dieser Prüfung?
Hier wird festgestellt, ob das Attribut „android:host“ ein gültiges Domain-URL-Muster aufweist.
Wie kann ich potenzielle Probleme beheben?
Die Webadresse des Hosts muss korrekt aufgebaut sein, z. B. google.com oder www.google.com.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Digital Asset Links-JSON-Datei hat nicht bestanden
Was passiert bei dieser Prüfung?
Hier wird geprüft, ob eine Digital Asset Links-JSON-Datei auf Ihrer Website vorhanden ist. Sie wird verwendet, um die Inhaberschaft der App zu verifizieren.
Wie kann ich potenzielle Probleme beheben?
Geben Sie eine Digital Asset Links-JSON-Datei für alle Websitedomains an, die diese Prüfung nicht bestehen:
https://[domain.name]/.well-known/assetlinks.json
Außerdem müssen Bots darauf zugreifen dürfen und robots.txt muss Crawling zulassen.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Domain ohne Weiterleitung
Was passiert bei dieser Prüfung?
Hier wird geprüft, ob auf die Domain ohne Weiterleitungen zugegriffen werden kann. Es ist direkter Zugriff erforderlich, damit die Inhaberschaft der App verifiziert werden kann.
Wie kann ich potenzielle Probleme beheben?
Sorgen Sie bei allen Websitedomains, die die Prüfung nicht bestanden haben, dafür, dass ohne Weiterleitungen auf sie zugegriffen werden kann.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Prüfung auf Zugriff per HTTPS
Was passiert bei dieser Prüfung?
Hier wird geprüft, ob über eine HTTPS-Verbindung auf Ihre Digital Asset Links-JSON-Datei zugegriffen werden kann, damit sich die Inhaberschaft der App verifizieren lässt.
Wie kann ich potenzielle Probleme beheben?
Sorgen Sie dafür, dass für alle Websitedomains, die diese Prüfung nicht bestehen, über eine HTTPS-Verbindung auf die Digital Asset Links-JSON-Datei zugegriffen werden kann, selbst wenn im Intent-Filter der App HTTP als Datenschema angegeben ist.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Validierung des JSON-Inhaltstyps
Was passiert bei dieser Prüfung?
Hier wird die Digital Asset Links-JSON-Datei zur Validierung des Inhaltstyps geprüft. Aus dem Inhaltstyp ergibt sich das Format der JSON-Datei. Dadurch kann auf einem Mobilgerät die Inhaberschaft der App verifiziert werden.
Wie kann ich potenzielle Probleme beheben?
Sorgen Sie dafür, dass der Inhaltstyp für alle Websitedomains, die diese Prüfung nicht bestehen, „application/json“ ist.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Validierung des Paketnamens
Was passiert bei dieser Prüfung?
Hier wird geprüft, ob sich mit Ihrer Digital Asset Links-JSON-Datei der Paketname validieren lässt, damit auf einem Mobilgerät die Inhaberschaft der App verifiziert werden kann.
Wie kann ich potenzielle Probleme beheben?
Sorgen Sie dafür, dass in der Digital Asset Links-JSON-Datei für alle Websitedomains, die diese Prüfung nicht bestehen, der korrekte Paketname mit dem „android_app“-Namespace angegeben ist. Prüfen Sie außerdem, ob die App im Google Play Store verfügbar ist.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
Validierung der Fingerabdrücke
Was passiert bei dieser Prüfung?
Hier wird geprüft, ob Ihre Digital Asset Links-JSON-Datei einen SHA256-Fingerabdruck zur Validierung enthält, damit auf einem Mobilgerät die Inhaberschaft der App verifiziert werden kann.
Wie kann ich potenzielle Probleme beheben?
Nehmen Sie das Feld „sha256_cert_fingerprints“ für alle Websitedomains, die diese Prüfung nicht bestehen, in die Digital Asset Links-JSON-Datei auf. Falls Sie bereits einen Fingerabdruck hinzugefügt haben, prüfen Sie, ob er stimmt und der „android_app“-Namespace dafür deklariert ist.
Informationen finden Sie im offiziellen Android-Entwicklerleitfaden.
