Bu sayfa, Cloud Translation API ile çevrilmiştir.

İletileri Yerelleştirme

Bu dokümanda, Android ve iOS'te kullanıcının dil ayarlarına otomatik olarak uyum sağlayan bildirimler sunmak için FCM yerelleştirme alanlarının (*_loc_key ve *_loc_args) kullanımı açıklanmaktadır. Bu sayede sunucunuz, çeviriyi istemci cihazına devrederek tek bir dil bağımsız yük gönderebilir.

FCM Yerelleştirmeye Genel Bakış

Uygulamanızı yerelleştirmek için kullanıcının uygulamasındaki bir dize kaynağı girişine karşılık gelen bir anahtar gönderebilirsiniz. Cihazın işletim sistemi (OS), dinamik bağımsız değişkenlerin aranmasını ve eklenmesini sağlar.

FCM Alanı	Açıklama	İstemci İşlemi
`title_loc_key`	İstemci uygulamasının dize kaynaklarındaki başlık dizesinin anahtarı.	İşletim sistemi, uygulamanın yerelleştirilmiş dosyalarında ilgili dizeyi bulur.
`body_loc_key`	İstemci uygulamasının dize kaynaklarındaki gövde dizesinin anahtarı.	İşletim sistemi, uygulamanın yerelleştirilmiş dosyalarında ilgili dizeyi bulur.
`title_loc_args`	`title_loc_key` dizesine yerleştirilecek dinamik dize değerleri dizisi.	İşletim sistemi bu bağımsız değişkenleri yerelleştirilmiş dizenin biçim belirleyicilerine ekler.
`body_loc_args`	`body_loc_key` dizesine yerleştirilecek dinamik dize değerleri dizisi.	İşletim sistemi bu bağımsız değişkenleri yerelleştirilmiş dizenin biçim belirleyicilerine ekler.

1. adım: Uygulamalarınızda yerelleştirilmiş dize kaynakları tanımlayın

FCM yerelleştirmeyi kullanmaya başlamak için Android ve iOS projelerinizde gerekli çevirilerin bulunduğundan emin olmanız önemlidir.

Android Kurulumu

Dize kaynaklarını tanımlayın: Varsayılan dil dizelerinizi res/values/strings.xml içine girin. *_loc_args parametresine iletmeyi planladığınız tüm dinamik değerler için biçim belirleyicileri (%1$s, %2$d vb.) kullanın.

Varsayılan (res/values/strings.xml):

<resources>
    <string name="welcome_title">Welcome, %1$s!</string>
    <string name="new_message_body">You have %1$d new message(s) from %2$s.</string>
</resources>

Çeviri ekleme: ISO dil kodlarını kullanarak dile özgü dizinler oluşturun (ör. values-fr (Fransızca için) veya values-es (İspanyolca için) dil kodunu ekleyin ve anahtarları çevirin.

Fransızca (res/values-fr/strings.xml):

<resources>
    <string name="welcome_title">Bienvenue, %1$s!</string>
    <string name="new_message_body">Vous avez %1$d nouveau(x) message(s) de %2$s.</string>
</resources>

Daha fazla bilgi için aşağıdaki dokümanları inceleyin:

iOS Kurulumu

Dize kaynaklarını tanımlama: Temel dizelerinizi Localizable.strings dosyasında (genellikle Base.lproj klasöründe veya bir dize kataloğunda) tanımlayın. Dinamik değerler için biçim belirleyiciler (%@, %ld vb.) kullanın. Tuşlar, kural gereği genellikle büyük harflerle tanımlanır.

Varsayılan (İngilizce Localizable.strings):

"WELCOME_TITLE" = "Welcome, %@!";
"NEW_MESSAGE_BODY" = "You have %ld new message(s) from %@.";

Çeviri ekleme: Dile özgü .lproj klasörleri oluşturun (veya bir dize kataloğu kullanarak yerelleştirmeler ekleyin) ve anahtarları çevirin.

Fransızca (fr.lproj/Localizable.strings):

"WELCOME_TITLE" = "Bienvenue, %@!";
"NEW_MESSAGE_BODY" = "Vous avez %ld nouveau(x) message(s) de %@.";

Daha fazla bilgi için aşağıdaki dokümanları inceleyin:

2. adım: FCM mesaj yükünü oluşturun

Bildirimi FCM HTTP v1 API'sini kullanarak gönderirken sunucunuz, kaynak anahtarlarını (*_loc_key) ve dinamik verileri (*_loc_args) dize dizisi olarak kullanan tek bir yük oluşturur.

Örnek FCM HTTP v1 Yükü

Yerelleştirme anahtarları, platforma özel geçersiz kılma bloklarının (android.notification ve apns.payload.aps.alert) içine yerleştirilir.

{
  "message": {
    "token": "DEVICE_REGISTRATION_TOKEN",

    "android": {
      "notification": {
        // Android keys match strings.xml resource names
        "title_loc_key": "welcome_title",
        "title_loc_args": ["Alice"],
        "body_loc_key": "new_message_body",
        "body_loc_args": ["3", "Bob"]
      }
    },

    "apns": {
      "payload": {
        "aps": {
          "alert": {
            // iOS uses 'title-loc-key' and 'loc-key' (for the body)
            "title-loc-key": "WELCOME_TITLE",
            "title-loc-args": ["Alice"],
            "loc-key": "NEW_MESSAGE_BODY",
            "loc-args": ["3", "Bob"]
          }
        }
      }
    }
  }
}

Yük bağımsız değişkenleri için dikkat edilmesi gereken önemli noktalar

Sıra önemlidir: *_loc_args içindeki dizeler, dize kaynak dosyasındaki yer tutucular tarafından gerekli olan sırayla olmalıdır (ör. %1$s, %2$s).
Yalnızca dizeler: *_loc_args dizisindeki tüm öğeler, sayıları temsil etseler bile (örnekteki "3" gibi) dize olmalıdır. İstemci işletim sisteminin dize biçimlendiricisi, biçim belirleyiciye (%ld veya %1$d) göre son tür dönüştürme işlemini gerçekleştirir.

3. adım: İstemci işleme ve görüntüleme

Cihaz bildirimi aldığında aşağıdaki adımlar otomatik olarak gerçekleşir:

Dil kontrolü: Cihaz, kullanıcının birincil yerel ayarını (ör. Almanca, İtalyanca).
Anahtar arama: İşletim sistemi, cihazın yerel ayarı için uygulamanın kaynak dosyalarında ilgili çevrilmiş dizeyi aramak üzere *_loc_key değerini (welcome_title) kullanır.
Bağımsız değişken ekleme: İşletim sistemi, *_loc_args (["Alice"]) dizisini alır ve değerleri yerelleştirilmiş dizeye eklerken yerel ayarın biçimlendirme kurallarına (noktalama, kelime sırası vb.) uyar.

Cihazın yerel ayarı	`title_loc_key`: welcome_title	`title_loc_args`: ["Alice"]	Son Başlık Görüntüsü
İngilizce	`"Welcome, %1$s!"`	Ayşe	`"Welcome, Alice!"`
Fransızca	`"Bienvenue, %1$s!"`	Ayşe	`"Bienvenue, Alice!"`
Almanca	`"Willkommen, %1$s!"`	Ayşe	`"Willkommen, Alice!"`

Bu işlem, her kullanıcının dil tercihlerine göre uyarlanmış bir mesaj almasını sağlar. Bu mesaj, sunucunuzdan standartlaştırılmış bir yükü korurken doğru dilbilimsel yapıyı kullanır.

Örnek: Yerelleştirme seçenekleri içeren bildirim mesajı

Aşağıdaki örnek gönderme isteği, istemcinin yerelleştirilmiş mesajları göstermesi için yerelleştirme seçenekleri de dahil olmak üzere Tech konusuna bir bildirim gönderir. Kullanıcının cihazındaki görsel efekt örneğini aşağıda görebilirsiniz:

İngilizce ve İspanyolca metin gösteren iki cihazın basit çizimi

Node.js

var topicName = 'industry-tech';

var message = {
  android: {
    ttl: 3600000,
    notification: {
      bodyLocKey: 'STOCK_NOTIFICATION_BODY',
      bodyLocArgs: ['FooCorp', '11.80', '835.67', '1.43']
    }
  },
  apns: {
    payload: {
      aps: {
        alert: {
          locKey: 'STOCK_NOTIFICATION_BODY',
          locArgs: ['FooCorp', '11.80', '835.67', '1.43']
        }
      }
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

REST

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message": {
    "topic":"Tech",
    "android": {
      "ttl":"3600s",
      "notification": {
        "body_loc_key": "STOCK_NOTIFICATION_BODY",
        "body_loc_args": ["FooCorp", "11.80", "835.67", "1.43"]
      }
    },
    "apns": {
      "payload": {
        "aps": {
          "alert": {
            "loc-key": "STOCK_NOTIFICATION_BODY",
            "loc-args": ["FooCorp", "11.80", "835.67", "1.43"]
          }
        }
      }
    }
  }
}'

Daha fazla bilgi edinmek için HTTP v1 referans dokümanlarındaki AndroidNotification ve ApnsConfig bölümlerine bakın. Bu bölümlerde, mesaj gövdesindeki platforma özel bloklarda bulunan anahtarlar hakkında ayrıntılı bilgi verilmektedir. APNS tarafından desteklenen anahtarlar için Apple'ın Payload Key Reference (Yük Anahtarı Referansı) başlıklı makalesine bakın.