Firebase Dynamic Links Analytics API'sı

Her bir kısa Dynamic Links ile ilgili analiz verilerini almak için bu REST API'yi kullanabilirsiniz konsolda veya programatik olarak oluşturulması gerekir.

API Yetkilendirmesi

Dynamic Link Analytics API'lerine istek gönderirken OAuth eklemeniz gerekir Firebase projenize erişim yetkisi veren 2.0 erişim jetonu.

Google API istemci kitaplığını kullanarak erişim jetonları alabilirsiniz:

  1. Firebase'i uygulamanıza şu adla ekleyin: öğrenin. Yani bir hizmet hesabı oluşturun. özel anahtar oluşturabilirsiniz.
  2. Hizmetinizden erişim jetonu almak için Google API istemci kitaplığı kullanma hesap kimlik bilgileri:

    Java

    Her bir Java için Google API İstemci Kitaplığı:

    // Load the service account key JSON file
    FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");
    
    // Authenticate a Google credential with the service account
    GoogleCredential googleCred = GoogleCredential.fromStream(serviceAccount);
    
    // Add the required scope to the Google credential
    GoogleCredential scoped = googleCred.createScoped(
        Arrays.asList(
          "https://www.googleapis.com/auth/firebase"
        )
    );
    
    // Use the Google credential to generate an access token
    scoped.refreshToken();
    String token = scoped.getAccessToken();
    
    // Include the access token in the Authorization header.
    

    Node.js

    Her bir Node.js için Google API İstemci Kitaplığı:

    var { google } = require("googleapis");
    
    // Load the service account key JSON file.
    var serviceAccount = require("path/to/serviceAccountKey.json");
    
    // Specify the required scope.
    var scopes = [
      "https://www.googleapis.com/auth/firebase"
    ];
    
    // Authenticate a JWT client with the service account.
    var jwtClient = new google.auth.JWT(
      serviceAccount.client_email,
      null,
      serviceAccount.private_key,
      scopes
    );
    
    // Use the JWT client to generate an access token.
    jwtClient.authorize(function(error, tokens) {
      if (error) {
        console.log("Error making request to generate access token:", error);
      } else if (tokens.access_token === null) {
        console.log("Provided service account does not have permission to generate access tokens");
      } else {
        var accessToken = tokens.access_token;
    
        // Include the access token in the Authorization header.
      }
    });
    

    Python

    Python için Google Auth kitaplığı:

    from google.oauth2 import service_account
    from google.auth.transport.requests import AuthorizedSession
    
    # Specify the required scope
    scopes = [
      "https://www.googleapis.com/auth/firebase"
    ]
    
    # Authenticate a credential with the service account
    credentials = service_account.Credentials.from_service_account_file(
        "path/to/serviceAccountKey.json", scopes=scopes)
    
    # Use the credentials object to authenticate a Requests session.
    authed_session = AuthorizedSession(credentials)
    response = authed_session.get(
        "https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats?durationDays=DURATION")
    
    # Or, use the token directly, as described below.
    request = google.auth.transport.requests.Request()
    credentials.refresh(request)
    access_token = credentials.token
    
ziyaret edin.

Tek bir Dynamic Link için istatistikleri alın

Tek bir Dynamic Link için etkinlik istatistiklerini almak üzere linkStats uç noktasını kullanın.

HTTP isteği

linkStats isteği aşağıdaki biçimdedir:

GET https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats?durationDays=DURATION

Authorization: Bearer ACCESS_TOKEN

Örneğin, kısa bir bağlantının son 7 güne ait istatistiklerini almak için https://example.page.link/wXYz:

GET https://firebasedynamiclinks.googleapis.com/v1/https%3A%2F%2Fexample.page.link%2FwXYz/linkStats?durationDays=7

Authorization: Bearer ya29.Abc123...
Parametreler
SHORT_DYNAMIC_LINK Etkinlik verilerini almak istediğiniz URL kodlamalı kısa Dynamic Link.
DURATION Etkinlik verilerinin alınacağı gün sayısı. Örneğin, 30 değerini belirtirseniz istek son 30 güne ait verileri alır. Son 36 saat içinde günlüğe kaydedilen bazı etkinliklerin dahil edilmemiş olabileceğini unutmayın.
ACCESS_TOKEN Süresi dolmamış erişim jetonu. Bkz. API Yetkilendirme.

Yanıt gövdesi

Bir isteğin yanıtı, aşağıdakine benzer bir JSON nesnesidir:

{
  "linkEventStats": [
    {
      "platform": "ANDROID",
      "count": "123",
      "event": "CLICK"
    },
    {
      "platform": "IOS",
      "count": "123",
      "event": "CLICK"
    },
    {
      "platform": "DESKTOP",
      "count": "456",
      "event": "CLICK"
    },
    {
      "platform": "ANDROID",
      "count": "99",
      "event": "APP_INSTALL"
    },
    {
      "platform": "ANDROID",
      "count": "42",
      "event": "APP_FIRST_OPEN"
    },

    ...

  ]
}

linkEventStats listesindeki her öğe, platforma özgü şu öğe sayısını içerir: Dynamic Link ile ilgili bazı etkinlikler (ör. Android'deki tıklama sayısı). Lütfen bu istatistikler son gün içinde günlüğe kaydedilen etkinlikleri 36 saat.

Etkinlik Açıklama Firebase konsolu REST API
TIKLAMA Nasıl işlendiğine ve hedeflerine bakılmaksızın, Dinamik Bağlantı'ya yapılan tıklamaların sayısı
YÖNLENDİRME Kullanıcıları, uygulamayı yüklemek veya güncellemek için App Store veya Play Store'a ya da başka bir hedefe yönlendirme denemelerinin sayısı
UYGULAMA_YÜKLEME Gerçek yükleme sayısı (yalnızca Play Store tarafından desteklenir)
UYGULAMA_FIRST_OPEN Yükleme işleminden sonra ilk açılışların sayısı
UYGULAMA_RE_OPEN Dinamik Bağlantı'nın bir uygulamanın yeniden açılmasına neden olma sayısı