Google Analytics'te önerilen ve özel etkinlikler

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

Önerilen ve özel etkinlikleri gönderme

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

İş akışına genel bakış

Data Manager API ile etkinlik verileri göndermek için aşağıdaki adımları uygulayın:

1. Hedefleri hazırlama: Hedef hesabı ve dönüşüm ya da etkinlik hedefini belirtmek için besleme isteğinin destinations alanı için Destination nesnelerini tanımlayın. Ayrıntılı bilgi için Hedefleri hazırlama başlıklı makaleyi inceleyin.

2. Etkinlik verilerini ve tanımlayıcıları hazırlama: Event alanlarını etkinlik ayrıntıları ve gerekli tanımlayıcılarla (reklam tıklaması, istemci veya uygulama örneği tanımlayıcıları gibi) doldurun. userData içine kullanıcı iletişim bilgilerini eklerseniz tanımlayıcıları biçimlendirme yönergelerine göre normalleştirin ve SHA-256 karma oluşturma işlemi uygulayın. İsteğe bağlı olarak bunları şifreleyebilirsiniz. Ayrıntılar için Etkinlik verilerini hazırlama başlıklı makaleyi inceleyin.

3. Besleme isteğini oluşturup gönderme: destinations, Event kayıtlarınızı ve userData'yi şifrelediyseniz encryptionInfo'nizi içeren bir events.ingest isteği gönderin. Üretim verilerini göndermeden önce yükünüzü hızlı başarısızlık hataları açısından test etmek için validateOnly: true kullanın. Alan şartları ve kod örnekleri için Etkinlik gönderme bölümüne bakın.

4. Teşhisleri kontrol edin: Asenkron işleme teşhislerini alın ve requestStatus.retrieve ile alım durumunu doğrulayın.

Kullanım alanları

Önemli nokta: Data Manager API'sinin amacı, gtag, Etiket Yöneticisi ve Firebase İçin Google Analytics aracılığıyla otomatik toplama işleminin yerini almak değil, bu işlemi desteklemektir.

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 nesnesinin userData alanında gönderebilirsiniz. Bu sayede Google Analytics'te dönüşüm ölçümü, ilişkilendirme ve kitle oluşturma iyileştirilir.

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 bir Event kapsamında gönderilmelidir. Etkinlik içermeyen bağımsız yüklemeler desteklenmez.

• Biçimlendirme ve karma oluşturma: Kişisel tanımlayıcılar (e-posta adresi, telefon numarası, ad ve açık adres gibi) yüklenmeden önce SHA-256 kullanılarak normalleştirilmeli ve karma oluşturma işlemine tabi tutulmalıdır. Diğer alanlar (şehir, eyalet veya il, posta kodu ve ülke kodu gibi) normalleştirilir ancak karma oluşturma işlemine tabi tutulmaz. Belirli şartlar 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ı kimliği mevcut olduğunda userData ile birlikte userId parametresini de 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 Analytics, Google sinyallerini etkinleştirdiğinizde 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, online etkileşimler sırasında toplanan reklam kimliklerini (ör. GBRAID veya WBRAID) clientId ya da appInstanceId kullanarak Data Manager API etkinlikleriyle otomatik olarak birleştirir.

Gizlilik ayarları

Google Analytics, "kişiselleştirilmemiş reklamlar" ve "reklam takibini sınırla" 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ı rızası ayarlarını doğrudan her etkinlikte belirtebilirsiniz.

Coğrafi bilgiler 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 etkinlikleriniz coğrafi ve cihaz boyutlarını içeren raporlara yansıtılır.

Bir Data Manager API etkinliğinin, clientId veya appInstanceId ile ilgili en son bilgiler yerine belirli bir oturumdaki coğrafi bilgileri ve cihaz bilgilerini yansıtmasını istiyorsanız additionalEventParameters bölümüne parameterName, session_id olarak ve value, belirli oturumun kimliği olarak ayarlanmış bir giriş ekleyin ve etkinliği oturumun başlangıcından itibaren 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 yoluyla 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.