Tüm Ürünler
Search

Bu Ürün

    Direct Mail:SMTP kullanarak etikete göre e-posta açılma verilerini izleyin

    Belge Merkezi

    Direct Mail:SMTP kullanarak etikete göre e-posta açılma verilerini izleyin

    Son Güncelleme:Oct 04, 2026

    Giden her e-postayı adlandırılmış bir etiketle işaretleyin; ardından SMTP gönderim akışınızı değiştirmeden konsolda bu etikete ait açılma ve tıklama etkileşimlerini izleyin.

    Ön koşullar

    Başlamadan önce şunlara sahip olduğunuzdan emin olun:

    • Direct Mail konsolunda oluşturulmuş bir etiket. İzleme üst bilgisindeki TagName değeri, mevcut bir etiketle eşleşmelidir.

    • Gönderim temel hattınız olarak yapılandırdığınız SMTP Java çağrı örneği.

    İzleme özelliğini etkinleştirmeyle ilgili ayrıntılar için bkz. Veri izleme özelliği nasıl etkinleştirilir.

    Bağımlılıkları ekleyin

    Maven projenize aşağıdaki bağımlılıkları ekleyin. Kod, izleme parametrelerini JSON olarak seri hale getirmek için Gson'u ve sonucu Base64 ile kodlamak için commons-codec'i kullanır.

    <dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.6</version>
</dependency>
<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.2</version>
</dependency>

    İzleme üst bilgisini ayarlayın

    Aşağıdaki alanları içeren bir JSON nesnesi oluşturun, bunu Base64 ile kodlayın ve her mesaja X-AliDM-Trace üst bilgisi olarak ekleyin.

    İzleme üst bilgisi alanları


    Alan


    Kabul edilen değerler


    Açıklama


    OpenTrace


    "1" — etkinleştir; "0" — devre dışı bırak


    E-postayı kaç alıcının açtığını izler. Görünmez bir piksel kullanır; e-posta istemcisinde görüntülerin etkinleştirilmesini gerektirir.


    LinkTrace


    "1" — etkinleştir; "0" — devre dışı bırak


    E-postadaki bağlantılara kaç alıcının tıkladığını izler. Bağlantıları izlenen URL'lerle değiştirir; hem HTML hem de düz metin e-postalarda çalışır.


    TagName


    Konsolda oluşturulan herhangi bir etiket adı


    Açılma ve tıklama verilerini konsolda bu etiket altında gruplandırır. Mevcut bir etiketle tam olarak eşleşmelidir.
    Not

    TagName değeri, Direct Mail konsolunda zaten var olan bir etiketle eşleşmelidir. Ad mevcut bir etiketle eşleşmezse, bu mesaja ait izleme verileri sessizce atılır.

    Kod örneği

    // Set the tracking header to enable open and click tracking.
// For prerequisites and constraints, see "How to enable the data tracking feature".
String tagName = "Test";
HashMap<String, String> trace = new HashMap<>();
trace.put("OpenTrace", "1");    // Enable email open tracking.
trace.put("LinkTrace", "1");    // Enable URL click tracking in emails.
trace.put("TagName", tagName);  // The tag name created in the console.
String jsonTrace = new GsonBuilder().setPrettyPrinting().create().toJson(trace);
String base64Trace = new String(Base64.getEncoder().encode(jsonTrace.getBytes()));
// Set the tracking header.
message.addHeader("X-AliDM-Trace", base64Trace);
// Example value in the raw EML file: X-AliDM-Trace: eyJUYWdOYW1lIjoiVGVzdCIsIk9wZW5UcmFjZSI6IjEiLCJMaW5rVHJhY2UiOiIxIn0=

    E-posta gönderildikten sonra açılma ve tıklama etkileşim verileri, konsolda belirttiğiniz etiket adına göre gruplanmış şekilde gerçek zamanlı olarak görünür.

    Sonraki adımlar