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ün. E-posta adresinin alan adı gmail.com veya googlemail.com ise: @ simgesinden önceki tüm noktaları (.) kaldırın. Yerel kısımdan artı işaretini (+) ve ondan sonra gelen tüm karakterleri kaldırın. Örnek: [e-mail] → [e-mail] E-posta adresinin alanı gmail.com veya googlemail.com değilse 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çimlendirilmeli ve [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ştururken 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 ve karma baytlarını kodlayın.
family_name	Biçim string Küçük harfe dönüştürün. Jr. gibi ekler kullanmayı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.
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ı içeren bir posta kodu 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 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 değerini karma oluşturma işlemine tabi tutmayın.

PairData gereksinimleri

Bir 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 bilgiler (PII) verilerine 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

• O sırada UTC'den 7 saat önce olan PDT saat dilimi: 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: On altılık kodlama (on altılık) veya Base64 kodlama kullanarak SHA-256 karma baytlarını 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.