Kullanıcı verilerini biçimlendirme

Data Manager API, birden fazla kullanıcı verisi türünün yüklenmesini destekler. Verilerinizin başarıyla alınması ve işlenmesi için her veri öğesiyle ilgili biçimlendirme, karma oluşturma ve kodlama koşullarını uygulayın.

• UserData: E-posta adresi veya telefon numarası gibi kullanıcı tarafından sağlanan veriler.

• IpData: IP adresi ve ilişkili zaman damgaları gibi IP verileri.

• PairData: Yayıncı-Reklamveren Kimlik Eşleşmesi (PAIR) kimlikleri.

• MobileData: Mobil cihazı tanımlayan veriler.

UserData gereksinimleri

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

UserIdentifier
email_address	Biçim string Küçük harfe dönüştürülüyor mu? E-posta adresinde gmail.com veya googlemail.com alanı varsa: @ simgesinden önceki tüm noktaları (.) kaldırın. Yerel kısımdan artı işaretini (+) ve bu işaretten sonra gelen tüm karakterleri kaldırın. Örnek: [e-mail] → [e-mail] E-posta adresinde gmail.com veya googlemail.com dışında bir alan adı varsa nokta ya da artı işaretlerini kaldırmayın. Örnek: [e-mail] → [e-mail] Boşluk Baştaki, sondaki ve aradaki boşlukları kaldırın. Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun ve karma baytlarını 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ı [phone] biçimlendirilip [phone] olarak normalleştirilmelidir. Boşluk Baştaki ve sondaki boşlukları kaldırın. Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun ve karma baytlarını kodlayın.
address	AddressInfo nesnesi AddressInfo biçimlendirme özelliklerine bakın.

AddressInfo biçimi

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

AddressInfo
given_name	Biçim string Küçük harfe dönüştürülüyor mu? 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 ve karma baytlarını 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ı kaldırın. Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun ve karma baytlarını 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 değerini 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ı ve ardından 4 basamaklı uzantı kullanın. 4 haneli bir uzantı kullanmak eşleşme oranınızı artırabilir. Diğer tüm ülkeler için posta kodu uzantılarını kullanmayın. Boşluk Baştaki ve sondaki boşlukları kaldırın. Karma oluşturma postal_code değerini 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 adresindeki sokak ve numara. Küçük harfe dönüştürün. Sembol karakterlerini kaldırın. Boşluk Baştaki ve sondaki boşlukları kaldırın. Karma oluşturma SHA-256 algoritmasını kullanarak karma oluşturun ve karma baytlarını 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 karakterlerini kaldırın. Boşluk Baştaki ve sondaki boşlukları kaldırın. Karma oluşturma city değerini 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ı (ör. ca) veya tam adı (ör. california) kullanın. Küçük harfe dönüştürün. Sembol karakterlerini kaldırın. Boşluk Baştaki ve sondaki boşlukları kaldırın. Karma oluşturma administrative_area değerini karma oluşturma işlemine tabi tutmayın.

IpData gereksinimleri

IpData nesnesi aşağıdaki özelliklere sahiptir.

IpData
ip_address	Biçim string IPv4 veya IPv6 adresi. IPv6 adresleri için 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 değerini karma oluşturma işlemine tabi tutmayın.

PairData gereksinimleri

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

1. SHA-256 algoritmasını kullanarak temiz odada sağlanan kimliği tanımlayabilecek bilgilere (PII) karma oluşturma işlemi uygulayın.

2. PAIR kullanıcı listesi için yayıncı anahtarını kullanarak karma baytları EC değişmeli şifreyle şifreleyin.

3. Şifrelenmiş verileri onaltılık veya Base64 kodlaması kullanarak kodlayın.

MobileData gereksinimleri

Bir MobileData nesnesinin mobile_ids alanını Mobile ID'ler listesiyle doldurun. Mobil kimliklere karma oluşturma işlemi uygulamayın.

Zaman damgası biçimi

Event'nın timestamp ve last_updated_timestamp gibi Timestamp alanları için JSON biçimini kullanıyorsanız RFC 3339 biçimini kullanın. 8 Ağustos 2025, 17:18:44.291 UTC zamanının RFC 3339 biçiminde ve farklı saat dilimlerindeki bazı örnekleri aşağıda 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

• Tokyo, Japonya'nın saat dilimi, UTC'den 9 saat ileridir ve yaz saati uygulaması yoktur: 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, 17:18:44.291 UTC zamanı için seconds ve nanos değerleri şunlardır:

• seconds: 1754683124

• nanos: 291000000

Kodlama

Kodlama şartları, kullanıcı verilerini şifreleyip şifrelemediğinize bağlı olarak farklılık gösterir:

• Şifrelenmemiş kullanıcı verileri: SHA-256 karma baytlarını onaltılık kodlama (hex) veya Base64 kodlama kullanarak kodlayın.

• Şifrelenmiş kullanıcı verileri: Kullanıcı verilerini şifrelerseniz şifrelemeden önce ham karma baytlarını Base64 ile kodlamanız gerekir. Şifreleme öncesi karma için onaltılık kodlama desteklenmez. Ardından, elde edilen şifreli metni onaltılık veya Base64 kodlaması kullanarak kodlayabilirsiniz.

Not: Onaltılık kodlama kullanırken kodlama çıkışının büyük/küçük harf durumu önemli değildir.