Email¶

Overview of Email¶

By using the event that was tracked through Repro, emails can be sent to segmented users.

What can the Email feature do¶

Below are Repro’s Email features

Email Delivery¶

Feature	Details	Ability
List delivery	The feature to send massive amounts of emails at once to targeted users within a list (using the audience feature)	○
Event trigger delivery	Set the receiver behavior as the trigger, and automatically send emails	X
Scheduled delivery	The feature to send emails on a specified date	○
Segmentation	The feature to segment delivery targets based on events tracked by Repro	○
Multi-part delivery	Automatically send emails as HTML and plain text seperately	○
A/B testing	The feature to perform an A/B test with different email context	X
Multi-language	The feature to send emails in languages other than Japanese	X
Bounce list	A list of email addresses which got bounced back	X
Management of suspend users	The feature to not resend emails to users who have either unsubscribed or bounced back	◯

Email Editor¶

Feature	Details	Ability
Embedded	The feature that Embed User Profiles(variable) which select database except Repro in Email's body or subuject.	○
HTML editor	The feature to edit HTML	◯
Plain text editor	The feature to edit Plain text	◯
Save template	The feature to save the HTML text created in the dashboard as a template	X
Own Domain use	The feature that use your own domain for the domain of the link in the email	X
Reply email address setting	The feature to set a different email address when replying to emails	◯

Other Features¶

Feature	Details	Ability
Authorization flow	Separate the authority between editing and delivery	X
Access restrictions to user information	Not being able to browse or operate the user information screen unless the authorization is for managers and above	◯

Email delivery outline¶

Here is a step by step guide on how to use Repro Email. Please follow the below steps to prepare for implementation.

Application
1. Please contact one of our customer success members.
2. We will get back to you regarding our services along with price plans.
3. Select a plan that works best for you, and fill in the application form to send back to our representative.

Checking the validity of the delivery domain

An email containing a URL link should have been sent to the email address noted on the application form. Click the link to verify the domain.
Note
- The email containing the URL link should look like this: @spiral-platform.com
- Please make sure you are able to receive emails from this domain, so it doesn’t get blocked or go to the spam inbox.
- Please contact a customer success member if you have not received this email.
Preparing the data

Prepare the CSV data of the user info needed to send emails. User ID and email address is crucial for this process. Please refer to this data format and prepare the CSV data.If you wish to use a personalized message for the title or main text, you need to register each user info as an variable. To do so, please refer to this data format and prepare the CSV data.
Release of email feature

Once all preparation is completed, you will have access to all pages from the dashboard concerning email feature
Importing

Using the email address along with the CSV with varialbe, import the user info from the dashboard. For more details on how to import, please check here.
Check the maximum email limit of your plan

From the app setting screen, please make sure that the maximum email limit matches the plan that was selected when applying.
Create email and send

Create an actual email following the steps and send the email. The steps on how to set the receiver and create the email can be found here.

Importing user profiles for email delivery¶

Importing email addresses – to be used for sending emails – as CSV files from the dashboard is a crucial part of the steps when implementing Repro Email. You can also send personalized emails by importing variables such as user names and birthdays.

Overview of importing¶

Preconditions¶

Repro requires email addresses that have prior approval (opt-in) in order to process the importing. We do not offer services to obtain advertising emails delivery approval from users. User can unsubscribe from e-mail addresses registered with Repro by clicking on the unsubscribe link in e-mails sent by Repro.

Warning

Sending advertising emails to users prior to not obtaining approval from them could be violating the law, and could be subject to punishment under the law.

Importing of email address/variable¶

This screen shows the importing email address or variable for Email delivery. Import email address /variable using CSV files. It is possible to regist email addresses to delivery user list or supppression user list. Set the data type (string, integer, etc.) for each variable before importing, when importing for the first time.

Note

Email addresses registered within the user profiles cannot be used for email delivery. In order to do so, you must complete the importing process.

Check imported email addresses¶

This screen shows how you can manipulate the delivery status of the imported email addresses. Email addresses that have been imported as delivery user will be registered as Deliverable, email addresses that have been imported as suppression user will be registered as Undeliverable. For more details on operations of this screen, please check Email Address List.

Check imported variables¶

This screen shows how you can check the imported variables along with the designated data type.

Steps of importing¶

Preparation prior to importing¶

List cleaning

Look over the list of addresses before importing. For example, if you are already sending email newsletters and the bounce addresses unsubscribed users are included in the delivery list, you must eliminate those from the delivery list, or register those as undeliverable.
Create CSV file for importing

Importing of user info is done using CSV files. CSV files differ between emails and variable, so make sure you follow the correct format indicated below.

CSV file for email address

Key	Description	Required/Optional
user_id	User ID	Required
email_address	Email address	Required

user_id,email_address
123456,aaaa@example.com
234567,bbbb@example.com

(user_name as variable is sample)

Key	Description	Required/Optional
user_id	User ID	Required
email_address	Email address	Required
user_name	User Name	Optional

user_id,email_address,user_name
123456,aaaa@example.com,anan
234567,jjjj@example.com,john

Note

Only UTF-8 can be used for the character code of the CSV file.
Key of user_id and email_address are fixed values. No other key can be specified.
Both the user_id and email_address are required when registering. Please make sure to enter in the user_id in the first column and enter in email_address in the second column when creating the CSV file.
The only letters that able to be registered as the key for the variable is _ and – and half width English character and numbers.
If the same Key exists on the same CSV file, an error will occur and import will not be possible.

How to import¶

Import email address
1. Follow the format and create a CSV file for email addresses.
2. Go to PLUGINS > EMAIL SETTINGS > EMAIL USER IMPORT. Click the SELECT FILE button, and select the file created in step 1.
3. Click the START IMPORT.
4. After the process is completed, the import information will be displayed. Please check the New users count and the Failed count.
5. You can check the imported email addresses by going to PLUGINS > EMAIL SETTINGS > EMAIL ADDRESS LIST.
6. If there is an error (i.e. failure count is not 0), click the error log button and check the errors.
7. Once you have checked the error and corrected the issues, please start again from step 2 and complete the importing process.
Importing variable
1. Follow the format and create a CSV file for variable.
2. Go to PLUGINS > EMAIL SETTINGS > EMAIL USER IMPORT. Click the SELECT FILE button, and select the file created in step 1.
3. Click the START IMPORT.
4. When importing variable that hasn’t been registered yet, a modal screen will appear with options to select the data type (string, integer, decimal) of the unregistered variable. Once you select the data type for each variable, click the START IMPORT button at the bottom of the modal screen.
5. After the process is completed, the import information will be displayed. Please check the New users count and the Failed count.
6. You can check the imported variables by going to PLUGINS > EMAIL SETTINGS > EMAIL VARIABLES LIST.
7. If there is an error (i.e. failure count is not 0), click the error log button and check the errors.
8. Once you have checked the error and corrected the issues, please start again from step 2 and complete the importing process.

What to do when there is an import error¶

If there is an error, the error log line and an error message REPRO_ERRORS will be added to the column and output the CSV file.
All values within the REPRO_ERRORS column will be ignored. Please correct the CSV for errors and import again.
Possible reasons for errors when importing can be due to the following. Compare the errors with each REPRO_ERRORS column and correct the CSV file.

message	Description
[column name] should be integer	There is a non-integer value.
[column name] should be decimal	There is a non-decimal value.
[column name] should be string	There is a non-string value.

Create an Email¶

Make edits and change settings in order to send emails from the dashboard.

Go to Marketing > Email, and click the Create New button on the top right corner of the screen.

Note

To be able to send emails, prior registration and preparation is needed. For details, please see here.

Campaign settings¶

Campaign Name¶

Set the name for the campaign. It will be displayed on the email campaign list.

Campaign Goal¶

Designate the event that will become the goal of the campaign. User information that will be aggregated are those that either opened or clicked the email within one week of delivery, and then executed the goal event within 24 hours. Please refer here for more detailed information of mail conversion.

Warning

Once you set the goal of the campaign, it is not possible to change it.

Hypothesis and Results¶

Before starting the campaign, clarify the purpose and make sure it is noted. After the campaign, reflect on the results to be used as reference for next time.

Delivery Type¶

Datetime Trigger¶

Datetime Trigger designate the dates and frequency of email delivery. The process differs depending on the frequency, stated below.

Frequency	Feature	Method of designation
Once	One time delivery on designated time	Within the delivery timing section, set the year, month, day and time of choice
daily	Delivery every day at a designated time	Check the box "Repeat delivery" and select daily as the frequency. Set the time as well. If you wish to set a designated day for delivery, select the days and period from Start at to Ends at.
weekly	Delivery on designated day every week	Check the box "Repeat delivery" and select weekly as the frequency, and set day and time. At the end, select the period from Start at to Ends at.
monthly	Delivery on designated time every month	Check the box "Repeat delivery" and select monthly as the frequency, and set the date and time. At the end, select the period from Start at to Ends at.

Warning

Regardless of the frequency, all delivery preparation must be completed 15 minutes prior to delivery start time.
If you finished the preparation past 15 minutes prior to delivery start time, one time delivery will not be saved, and periodic deliveries will resume after the next scheduled delivery.
You cannot stop delivery if it passes 15 minutes before delivery time.
The only aspect that you can designated is the date and time for monthly deliveries. It is not possible to set days such as the third Monday of every month, or beginning/end of every month.
If you specify a date that differs depending on the month, such as the 31st, the month without the corresponding day will not be delivered and will be skipped.
It is not possible to exclude certain days of the week for monthly deliveries.
It is not possible to change the frequency from once to periodic or vise versa. However, it is possible to change the frequency within the periodic time frame.

Immediate Trigger¶

Selecting Immediate Trigger will send out emails immediately after it is published.

Warning

It might take a few minutes to process before Sending the campaign

Target Users¶

You can target all existing users or a segment of users by filtering with events or user profiles with the filters. The filters can be combined as either and , and not, or condition up to 5 in total.

and: Add the users to the delivery target who match all the specified condition.
and not: Exclude the users from the delivery target who match the specified condition.
or: Add the users to the delivery target who match any of the specified condition.

Note

If you want to use events or user profiles as filters, you need to track and register with the SDK or API in advance.

Filtering with audiences¶

You can segment the target by using existing audiences created as explained in Audience.

Note

Filtered Audience: This audience cannot be combined with other filtering conditions.
Import Audience: This audience can be combined with other filtering conditions.
Smart Audience ™: This audience can be combined with other filtering conditions.

Filter with Events¶

You can segment the target by the usage of the events, specifying how many times an event has been done within certain period.

Filter with Event Property¶

You can segment the target by the usage of the events and its associated properties, specifying the property value within certain period.

Note

With Event Property filters you cannot specify how many times event has been performed. Users who have done the event with the property at least once within the specified period will be included in the target.

Filter with User Profile¶

You can segment the target by registered user profile data. With either number or date types data set in the SDK, the condition can be constructed using comparison with the assigned value such as 'is more than,' 'is less than,' 'is more than or equal' or 'is less than equal.'

Existing Users¶

The campaign will be delivered to all the existing users registered to Repro. If you wish to exclude users who match special conditions, please add desirable filters using combined as and not.

Testers¶

Send message only to test users' devices. You can specify the target users in Testers Management.

Email Header¶

Sender email address¶

Set the email address that is displayed as the sender when users open the email. Only email addresses that have been approved of the sender domain can be used. To check for the validity of the sender domain, please refer here.

Reply-To (optional)¶

If you wish to use a different email addresses as the sender, you can set it up here. If no steps have been taken regarding reply email addresses, the default is set as the sender’s email address.

Email Body¶

Edit the subject and the main text of the message. You can do so easily by using Repro’s template to create an HTML email, or by using your own HTML editor.

Sender name¶

Set the sender’s name that gets displayed within the mailer.

Warning

Emojis, old fonts, special characters, and half-width kana are garbled and should not be used.

Subject¶

Set the subject that gets displayed within the mailer. It is possible to set personalized subject using variables of tag inserting functions (mentioned later in document).

Warning

Emojis, old fonts, special characters, and half-width kana are garbled and should not be used.

Pre-header¶

Change the header (which is displayed at the very top of the main text) with the preheader set here. It is possible to set personalized preheaders using variables of tag inserting functions (mentioned later in document).

Warning

Do not use half-width kana because it causes garbled characters.

Replacement Tag¶

Send personalized emails using pre-imported user information and inserting it into the subject or main text as variables. This function also works for setting links to unsubscribe for newsletters and such.

Inserting variables

Bring the cursor to where you wish to insert the variable, and click the REPLACEMENT TAG button.

A list of already imported variables will appear on the modal screen. Select the variables you wish to insert and click the Select button. It will be blank for users without variable registration. If you do not want it to be blank, edit the default value so it will display that instead of it being blank.

After clicking the Select button, it will go back to the editing screen. If the tag is inserted where the cursor was placed, and the colored wording is displayed in the preview, the setting is complete.

Note

The preview will display the default value. It will not display the registered variable value.
Please note that if you enter a tag such as HTML as a variable, it will not be expanded on the email.

Inserting the unsubscribe link

Place the cursor to where you wish to insert the unsubscribe link and click the REPLACEMENT TAG button

Click the Link tab once the modal screen appears. The Unsubscribe link should already be appeared on the screen, so please click the SELECT button. If you wish to set a link with words such as Unsubscribe, edit it within the Text field and click the SELECT button.

After clicking the SELECT button, go back to the edit screen. Make sure that the link tag is inserted where you set the cursor, and the unsubscribe link is displayed above the preview.

Edit Type¶

Select the edit type for HTML mail. Please note that contents other than the main text, such as Sender name, Subject, Pre-header, Test delivery and REPLACEMENT Tag , are all common types (i.e. there is no difference types).

Standard

Email design is fixed. Create email by entering Header Image, Main Image, Lead text and so on.
- Header image
  - Choose the image you want to insert into the message as the email header.
  - Uncheck the box to create it without header
  - Supported file formats: JPEG, PNG and GIF
  - File size
    - Maximum: 1MB
  - Image size
    - Recommended: over 1200px in width
  - Either upload image file, or select an image file URL that is hosted by your original server
- Main image
  - Select the image used as the main mail image.
  - Uncheck the box to create it without main image.
  - Supported file formats: JPEG, PNG and GIF
  - File size
    - Maximum: 1MB
  - Image size
    - Recommended: over 1200px in width
  - Either upload image file, or select an image file URL that is hosted by your original server
- Lead text
  - Fill out the lead text for the email. You can also select the color of the text.
  - Uncheck the box to create it without lead text.
- Main text
  - Fill out the Main text. You can also set the text color.
  - Uncheck the box to create it without main text.
- Button
  - Set the button for the main text.
  - Uncheck the box to create it without the button.
  - Button label
    - Fill out the button label text. You can also set the background color, border color and text color.
    - To display the text of the button label on a new line, `` <br> `` must be specified.
  - URL
    - Fill out the URL which will be opened when the bottom is clicked.
    - Maximum: 1000 letters
- Footer text
  - Fill out the footer text. You can also set the text color.
  - Uncheck the box to create it without footer text.
Note
- Clicks can be counted only for URLs starting with https: and http: .
Warning
- Do not use half-width kana because it causes garbled characters.
Custom

Edit the design and layout freely by directly editing the HTML and CSS. You can also use an existing HTML editor.
- HTML editor
  - All text and images created in the standard version will be passed onto the custom version.
- Attach images
  - To attach an image in a message, bring the cursor to the desired place in the HTML, and click the Attach images button in the text editor below. When you select the template with images, the image will be attached automatically at the position of the image on the template without placing the cursor.
  - When you upload an image from a folder saved onto the computer,the following tag img src= and a URL for the image will appear where the cursor is, and you will be able to see the image in the preview.
Note
- The Click Count only can be counted when use a tag with the href attribute(a tag, area tag, vml of Outlook).
- Clicks can be counted only for URLs starting with https: and http: .
Warning
- Anything edited on the custom version will not be transferred to the standard version. Also, when transferring from custom to standard while in the process of editing, all content will be deleted.
- The maximum image size allowed to upload using the Attach images button is 1MB. There is no limit to the file size if you attached an image as an "img" tag manually, however, our recommended image size will still be 1MB.
- The behavior of the script tag and Iframe tag may be different from the intended behavior depending on the receiving mailers.
- Do not use half-width kana because it causes garbled characters.

Text mail edit¶

Edit text mail used for multi-part delivery. If there is no need to send text mail at the same time (meaning only deliver HTML mail) there is no need to edit.

Warning

Text mail that is edited here will be used for multi-part delivery.Please be careful since it is not possible to deliver only text mail.

Test delivery¶

To check how the email will be displayed in actual mailers, use the test delivery feature.

At the bottom of the creating page, enter the email address you want to be sent to in the Test delivery section.
Note
- When sending to multiple recipients, separate email addresses by commas.
After entering the email address then click SEND button. Check the inbox to see if the test delivery was successful or not.

Save As Draft¶

To save an incomplete campaign, such as when all the required fields have not been filled out, please click the SAVE AS DRAFT button. For campaigns that are saved as draft, it is still possible to change all fields including the Campaign Goal and Variants.

Email campaigns that are in the process of editing can be determined from the mail campaign list screen.

Confirm¶

After all checks have been completed, click the Confirm button at the bottom right corner.

Confirm page will appear. Make sure all settings and content of the messages are correct. If there is a correction needed, click the red check mark of where you wish to make the changes. It will jump to the editing screen.

Start Delivery / Stop Delivery¶

Once you have checked for all mistakes, click the START DELIVERY button at the bottom right corner of the page.Once the campaign begins, mail deliveries will start on the designated dates. If for any reason you need to stop the campaign, click the SUSPEND button and it will stop deliveries.

Warning

If it is past 15 minutes before the delivery time, campaign will not be stopped even if you clicked the button.
Delivery will not be stopped by clicking the SUSPEND button immediately after starting the delivery. The next scheduled delivery only for periodic frequencies will be stopped.

Campaign Measurement¶

You can check how effective the delivered Email was by confirming the number of openings and clilcs, conversions.

Note

For opens and clicks, you can measure the results of up to one week after releasing the campaign.
Due to the aggregation process, it takes time before the delivery result is reflected on the screen or CSV.
For periodic deliveries, the total count until the end date of the delivery will be displayed. If you wish to see details by each day, please export the CSV file.

Delivery Result¶

Deliveries

Numbers of users that were targeted for delivery.
Completed Deliveries

Subtracted the Error Count from Deliveries.

As the Error Count may increase over time, the Completed Deliveries may decrease accordingly.
Note
- For users that can’t receive emails for a period of time for various reasons (such as their inbox being too full), it will attempt to resend the messages for the next 24 hours.
Error Count

Numbers of users that were hard bounce.

Depending on the processing timing of the receiving server, there may be a possibility of increase in errors as time passes from the start of delivery.
Note
- A hard bounce refers to email addresses that don’t exist, or that have no potential of being sent to from thereon after.
  - For example, email addresses that don’t exist, rejection by the receiver, and so on.
- Hard bounce users will automatically be given a stop subscription flag and will be rejected from the next scheduled delivery and onward.
Open Count

Number of users who have opened the message. Even if one user opened the same email multiple times, it will still count as one.
Open Rate

Open Count divided by Completed Deliveries
Click Count

Also, even if there are multiple links in one email, and one user clicked each link, it will still count as one.

Note

The Click Count only can be counted when use a tag with the href attribute(a tag, area tag, vml of Outlook) in the email body.

Click Rate

Click Count divided by Completed Deliveries.
CV Count(Conversion Count)

User counts that have achieved the goal set within 24 hours of action, concerning open and click within one week from start of delivery.
CV Rate(Conversion Rate)

Number of conversions devided by Completed Deliveries.
Campaign Progress

If you wish to check the Campaign Progress such as open count and click count, obtain CSV data file based on daily results. Measurement unit is by users.

Email Address List¶

Manage the imported email addresses on the list screen through status.

Status management¶

Overview of status

There are two kinds of statuses: Deliverable and Undeliverable. When the status of the email address is Deliverable, emails will be sent; when the status is Undeliverable, emails will not be sent. The status is decided by whether it has a stop flag or not. If it has one or more stop flags, emails will not be sent; if it doesn’t have a stop flag, emails will be sent.
Overview of stop flags
- Unsubscribe
  
  Through the email sent to each user, the user themselves followed the link and unsubscribed. This automatically registers the email address as such status. It is not possible to directly register through the dashboard.
- Bounce
  
  If the email sent from Repro was rejected by the receiving mail server, it will automatically register the email address as such status. It is not possible to directly register through the dashboard.
- Stop
  
  A delivery flag that you can directly register/delete from the email address list

Note

Multiple "stop flags" may be registered for one user.
If one user has multiple stop flags, only one stop reason associated with any of the flags will be displayed. When Stop is included in multiple stop flags, the stop reason of Stop is displayed with the highest priority.

Removing the stop flag¶

Here, you can remove all stop flags

When updating all at once
1. Select the check boxes on the list
2. Click Remove stop flags
3. Select the check box you wish to remove the stop flag and click APPLY.
When updating individually
1. Click the ︙ button on the right side of the list.
2. Click Remove stop flags
3. Select the check box you wish to remove the stop flag and click APPLY.

Note

If the email address does not have a stop flag registered, the above steps will not be possible.
If all stop flags are removed, the status will automatically change to Deliverable.

Add the stop flag¶

You can add the stop flag.

When updating all at once
1. Select the check boxes on the list
2. Click Add stop flag
3. After selecting APPLY, the selected email address will be added to Stop.
When updating individually
1. Click the ︙ button on the right side of the list.
2. Click Add stop flag
3. After selecting APPLY, the selected email address will be added to Stop.

Note

If an email address is already registered as Stop, the above steps will not work.

Download list as CSV¶

Download all email addresses on the list as CSV file. By using filters, it will allow you to narrow down on targeted email addresses.

Click the ︙ button on the right side of the list.
Click the CSV Download button to complete the process.

Check the monthly delivery counts¶

Depending on the plan that you decided on upon applying, the maximum monthly delivery count is set. To check monthly mail delivery performances along with the status of how much more until the monthly maximum, go to Options under Settings > App Settings.

Note

Error counts are included within email delivery counts.
Email delivery is still possible even if it exceeds the monthly count, however it will be charged at a higher rate than the original plan.
If you wish to change the plan, please contact a customer success member or click the UPGRADE button on the screen.

Email delivery system maintenance¶

Email delivery system, which is responsible for the Email feature, performs system maintenance periodically.

Warning

During system maintenance, Email delivery may not be possible or may be delayed.
If system maintenance is started during Email delivery processing, subsequent delivery may be executed with a long delay after maintenance is completed.