Data Manager API, 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 adı varsa:
@ simgesinden önceki tüm noktaları (.)
kaldırın.- Yerel bölümden artı işaretini (
+) ve ardından gelen tüm karakterleri kaldırın.
- Örnek:
cloudy.sanfrancisco+shopping@gmail.com →
cloudysanfrancisco@gmail.com
- E-posta adresinde
gmail.com veya googlemail.com dışında bir alan varsa nokta ya da artı işaretlerini kaldırmayın.
- Örnek:
user.name+NYC@Example.com →
user.name+nyc@example.com
|
| Boşluk |
Baştaki, sondaki ve aradaki boşlukları kırpı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ı kırpı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ı kırpı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 son ekleri dahil etmeyin.
|
| Boşluk |
Baştaki ve sondaki boşlukları kırpı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ı kırpın. |
| Karma oluşturma |
region_code öğesini karma oluşturma işlemine tabi tutmayı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ı kırpın. |
| Karma oluşturma |
postal_code öğesini karma oluşturma işlemine tabi tutmayın. |
|
address_line |
| Biçim |
string
Yalnızca Google Analytics için kullanılır.
Kullanıcının adresinin bulunduğu sokak ve numara.
Küçük harfe dönüştürün.
Sembol karakterleri kaldırın.
|
| Boşluk |
Baştaki ve sondaki boşlukları kırpı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.
|
|
city |
| Biçim |
string
Yalnızca Google Analytics için kullanılır.
Kullanıcının adresinin bulunduğu şehir.
Küçük harfe dönüştürün.
Sembol karakterleri kaldırın.
|
| Boşluk |
Baştaki ve sondaki boşlukları kırpın. |
| Karma oluşturma |
city öğesini karma oluşturma işlemine tabi tutmayın. |
|
administrative_area |
| Biçim |
string
Yalnızca Google Analytics için kullanılır.
Kullanıcının adresinin bağlı olduğu yer (eyalet veya il).
İki harfli kısaltmayı (örneğin, ca) veya tam adı (örneğin, california) kullanın.
Küçük harfe dönüştürün.
Sembol karakterleri kaldırın.
|
| Boşluk |
Baştaki ve sondaki boşlukları kırpın. |
| Karma oluşturma |
administrative_area öğesini karma oluşturma işlemine tabi tutmayın. |
|
Bir 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ı kırpın. |
| Karma oluşturma |
ip_address öğesini karma oluşturma işlemine tabi tutmayı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 bilgilere (PII) SHA-256 algoritmasını kullanarak karma oluşturma işlemi uygulayın.
- PAIR kullanıcı listesi için yayıncı anahtarını kullanarak karma baytlarını EC değişmeli şifreyle şifreleyin.
- Şifrelenmiş verileri onaltılık veya Base64 kodlaması kullanarak kodlayın.
MobileData nesnesinin mobile_ids alanını bir mobil kimlik listesiyle doldurun. Mobil kimliklere karma oluşturma işlemi 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'deki UTC zamanının RFC 3339 biçiminde ve farklı saat dilimlerinde gösterildiği 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ı olmayan Tokyo, Japonya'nın saat dilimi:
2025-08-08T22:18:44.291+09:00
Protocol 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'in UTC saati 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 kodlaması kullanılırken kodlama çıkışının büyük/küçük harf durumu önemlidir.
