Import data and create audience list for customer data
You can upload your customers' data file and import it to the audience list in Display Ads. We match your imported data with data stored in Yahoo! JAPAN and deliver ads.
Using your imported customer data as an audience list, you can reach more audiences who are interested in your products. Additionally, you can reach an audience that hasn't visited your website.The customer data you can import is as follows:
- Ad identifier for App (IDFA or AAID)
- Email address
You can use both unhashed and hashed email addresses.
When you hash them, use the SHA-256 algorithm. We don't support hashing email addresses.
Unhashed email addresses will be hashed using the SHA-256 algorithm on your PC before reaching our server.
- Note
- Ad delivery using imported custom lists that use hashed email addresses with a salt value became unavailable. Use email addresses hashed without using a salt value or unhashed email addresses.
- When uploading your app's ad identifiers (IDFA, AAID), make sure your customers aren't opted out. If they are opted out at that time, don't upload the ad identifier you got in the past.
- Tips
- When you connect data using any data-connecting tool, continue using it. Learn more about Link customer data using the data-connecting tool and create audience list.
- When you import user identifiers, see Import user identifier and create audience list.
- If the user size remains zero after importing data into the audience list for customer data, see The user size remains zero after importing data into the audience list for customer data
File format for uploading
When uploading your data to the audience list, use the following formats:
File format |
|
Character code | UTF-8 (without BOM), Shift JIS *The file can only contain half-width characters and numbers. |
Line feed code | LF, CRLF |
File size | Up to 200MB |
Number of data |
|
Data samples
Click the following links for each text file to refer to the sample data in text format.
*Note that these text files are samples, don't use them as-is for your case. When you prepare the file to upload, use the values of your stored customer data.
- IDFA: idfa.txt
- AAID: aaid.txt
- Hashed email address: hashed mailadress.txt
Import data and create an audience list of customer data
See File format for uploading section and create a file.
- Note
- User size is the approximate number of audience and doesn't imply the number of data in the uploaded file.
- The default audience list doesn't include a user size in the audience list you created.
- User size may not appear after a few hours after the status becomes "Data loaded."
- If the number of data you uploaded is small, you may not have enough reach (target audience.)
- You can't download the imported data.
Valid duration of data connection
You can specify the valid duration of data you connected with the list between 1-60 days.
The following table shows how the valid duration works.
Action | Number of reaches in the list | Ad delivery | |
---|---|---|---|
Sep1, 2018 |
| 3,000 | Started |
Sep10, 2018 | - | 3,000 | Delivering |
Sep11, 2018 | - | 0 | Ended |
- Tips
- The maximum valid duration of data connection is 60 days after connecting the list data. If you continue using the same data after 60 days, import the data again.
The user size of the similar user list becomes zero 28 days after you import customer data. (Similar users count in the base list when it exceeds 100 in the past 28 days.) To avoid this, import again within 28 days when you create a customer-data list to use an audience list based on similar users. - Within 60 days after connecting the list data, you can change the valid duration.
However, if changing the valid duration as follows, the ads won't deliver.- Example
- October 1: List data connected (50 days of valid duration.)
October 15: Updated the valid duration to 10 days.
- Learn more about Create an audience list
- The maximum valid duration of data connection is 60 days after connecting the list data. If you continue using the same data after 60 days, import the data again.
Import data to an existing custom list
You can import the additional data to the audience list.
- Update your data regularly. Your ads will stop if you don't import the additional data within the valid duration you specify. Learn more about Valid duration of data connection
- You can add different types of data when you import additional data.
- Example
- Initial upload: IDFA (User A, User B)
Additional upload: AAID (User A, User C)
In this example, the latest audience list includes "User A," "User B," and "User C." However, "User B" is not included in the audience list after the valid duration you specified in the initial upload passed. Because "User B" is not updated in the additional upload.