Udostępnij za pośrednictwem


Implementowanie śledzenia interakcji z powiadomieniami push

Aby dowiedzieć się więcej o ogólnym podejściu do konfigurowania powiadomień push w Customer Insights - Journeys, odwiedź stronę omówienia konfiguracji powiadomień push.

Aby włączyć powiadomienia push w Customer Insights - Journeys, należy obserwować następujące kroki:

  1. Konfigurowanie aplikacji powiadomienia push
  2. Mapowanie użytkownika na powiadomienia push
  3. Rejestracja urządzenia dla powiadomień push
  4. Otrzymywanie powiadomień push na urządzeniach
  5. Raportowanie interakcji w powiadomieniu push

W celu raportowania wskaźników otwierania aplikacja musi wysłać te dane z powrotem do Customer Insights - Journeys.

Ważne

Aby śledzić łącza otwierane przez odbiorców w powiadomieniach, należy zebrać zgodę na śledzenie klientów. Więcej informacji o strategii zbierania zgody klienta w Customer Insights - Journeys: Omówienie zarządzania zgodę

Wysyłanie zdarzeń do Customer Insights - Journeys

Adres URL żądania:

POST {PublicEndpoint}api/v1.0/orgs/<orgId>/pushdatareceiver/events
{ 

    "TrackingId": "00000000-0000-0000-0000-000000000000", 
    "DeviceToken": "%DeviceToken", 
    "PushNotificationStatus":  1

} 

Zwraca: 202, jeśli żądanie jest prawidłowe, w przeciwnym razie 400

Nazwa/nazwisko Podpis
TrackingId Każde powiadomienie zawiera w swoich danych identyfikator śledzenia. Ten identyfikator należy wysłać do śledzenia zdarzeń.
DeviceToken Unikatowy token urządzenia przenośnego rejestrującego zdarzenie.
PushNotificationStatus Kod stanu zdarzenia. Zwraca „1” w przypadku otwartego zdarzenia.
orgId Identyfikator organizacji Customer Insights - Journeys.

Przykładowy kod Swift do wysyłania zdarzeń w systemie iOS

func createInteraction(typeInteraction: Int, trackingId: String) {
    if !trackingId.isEmpty || trackingId == "00000000-0000-0000-0000-000000000000" {
        return
    }
    let orgId = UserDefaults.standard.string(forKey: "organizationId2")
    let endP = UserDefaults.standard.string(forKey: "endpoint2")
    if orgId == nil || endP == nil {
        return
    }
    let url = URL(
        string: String(
            format: "https://%@/api/v1.0/orgs/%@/pushdatareceiver/events", endP ?? "", orgId ?? ""))!
    let session = URLSession.shared
    // now create the URLRequest object using the url object
    var request = URLRequest(url: url)
    request.httpMethod = "POST"  //set http method as POST
    // add headers for the request
    request.addValue("application/json", forHTTPHeaderField: "Content-Type")  // change as per server requirements
    request.addValue("application/json", forHTTPHeaderField: "Accept")
    do {
        // convert parameters to Data and assign dictionary to httpBody of request
        let deviceToken = UserDefaults.standard.string(forKey: "deviceToken")
        let jsonBodyDict = [
            "PushNotificationStatus": String(typeInteraction), "DeviceToken": deviceToken,
            "TrackingId": trackingId,
        ]
        request.httpBody = try JSONSerialization.data(
            withJSONObject: jsonBodyDict, options: .prettyPrinted)
    } catch let error {
        print(error.localizedDescription)
        return
    }
    // create dataTask using the session object to send data to the server
    let task = session.dataTask(with: request) { data, response, error in
        if let error = error {
            print("Post Request Error: \(error.localizedDescription)")
            return
        }
        // ensure there is valid response code returned from this HTTP response
        guard let ttpResponse = response as? HTTPURLResponse,
            (200...299).contains(httpResponse.statusCode)
        else {
            print("Invalid Response received from the server")
            return
        }
        print("Interaction creation successful.")
    }
    // perform the task
    task.resume()
}


Przykładowy kod Java do wysyłania zdarzeń w systemie Android

Część 1: Generowanie ładunku

EventTrackingContract: 
public String toJsonString() { 
        JSONObject jsonObject = new JSONObject(); 
        try { 
            jsonObject.put("PushNotificationStatus", mEvent.toString()); 
            jsonObject.put("DeviceToken", mDeviceToken); 

            jsonObject.put("TrackingId", trackingId); 
        } catch (JSONException e) { 
            Log.d(LOG_TAG, "Json exception while creating event tracking contract: " + e.getMessage()); 
        } 
        return jsonObject.toString(); 
    } 
 
EventTypeEnum: 
public enum EventType {
    Opened(1); 
}

Część 2: HttpClient do wysyłania zdarzenia na serwer

AsyncTask.execute(new Runnable() { 
            @Override 
            public void run() { 
                SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(context); 
                String hostname = sharedPreferences.getString(HOST_NAME, ""); 
                String organizationId = sharedPreferences.getString(ORGANIZATION_ID, ""); 
                final HashMap<String, String> headers = new HashMap<>(); 
                headers.put("Content-Type", "application/json"); 
                final EventTrackingContract eventTrackingContract = new EventTrackingContract(event); 
                Log.d(TAG, eventTrackingContract.toJsonString()); 
                String response = HttpClientWrapper.request(String.format("https://%s/api/v1.0/orgs/%s/pushdatareceiver/events" 

, hostname, organizationId, trackingId), 
                        "POST", headers, eventTrackingContract.toJsonString()); 
                Log.d(TAG, response); 
            } 
        });