Google Analytics'te önerilen ve özel etkinlikler

Google Analytics önerilen ve özel etkinliklerini göndermek için Data Manager API'yi kullanın.

Ayrıntılı bilgi için Etkinlik gönderme başlıklı makaleyi inceleyin.

Google Analytics Measurement Protocol'den yükseltme yapıyorsanız talimatlar için Measurement Protocol'den Data Manager API'ye yükseltme başlıklı makaleyi inceleyin.

Kullanım alanları

Data Manager API ile önerilen ve özel etkinlikler göndermeye yönelik bazı kullanım alanlarını aşağıda bulabilirsiniz:

• Online davranışlarla çevrimdışı davranışları ilişkilendirebilirsiniz.

• Hem istemci tarafındaki hem de sunucu tarafındaki etkileşimleri ölçme

• Standart kullanıcı etkileşimlerinin dışında gerçekleşen etkinlikleri (ör. çevrimdışı dönüşümler) gönderme

• Kiosk ve kol saati gibi, otomatik toplamanın kullanılamadığı cihaz ve uygulamalardan etkinlik gönderme

Kullanıcı tarafından sağlanan veriler

Karma oluşturma işlemi uygulanmış e-posta adresleri, telefon numaraları ve fiziksel adresler gibi birinci taraf müşteri verilerini bir Event öğesinin userData alanında gönderebilirsiniz. Bu, Google Analytics'te dönüşüm ölçümünü, ilişkilendirmeyi ve kitle oluşturmayı iyileştirmeye yardımcı olur.

Kullanıcı tarafından sağlanan verileri gönderirken aşağıdakileri göz önünde bulundurun:

• Etkinliklerle birlikte gönderilir: Data Manager API'de kullanıcı tarafından sağlanan veriler, Event parçası olarak gönderilmelidir. Etkinlik içermeyen bağımsız yüklemeler desteklenmez.

• Biçimlendirme ve karma oluşturma: Kişisel tanımlayıcılar (ör. e-posta adresi, telefon numarası, ad ve açık adres) yüklenmeden önce normalleştirilmeli ve SHA-256 kullanılarak karma oluşturma işlemine tabi tutulmalıdır. Diğer alanlar (ör. şehir, eyalet veya il, posta kodu ve ülke kodu) normalleştirilir ancak karma oluşturma işlemi uygulanmaz. Belirli koşullar için Kullanıcı verilerini biçimlendirme kılavuzunu inceleyin.

• Şifreleme: Karma oluşturma işlemi uygulanmış kullanıcı verilerini isteğe bağlı olarak şifreleyebilirsiniz.

• User-ID: Tutarlı bir kullanıcı tanımlayıcısı mevcut olduğunda userData ile birlikte userId değerini sağlamanızı öneririz.

• Uygulama: İstek oluşturmayla ilgili talimatlar için Kullanıcı tarafından sağlanan verileri ekleme başlıklı makaleyi inceleyin.

Entegrasyonla ilgili dikkat edilmesi gereken noktalar

Veri Yöneticisi API'sini kullanırken aşağıdaki hususları göz önünde bulundurun.

Yeniden Pazarlama

Google sinyallerini etkinleştirdiğinizde Google Analytics, aynı cihazda yeniden pazarlamayı destekler. Cihazlar arası yeniden pazarlama için userId gereklidir.

Ayrıca, birinci taraf kitle eşleştirmeyi etkinleştirmek için kullanıcı tarafından sağlanan verileri gönderebilirsiniz.

Reklam kimlikleri

Google Analytics, clientId veya appInstanceId kullanılarak Data Manager API etkinlikleriyle kurulan online etkileşimler sırasında toplanan reklamcılık tanımlayıcılarını (ör. GBRAID veya WBRAID) otomatik olarak birleştirir.

Gizlilik ayarları

Google Analytics, "kişiselleştirilmemiş reklamlar" ve "reklam izlemeyi sınırlama" gibi kullanıcı gizliliği ayarlarını uygulamak için clientId veya appInstanceId kullanarak Data Manager API etkinliklerini online etkileşimlerle birleştirir.

Ayrıca, consent nesnesini kullanarak kullanıcı izni ayarlarını doğrudan her etkinlikte belirtebilirsiniz.

Coğrafi ve cihaz bilgileri

Google Analytics, clientId veya appInstanceId kullanılarak Data Manager API etkinlikleriyle etiketlemeden elde edilen en son coğrafi ve cihaz bilgilerini otomatik olarak birleştirir. Bu sayede, Data Manager API etkinliklerinizin coğrafi ve cihaz boyutlarını içeren raporlara yansıtılması sağlanır.

Bir Data Manager API etkinliğinin clientId veya appInstanceId için en son bilgiler yerine belirli bir oturumdaki coğrafi ve cihaz bilgilerini yansıtmasını istiyorsanız parameterName değerinin session_id, value değerinin ise belirli oturumun kimliği olarak ayarlandığı bir girişi additionalEventParameters'ye ekleyin ve etkinliği oturumun başlamasından sonraki 24 saat içinde gönderin.

Data Manager API'yi kullanarak etkinlikler için coğrafi bilgiler ve cihaz bilgileri sağlayabilirsiniz.

Sunucudan sunucuya tam entegrasyon

Etkinlikleri yalnızca Data Manager API'si ile Google Analytics'e göndermek mümkün olsa da yalnızca kısmi raporlama kullanılabilir. Data Manager API'sinin amacı, gtag, Etiket Yöneticisi veya Firebase kullanılarak toplanan mevcut etkinlikleri artırmaktır. Bazı etkinlik ve parametre adları, otomatik toplama aracılığıyla kullanılmak üzere ayrılmıştır ve Data Manager API aracılığıyla gönderilemez.

Etkinlik oluşturma veya yeniden adlandırma

Data Manager API ile gönderilen etkinlikler, etkinlik oluşturma veya yeniden adlandırma kurallarını tetiklemez. Uygulamanız, özel etkinlikleri Data Manager API aracılığıyla göndermek için Google Analytics kullanıcı arayüzünde yapılandırılan kurallara benzer bir mantık uygulamalıdır.