Ana içeriğe atla

​
Genel Bakış

BlueConic webhook’ları, sitenizde belirli olaylar gerçekleştiğinde profil veya segment verilerini OneSignal’a gerçek zamanlı olarak senkronize etmenize olanak tanır. Bu kılavuz, Kullanıcıyı güncelle API’si aracılığıyla OneSignal’a veri göndermek için BlueConic’in nasıl yapılandırılacağını gösterir.

​
Gereksinimler

  • OneSignal etkin bir Web Uygulaması. Başlamak için Web push kurulumu’na bakın.

​
Kurulum

BlueConic ve OneSignal arasında kullanıcı verilerini senkronize etmek için, her iki platformda da kullanıcıları ilişkilendirmek üzere ortak bir tanımlayıcı bulunmalıdır. BlueConic, BlueConic Kimliği adlı benzersiz bir tanımlayıcı oluşturur ve bu, verileri senkronize etmek için OneSignal’daki bir kullanıcıya bağlanabilir.

​
Güncelleme betiği

Kullanıcılarınızı BlueConic Kimlikleri kullanarak tanımlamak için özel bir takma ad oluşturmanızı öneririz. Yeni bir takma ad atamadan önce, kullanıcının önce OneSignal’da oturum açmış olduğundan emin olun. Aşağıdaki kod, BlueConic Kimliğini bir Takma Ad ve bir Harici Kimlik kullanarak OneSignal kullanıcısıyla ilişkilendirme örnekleri sağlar. 
// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Ensure the user is logged in
// Logged in users will have an External ID
if (!OneSignal.User.externalId) {
await OneSignal.login("EXTERNAL_ID_FROM_YOUR_BACKENED");
}

// External ID must exist before calling this method
OneSignal.User.addAlias('blueconic_profile_id', blueConicId);
Sisteminiz birincil tanımlayıcı olarak BlueConic Kimliklerini kullanıyorsa, bunu OneSignal.login’e geçirin. 
// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Set OneSignal External ID to BlueConic ID
OneSignal.login(blueConicId);

​
Webhook’ları ekleyin

Özel ihtiyaçlarınıza göre BlueConic’ten OneSignal’a veri senkronize etmek için webhook’ları kullanın. Aşağıdaki örnekler, bunu başarmak için Kullanıcıyı güncelle API’sinin nasıl kullanılacağını gösterir. API ayrıntıları
URLhttps://api.onesignal.com/apps/<APP_ID>/users/by/alias_label/alias_value
MethodPATCH
AuthorizationBasic <API_KEY>
Sisteminiz birincil tanımlayıcı olarak BlueConic Kimliğini kullanıyorsa… Bunun yerine aşağıdaki URL’yi kullanın: https://api.onesignal.com/apps/<APP_ID>/users/by/external_id/{{blueconic_profile_id}}

​
Profil özelliklerini senkronize etme

Etiketler’i ve diğer kullanıcı verilerini ayarlayarak BlueConic profil verilerini OneSignal’a senkronize edin.

Etiketleri güncelleme için örnek yapılandırma

Yük 
{
  "properties": {
    "tags": {
      "tag_name_at_onesignal": "{{BLUECONIC_PROPERTY}}"
    }
  }
}

​
Segmentleri senkronize etme

Etiketler’i ayarlayarak BlueConic segment verilerini OneSignal’a senkronize edin. Doğrudan OneSignal içinde segmentler oluşturmak için bu etiketleri kullanın.

Segmentleri senkronizasyonda tutmak için örnek yapılandırma

Yük 
{
  "properties": {
    "tags": {
      "early_bird": "Yes",
    }
  }
}
Etiketleri early_bird veya başka herhangi bir açıklayıcı etiket gibi belirli ihtiyaçlara göre adlandırabilirsiniz. Ancak, BlueConic ve OneSignal’daki segmentler arasında tutarlılık için etikete atanan değer her zaman Yes gibi sabit kodlanmış olmalıdır.