Fehlerbehebung

In diesem Leitfaden werden allgemeine Schritte zur Fehlerbehebung beschrieben, mit denen sich häufige Implementierungsfehler beheben lassen.

Keine Termine

Wenn Ihre Ereignisse nicht in Google Analytics angezeigt werden, sollten Sie nach einigen häufigen Problemen suchen.

Wählen Sie zuerst Ihren Kunden aus:

• Verwenden Sie das richtige api_secret?

  Prüfe, ob du den api_secret für den richtigen Stream verwendest. Wenn Sie das Measurement Protocol für mehrere Streams einrichten, hat jeder Stream ein eigenes Secret.

• Ist Ihr api_secret noch gültig?

  Um Spam zu bekämpfen, können Sie api_secret widerrufen. Prüfen Sie, ob das api_secret, das Sie verwenden, noch gültig ist. Möglicherweise hat ein anderer Nutzer mit Zugriff auf deinen Stream den Zugriff darauf versehentlich widerrufen.

• Wurde Ihr api_secret richtig kopiert?

  Bei api_secret wird die Groß-/Kleinschreibung berücksichtigt. Prüfen Sie noch einmal, ob die api_secret in der Google Analytics-Benutzeroberfläche genau mit der übereinstimmt, die Sie in Ihrem Code verwenden.

• Verwenden Sie nicht advertising_id.

  advertising_id wird nicht als gültige Geräte-ID unterstützt. Verwenden Sie app_instance_id, wenn Sie Firebase verwenden, und client_id, wenn Sie gtag.js verwenden.

• Verwenden Sie die richtige firebase_app_id?

  Achten Sie darauf, dass Sie die Kennung für eine Firebase-App verwenden. Sie finden diesen Wert in der Firebase Console unter Projekteinstellungen > Allgemein > Ihre Apps > App-ID.

  firebase_app_id unterscheidet sich von app_instance_id.

• Verwenden Sie die richtige app_instance_id?

  Achten Sie darauf, dass Sie die ID verwenden, die für eine Installation einer Firebase-App spezifisch ist. Dieser Wert muss über das Google Analytics for Firebase SDK abgerufen werden.

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

  app_instance_id unterscheidet sich von firebase_app_id.

Ungültige IDs

Da das Measurement Protocol IDs aus dem Google Analytics for Firebase SDK und gtag.js unterstützt, müssen Sie die richtige ID verwenden. Die IDs, die Sie verwenden sollten, hängen davon ab, ob Sie das Google Analytics for Firebase SDK oder gtag.js verwenden. Im Folgenden wird beschrieben, welche IDs Sie verwenden sollten:

Google Analytics for Firebase SDK

Wenn Sie das Google Analytics for Firebase SDK verwenden, sollten Sie die folgenden IDs verwenden:

• firebase_app_id: Fügen Sie diese ID in die Suchparameter für die Anfrage ein. Diese ID identifiziert Ihre Firebase-App eindeutig. Alle Nutzer Ihrer App haben dieselbe firebase_app_id. Sie finden sie in der Firebase Console unter:
  Projekteinstellungen > Allgemein > Ihre Apps > App-ID

• app_instance_id: Diese ID muss im POST-Textkörper der Anfrage enthalten sein. Diese ID identifiziert eine bestimmte Installation einer Firebase-App eindeutig. Dieser Wert ist für jede Installation Ihrer App unterschiedlich. Die Methoden zum Anfordern dieses Werts für die einzelnen Firebase-Plattformen sind wie folgt:

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

Folgendes sollte nicht verwendet werden:

• firebase_instance_id: Diese ID darf nicht in Ihrer Anfrage enthalten sein. Diese ID wird zur Identifizierung einer bestimmten Instanz der App verwendet, ist jedoch Firebase-spezifisch. Sie wird für Aufgaben wie FCM-Nachrichten verwendet.

gtag.js

Wenn Sie gtag.js verwenden, sollten Sie die folgenden IDs verwenden:

• measurement_id: Fügen Sie diese ID in die Suchparameter für die Anfrage ein. Diese ID identifiziert einen Datenstream eindeutig. Alle Nutzer Ihrer Website haben denselben measurement_id. Sie finden sie in der Google Analytics-Benutzeroberfläche unter:
  Verwaltung > Datenstreams > Stream auswählen > Mess-ID
• client_id: Diese ID muss im POST-Textkörper der Anfrage enthalten sein. Diese ID identifiziert eine bestimmte Nutzerinstanz eines Webclients eindeutig. Dieser Wert ist für jeden Nutzer Ihrer App unterschiedlich. Hier finden Sie Beispiele für das Abrufen dieses Werts.

Fehlende Ereignisse für serverseitiges Tagging

Mit einer serverseitigen Tag Manager-Installation mit einem Measurement Protocol-Client können Sie Ereignisse im Measurement Protocol-Format an einen Container senden. Der Container sendet diese Ereignisse dann mit demselben Mechanismus wie alle anderen SGTM-Ereignisse an Google Analytics.

Wenn Sie alle Funktionen des Measurement Protocol nutzen möchten, senden Sie Ereignisse direkt an das Measurement Protocol und nicht an Ihren Container.