{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Engage Studio","type":"markdown"},"seo":{"title":"Email Delivery Events Table | Engage Studio","description":"Reference for the Engage Studio email delivery events table schema, including output column mapping, td_log_* custom non-PII identifier columns, and account-level PII suppression options.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"email-delivery-events-table","__idx":0},"children":["Email Delivery Events Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Engage Studio is a powerful feature designed to help marketers create and manage effective email campaigns within the Treasure Data CDP. A key aspect of successful email marketing is the ability to track performance. Engage Studio provides ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email Delivery Performance Insights"]}," by automatically collecting detailed email metrics.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"These valuable email metrics are stored automatically for each email domain you use in your dedicated Treasure Data table. This table allows you to analyze the outcomes of your email sends at a granular level."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your email performance data is stored in your Treasure account in the following location:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Database:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_email_<your email domain>"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Table:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schema of the Email Performance ("]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[") Table"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," table contains various columns that capture detailed information about each event that occurs during your email campaigns. The schema of this table includes the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]}," (int): Equivalent to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_timestamp"]},", representing the time."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_sender_id"]}," (string): The ID of the sender."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_domain_id"]}," (string): The ID of the email domain."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_domain"]}," (string): The email domain used for sending."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message_id"]}," (string): A unique ID assigned to the message by Amazon SES upon a successful send request. This is the ID Amazon SES returned when the message was sent. Note that Amazon SES also includes this ID in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commonHeaders"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mail"]}," object."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_template_id"]}," (string): The Email Template ID used for the message. You can find this ID in the URL path when editing an email template in Engage Studio."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," (string): The FROM email address."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]}," (string): The TO email address of the recipient. This is one of the email addresses listed as recipients of the original mail."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_plain_address"]}," (string): The recipient's email address in a simple format, even if a display name was originally included."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]}," (string): The subject line of the email. This can be found in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commonHeaders"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mail"]}," object."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}," (string): The date and time at which the original message was sent (in ISO8601 format)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_type"]}," (string): A crucial field indicating the type of event that occurred. This field describes different outcomes for each email sent."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_reporting_mta"]}," (string): The Mail Transfer Agent (MTA) address for deliveries. In Amazon SES, this is the hostname of the SES mail server that sent the mail."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_smtp_response"]}," (string): The MTA log for deliveries. This is the SMTP response message from the remote ISP that accepted the email from Amazon SES."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_processing_time_millis"]}," (long): Time taken for delivery processing in milliseconds. This is the time between Amazon SES accepting the request and passing the message to the recipient's server."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_timestamp"]}," (string): The time when the email was delivered."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_user_agent"]}," (string): The Email Client User Agent used when the email was opened."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_timestamp"]}," (string): The time when the email was opened."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_ip_address"]}," (string): The IP address where the receiver opened the email."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_user_agent"]}," (string): The Email Client User Agent used when the email was clicked."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]}," (string): The time when the email was clicked."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_ip_address"]}," (string): The IP address where the receiver clicked the email."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_link"]}," (string): The full URL of the link that was clicked by the recipient. This field provides valuable analytics data to understand which content drives engagement."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_reporting_mta"]}," (string): The IP address of the MTA that attempted delivery before a bounce occurred."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_feedback_id"]}," (string): A unique ID associated with the bounce."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_timestamp"]}," (string): Time when it is marked as Bounce."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_subtype"]}," (string): The subtype of the bounce."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_type"]}," (string): The type of bounce (Undetermined, Permanent, or Transient)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_recipient_status"]}," (string): The value of the Status field from the DSN. This is the per-recipient transport-independent status code that indicates the delivery status of the message."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_recipient_action"]}," (string): The value of the Action field from the DSN. This indicates the action performed by the Reporting-MTA as a result of its attempt to deliver the message to this recipient."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_recipient_address"]}," (string): A list that contains information about the recipients of the original mail that bounced"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_recipient_diagnostic_code"]}," (string): The status code issued by the reporting MTA. This is the value of the Diagnostic-Code field from the DSN. This field may be absent in the DSN (and therefore also absent in the JSON)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_timestamp"]}," (string): The date and time when the delivery delay occurred, in ISO8601 format."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_type"]}," (string): The type of delay (e.g., MailboxFull, MessageTooLarge, TransientCommunicationFailure)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_recipient_address"]}," (string): The email address that resulted in the delivery of the message being delayed."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_recipient_status"]}," (string): The SMTP status code associated with the delivery delay. This is the per-recipient transport-independent status code."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_recipient_diagnostic_code"]}," (string): The diagnostic code provided by the receiving MTA. This provides additional information about the delay."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_expiration_time"]}," (string): The date and time when Amazon SES will stop trying to deliver the message, shown in ISO8601 format."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaint_timestamp"]}," (string): The date and time, in ISO8601 format (YYYY-MM-DDThh:mm:ss.sZ), when the ISP sent the complaint notification."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaint_feedback_id"]}," (string): A unique ID for the complaint."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaint_user_agent"]}," (string): The value of the User-Agent field from the feedback report. This indicates the name and version of the system that generated the report."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaint_feedback_type"]}," (string): The value of the Feedback-Type field from the feedback report received from the ISP. This contains the type of feedback."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaint_arrival_date"]}," (string): The value of the Arrival-Date or Received-Date field from the feedback report in ISO8601 format (YYYY-MM-DDThh:mm:ss.sZ). This field may be absent in the report (and therefore also absent in the JSON)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reject_reason"]}," (string): The reason the email was rejected. The only possible value is Bad content, which means that Amazon SES detected that the email contained a virus. When a message is rejected, Amazon SES stops processing it, and doesn't attempt to deliver it to the recipient's mail server."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failure_error_message"]}," (string): A message that provides more information about the rendering failure."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_event_id"]}," (string): ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Any Campaign ID that is used for performance calculation"]},". Using this identifier helps track email campaigns properly, for example, within a Customer Journey Orchestration (CJO) scenario. This ID is set when configuring an email activation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test_mode"]}," (boolean): True indicates that the email is sent by SendTest feature"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaign_id"]}," (string): The campaign ID when sending an email using the campaign function."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaign_name"]}," (string): The campaign name when sending an email using the campaign function."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Understanding Email Event Types"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_type"]}," column is essential for monitoring your sending activity and understanding campaign performance. It categorizes the outcome of each email sent. Here are the possible values you will find in this column and what they signify, along with related information captured in the table:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]}," : The request to send the email was successful, and Amazon SES will attempt delivery. Even if delivery is suppressed by a suppression, it is still counted as a send."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delivery"]}," : Amazon SES successfully delivered the email to the recipient's mail server. The delivery object includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}," of delivery (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_timestamp"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processingTimeMillis"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_processing_time_millis"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipients"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smtpResponse"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_smtp_response"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportingMTA"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_reporting_mta"]},"), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remoteMtaIp"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bounce"]}," : Indicates a permanent or transient bounce where the recipient's mail server rejected the email. Permanent bounces mean you should remove the recipient from your list as future sends are unlikely to succeed and can negatively impact your sender reputation. Transient bounces might be successfully delivered later if the temporary issue is resolved."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Complaint"]}," : The email was delivered, but the recipient marked it as spam. The complaint object includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complainedRecipients"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["feedbackId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaintSubType"]},", and optionally ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userAgent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaintFeedbackType"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrivalDate"]}," from a feedback report. Note that most ISPs redact the specific email address that complained, so the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complainedRecipients"]}," list includes recipients on the domain that issued the complaint. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complaintFeedbackType"]}," can indicate the reason for the complaint (e.g., abuse, fraud, virus)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeliveryDelay"]}," : The email delivery was temporarily delayed due to an issue, such as a full inbox or a transient server issue. The delivery delay object includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayType"]}," (e.g., MailboxFull, MessageTooLarge), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayedRecipients"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expirationTime"]}," (when SES stops trying to deliver), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reportingMTA"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open"]}," : The recipient opened the message in their email client. This relies on open pixel tracking for HTML emails. The open object includes the recipient's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ipAddress"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_ip_address"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_timestamp"]},"), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userAgent"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_user_agent"]},"). Note that open tracking only works with HTML emails; text-only email clients do not provide this metric."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click"]}," : The recipient clicked one or more links in the email. This relies on click tracking, which supports HTTPS + custom domain. The click object includes the recipient's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ipAddress"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_ip_address"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userAgent"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_user_agent"]},"), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["link"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_link"]},") containing the full URL that was clicked."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"leveraging-the-custom_event_id-for-campaign-tracking","__idx":1},"children":["Leveraging the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_event_id"]}," for Campaign Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_event_id"]}," column is specifically designed to help you track the performance of individual email campaigns or journeys. When you configure an email activation, you can input a unique identifier for your campaign into the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Custom Event ID"]}," parameter. This ID is then logged in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," table, allowing you to easily filter and calculate performance metrics (like sends, deliveries, opens, clicks, bounces, etc.) specifically for that campaign. This is particularly useful when running campaigns via Customer Journey Orchestration (CJO)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_event_id"]}," provides basic campaign tracking, you can capture additional metadata about your activations and journeys using the Output Column Mapping feature."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"adding-metadata-columns-with-output-column-mapping","__idx":2},"children":["Adding Metadata Columns with Output Column Mapping"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":3},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Output Column Mapping allows you to add journey and activation metadata as additional columns in your email delivery events table. This feature is essential for ROI Dashboard reporting and advanced campaign analytics."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-metadata-columns","__idx":4},"children":["Available Metadata Columns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can add the following metadata columns to your delivery events:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Column Name"},"children":["Column Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier for the activation configuration (automatically generated)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable name of the activation. This field accepts custom values entered manually."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier for the customer journey. Automatically populated via String Builder when triggered from Journey Orchestration workflows. Can also be manually entered for other activation types. Required for ROI Dashboard."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_stage_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier for the specific stage within a journey. This field accepts custom values and cannot be automatically generated via String Builder."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-set-up-output-column-mapping","__idx":5},"children":["How to Set Up Output Column Mapping"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-open-activation-configuration","__idx":6},"children":["Step 1: Open Activation Configuration"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audience Studio"]}," and select your segment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create or edit a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure Engage"]}," activation"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-configure-output-column-mapping","__idx":7},"children":["Step 2: Configure Output Column Mapping"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scroll to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output Mapping"]}," section"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For each metadata field you want to include, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add string"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the mapping:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_id"]}]},": Use String Builder to select the automatically generated value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_name"]}]},": Enter a custom value manually"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_id"]}]},": Use String Builder to select the journey ID (automatically available in Journey Orchestration activations), or enter a custom value manually for other activation types"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_stage_id"]}]},": Enter a custom value manually (String Builder is not available for this field)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the output column name (use the same name as the source for consistency)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-verify-in-events-table","__idx":8},"children":["Step 3: Verify in Events Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the activation runs, the metadata columns will be available in your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_email_<your_domain>.events"]}," table alongside the standard delivery event columns."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"querying-metadata-columns","__idx":9},"children":["Querying Metadata Columns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_id"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_stage_id"]}," columns are stored as base32-encoded strings. To query these columns in a human-readable format, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_base32()"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_utf8()"]}," functions to decode them:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT\n  from_utf8(from_base32(activation_id)) AS activation_id_decoded,\n  from_utf8(from_base32(journey_id)) AS journey_id_decoded,\n  from_utf8(from_base32(journey_stage_id)) AS journey_stage_id_decoded,\n  activation_name,\n  email_template_id,\n  event_type,\n  to\nFROM\n  delivery_email_<your_domain>.events\nWHERE\n  TD_INTERVAL(time, '-1d', 'JST')\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_name"]}," column is stored in plain text and does not require decoding."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-case-roi-dashboard","__idx":10},"children":["Use Case: ROI Dashboard"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These metadata columns enable the Reporting Agent to generate ROI reports by linking email delivery events with journey performance and revenue data. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/report-for-engage"},"children":["Report for Engage"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Journey-Specific Fields"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journey_stage_id"]}," columns are only populated when the activation is triggered from a Journey Orchestration workflow. For standalone activations, these fields will be NULL."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"custom-non-pii-identifier-columns-with-the-td_log_-prefix","__idx":11},"children":["Custom Non-PII Identifier Columns with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_"]}," Prefix"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview-1","__idx":12},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some organizations operate under strict internal security policies that prohibit storing raw personally identifiable information (PII), such as email addresses, in analytics or operational tables. At the same time, these organizations still need to correlate delivery, bounce, error, and unsubscribe events back to customer records."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To support these use cases, Engage Studio provides a reserved field-name prefix — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_"]}]}," — that you can use in activation output mapping. Any output mapping whose destination column name starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_"]}," is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatically added as a column in the email event log tables."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Populated per event row with the value mapped from the activation context (for example, a profile attribute such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["member_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm_id"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This allows you to log non-PII identifiers of your choice (such as internal member IDs, CRM IDs, or hashed identifiers) alongside each event, without exposing raw email addresses in analytics tables."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"where-td_log_-columns-appear","__idx":13},"children":["Where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," Columns Appear"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an activation defines one or more ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," output mappings, the configured columns appear and are populated across all three Engage Studio event tables, enabling end-to-end correlation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_email_<your_domain>.events"]}," — send, delivery, bounce, complaint, delivery delay, open, click"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_email_<your_domain>.error_events"]}," — runtime and rendering errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_email_<your_domain>.subscription_events"]}," — unsubscribe events"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," column name carries the same value for a given activation across these tables, so you can join across delivery, error, and subscription events on non-PII identifiers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-configure-td_log_-fields","__idx":14},"children":["How to Configure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," Fields"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-open-activation-configuration-1","__idx":15},"children":["Step 1: Open Activation Configuration"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audience Studio"]}," and select your segment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create or edit a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure Engage"]}," activation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-add-a-td_log_-output-mapping","__idx":16},"children":["Step 2: Add a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," Output Mapping"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scroll to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output Mapping"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["source"]},", select the profile attribute that holds the non-PII identifier (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["member_id"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["destination column name"]},", use a name that starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_member_id"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-verify-in-the-event-tables","__idx":17},"children":["Step 3: Verify in the Event Tables"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the activation runs, the configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," columns appear in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_events"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_events"]}," tables and are populated with the mapped identifier value for each event row."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-correlating-events-without-raw-email","__idx":18},"children":["Example: Correlating Events Without Raw Email"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Suppose you map ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["member_id"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_member_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm_id"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_crm_id"]}," in your activation output mapping. You can then analyze deliveries, errors, and unsubscribes without referencing the raw ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]}," email address:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT\n  e.event_type,\n  e.td_log_member_id,\n  e.td_log_crm_id,\n  COUNT(*) AS event_count\nFROM\n  delivery_email_<your_domain>.events e\nWHERE\n  TD_INTERVAL(e.time, '-7d', 'JST')\nGROUP BY\n  e.event_type, e.td_log_member_id, e.td_log_crm_id\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"limits-and-guidelines","__idx":19},"children":["Limits and Guidelines"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Do Not Map PII into td_log_* Fields"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI does not hash, encrypt, or otherwise mask ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," values. Do not map raw email addresses or other PII into a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," field. Use only non-PII identifiers such as internal member IDs, CRM IDs, or pre-hashed IDs."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maximum of 5 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," fields per activation."]}," This keeps the event schema stable and avoids excessive column growth. Any fields beyond the first five are silently dropped."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Destination column names must use ASCII characters only"]}," (letters, digits, and underscores). Non-ASCII characters are ignored to avoid unexpected errors and incorrect column mapping."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Column name length is limited to 256 characters"]},", including the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_"]}," prefix."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identifiers are logged only — never rendered in email content."]}," The values mapped to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," are used solely for event logging and analytics correlation; they are not substituted into the email message body or subject line."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No backfill."]}," Only events generated after you configure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," mappings will include the new columns. Existing events are not retroactively updated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backward compatible."]}," If no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," fields are configured, the schema and behavior of all event tables are unchanged."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-suppressing-pii-columns-at-the-account-level","__idx":20},"children":["Optional: Suppressing PII Columns at the Account Level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For enterprise customers with strict PII-at-rest policies (for example, organizations that prohibit storing raw email addresses or other recipient PII in any analytics table), Treasure AI can enable an account-level option that suppresses PII columns across all three Engage Studio event tables. When this option is enabled, the following columns are written as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NULL"]}," for every new event in the account:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_events"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to_plain_address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," only:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bounce_recipient_address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delayed_recipient_address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_ip_address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open_user_agent"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_ip_address"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_user_agent"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_link"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscription_events"]}," only:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_identifier_value"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With PII columns suppressed, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_log_*"]}," non-PII identifiers (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#custom-non-pii-identifier-columns-with-the-td_log_-prefix"},"children":["above"]},") to correlate events back to customer records."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"How to Enable"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This option is applied per Treasure AI account and is not self-service. To request activation, contact Treasure AI Support. The setting takes effect for events generated after activation; existing events are not modified."]}]}]},"headings":[{"value":"Email Delivery Events Table","id":"email-delivery-events-table","depth":1},{"value":"Leveraging the custom_event_id for Campaign Tracking","id":"leveraging-the-custom_event_id-for-campaign-tracking","depth":1},{"value":"Adding Metadata Columns with Output Column Mapping","id":"adding-metadata-columns-with-output-column-mapping","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Available Metadata Columns","id":"available-metadata-columns","depth":2},{"value":"How to Set Up Output Column Mapping","id":"how-to-set-up-output-column-mapping","depth":2},{"value":"Step 1: Open Activation Configuration","id":"step-1-open-activation-configuration","depth":3},{"value":"Step 2: Configure Output Column Mapping","id":"step-2-configure-output-column-mapping","depth":3},{"value":"Step 3: Verify in Events Table","id":"step-3-verify-in-events-table","depth":3},{"value":"Querying Metadata Columns","id":"querying-metadata-columns","depth":2},{"value":"Use Case: ROI Dashboard","id":"use-case-roi-dashboard","depth":2},{"value":"Custom Non-PII Identifier Columns with the td_log_ Prefix","id":"custom-non-pii-identifier-columns-with-the-td_log_-prefix","depth":1},{"value":"Overview","id":"overview-1","depth":2},{"value":"Where td_log_* Columns Appear","id":"where-td_log_-columns-appear","depth":2},{"value":"How to Configure td_log_* Fields","id":"how-to-configure-td_log_-fields","depth":2},{"value":"Step 1: Open Activation Configuration","id":"step-1-open-activation-configuration-1","depth":3},{"value":"Step 2: Add a td_log_* Output Mapping","id":"step-2-add-a-td_log_-output-mapping","depth":3},{"value":"Step 3: Verify in the Event Tables","id":"step-3-verify-in-the-event-tables","depth":3},{"value":"Example: Correlating Events Without Raw Email","id":"example-correlating-events-without-raw-email","depth":2},{"value":"Limits and Guidelines","id":"limits-and-guidelines","depth":2},{"value":"Optional: Suppressing PII Columns at the Account Level","id":"optional-suppressing-pii-columns-at-the-account-level","depth":2}],"frontmatter":{"seo":{"title":"Email Delivery Events Table | Engage Studio","description":"Reference for the Engage Studio email delivery events table schema, including output column mapping, td_log_* custom non-PII identifier columns, and account-level PII suppression options."}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/marketing-cloud/engage-studio/channels/email/email-delivery-events-table","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}