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 koşulları

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.
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.
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 son ekleri 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.
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 koşulları

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

  1. SHA-256 algoritmasını kullanarak temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgi (PII) verilerine 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 koşulları

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.

Protokol arabelleği biçimini kullanıyorsanız Timestamp oluştururken seconds ve isteğe bağlı olarak nanos değerini ayarlayın.

Sonraki adımlar