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öndermearrow_forward

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ılar için Hedefleri hazırlama bölümüne bakın.

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çinde 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 etme: Eşzamansız işleme teşhislerini alın ve requestStatus.retrieve ile besleme durumunu doğrulayın.

Kullanım alanları

Data Manager API ile önerilen ve özel etkinlikleri göndermenin bazı kullanım alanları şunlardır:

• 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 saat 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şturma talimatları için Kullanıcı tarafından sağlanan verileri ekleme bölümüne bakın.

Entegrasyonla ilgili dikkat edilmesi gereken noktalar

Data Manager API'yi 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, etiketlemeden elde edilen en güncel coğrafi ve cihaz bilgilerini clientId veya appInstanceId kullanarak Data Manager API etkinlikleriyle 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 Google Analytics'e yalnızca Data Manager API ile göndermek mümkün olsa da yalnızca kısmi raporlama kullanılabilir. Data Manager API'nin 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, Google Analytics kullanıcı arayüzünde yapılandırılan kurallara benzer şekilde, Data Manager API aracılığıyla özel etkinlikler gönderme mantığını uygulamalıdır.