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 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 @ simgesinden ö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şturma işlemi uygulayın.
Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
|
|
phone_number |
| Biçim |
string
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şturma işlemi uygulayın.
Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
|
|
address |
|
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şturma işlemi uygulayın.
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 ekler eklemeyin.
|
| Boşluk |
Baştaki ve sondaki boşlukları kaldırın. |
| Karma oluşturma |
SHA-256 algoritmasını kullanarak karma oluşturma işlemi uygulayın.
Karma baytlarını onaltılık veya Base64 kodlaması kullanarak kodlayın.
|
|
region_code |
| Biçim |
string
|
| 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 ardından 4 basamaklı bir uzantı gelen 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. |
|
IpData nesnesi aşağıdaki özelliklere sahiptir.
| IpData |
ip_address |
| Biçim |
string
IPv4 veya IPv6 adresi.
IPv6 adreslerinde büyük/küçük harf kullanımı önemli değildir (büyük veya küçük harf kullanılabilir).
|
| Boşluk |
Baştaki ve sondaki boşlukları kaldırın. |
| Karma oluşturma |
ip_address öğesini karma oluşturmayın. |
|
PairData nesnesinin pair_ids alanını kimlik listesiyle doldurun.
Aşağıdaki adımları kullanarak listedeki her öğeyi biçimlendirin:
- Temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgi verilerine SHA-256 algoritmasını kullanarak karma oluşturma işlemi uygulayın.
- Karma baytlarını, PAIR kullanıcı listesi için yayıncı anahtarını kullanarak bir EC değişmeli şifreyle şifreleyin.
- Şifrelenmiş verileri onaltılık veya Base64 kodlaması kullanarak kodlayın.
MobileData nesnesinin mobile_ids alanını mobil kimlikler listesiyle doldurun. Mobil kimliklere karma oluşturma uygulamayın.
Timestamp alanları için JSON biçimini kullanıyorsanız (ör. Event öğesinin timestamp ve last_updated_timestamp alanları) 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şturulurken 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: 1754683124nanos: 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.
