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:
- Konfigurowanie aplikacji powiadomienia push
- Mapowanie użytkownika na powiadomienia push
- Rejestracja urządzenia dla powiadomień push
- Otrzymywanie powiadomień push na urządzeniach
- 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);
}
});