Kullanıcı verilerini biçimlendirme

Veri Yöneticisi API'si, birden fazla kullanıcı verisi türünün yüklenmesini destekler. Verilerinizin başarılı bir şekilde alınması ve işlenmesi için her veri öğesiyle ilgili biçimlendirme, karma oluşturma ve kodlama koşullarına uyun.

UserData şartları

UserData nesnesi, UserIdentifier nesnelerinin bir koleksiyonudur. Her UserIdentifier, aşağıdaki tablodaki özelliklerden tam olarak birine sahiptir.

UserIdentifier
email_address
Biçim
string
Küçük harfe dönüştürün.
E-posta adresinde gmail.com veya googlemail.com alanı varsa @ sembolünden önceki tüm noktaları (.) kaldırın.
Boşluk Baştaki, sondaki ve aradaki boşlukları kaldırın.
Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun. Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
phone_number
Biçim
string
E.164 biçimini kullanın.
Artı işaretini (+) ve ülke kodunu ekleyin. Artı işaretinden sonraki tüm karakterler rakam olmalıdır.
Örneğin, ABD telefon numarası (800)555-0100 +18005550100 olarak biçimlendirilmeli ve normalleştirilmelidir.
Boşluk Baştaki ve sondaki boşlukları kaldırın.
Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun. Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
address

AddressInfo biçimi

UserIdentifier öğesinin address özelliğini oluşturmak için aşağıdaki biçimlendirme kurallarını kullanın.

AddressInfo
given_name
Biçim
string
Küçük harfe dönüştürün.
Mrs. gibi önekler eklemeyin.
Boşluk Baştaki ve sondaki boşlukları kaldırın.
Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun. Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
family_name
Biçim
string
Küçük harfe dönüştürün.
Jr. gibi ekleri dahil etmeyin.
Boşluk Baştaki ve sondaki boşlukları kaldırın.
Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun. Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
region_code
Biçim
string
İki karakterli ISO-3166-1 alfa-2 kodu.
Boşluk Baştaki ve sondaki boşlukları kaldırın.
Karma oluşturma region_code öğesini karma oluşturmayın.
postal_code
Biçim
string
Hem ABD hem de uluslararası posta kodlarına izin verilir.
ABD adresleri için 5 basamaklı veya 5 basamaklı olup 4 basamaklı uzantıyla devam eden bir posta kodu kullanın. 4 haneli bir uzantı kullanmak eşleşme oranınızı artırabilir.
Diğer tüm ülkelerde posta kodu uzantılarını kullanmayın.
Boşluk Baştaki ve sondaki boşlukları kaldırın.
Karma oluşturma postal_code öğesini karma oluşturmayın.

PairData şartları

PairData nesnesinin pair_ids alanını kimlik listesiyle doldurun. Listedeki her öğeyi aşağıdaki adımları kullanarak biçimlendirin:

  1. Temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgi (PII) verilerine SHA-256 algoritmasını kullanarak karma oluşturma işlemi uygulayın.
  2. PAIR kullanıcı listesi için yayıncı anahtarını kullanarak karma baytlarını EC değişmeli şifreyle şifreleyin.
  3. Şifrelenmiş verileri onaltılık veya Base64 kodlaması kullanarak kodlayın.

MobileData şartları

MobileData nesnesinin mobile_ids alanını mobil kimlikler listesiyle doldurun. Mobil kimlikler için karma oluşturmayın.

Zaman damgası biçimi

Timestamp alanları (ör. Event öğesinin timestamp ve last_updated_timestamp) için JSON biçimini kullanıyorsanız RFC 3339 biçimini kullanın. Aşağıda, 8 Ağustos 2025'te saat 17:18:44.291'in RFC 3339 biçiminde ve farklı saat dilimlerindeki UTC saatiyle ilgili bazı örnekler verilmiştir:

  • UTC saat dilimi: 2025-08-08T17:18:44.291Z
  • EDT saat dilimi, o sırada UTC'den 4 saat önceydi: 2025-08-08T13:18:44.291-04:00
  • PDT saat dilimi, o sırada UTC'den 7 saat önceydi: 2025-08-08T10:18:44.291-07:00
  • UTC'den 9 saat ileride olan ve yaz saati uygulaması kullanmayan Tokyo, Japonya'nın saat dilimi: 2025-08-08T22:18:44.291+09:00

Protokol arabelleği biçimini kullanıyorsanız Timestamp oluştururken seconds ve isteğe bağlı olarak nanos değerini ayarlayın. 8 Ağustos 2025 saat 17:18:44.291 (UTC) için seconds ve nanos değerleri aşağıda verilmiştir:

  • seconds: 1754683124
  • nanos: 291000000

Kodlama

Verileri kodlarken aşağıdakileri göz önünde bulundurun:

  • Onaltılık kodlama (hex) kullanılırken kodlama çıkışının büyük/küçük harf durumu önemli değildir.
  • Base64 kodlama kullanılırken kodlama çıkışının büyük/küçük harf durumu önemlidir.

Sonraki adımlar