Personalization uses Amazon S3 storage for several purposes, including uploading import files to the Personalization service and exporting visitor information. You can use the information on this page to help you connect to your Amazon S3 bucket to manage your Personalization-related files.
Requirements
Regardless of whether you’re sending files to Amazon S3 or obtaining files stored earlier, be sure to plan for the following requirements:
Component
Requirement
File client
Due to permission restrictions preventing you from viewing the contents of the main S3 bucket, Acquia suggests you use a client specifically designed to access Amazon S3, such as Cyberduck , or the AWS Command Line Interface.
Amazon S3 bucket credentials
Available in the Personalization interface at Admin > Manage Customers by clicking your customer name. Personalization displays the Customer Details webpage, containing the following fields:
AWS Access Key ID
AWS Secret Access Key
S3 Bucket URL
Your Amazon S3 folder path will display like the following paths, based on where your S3 bucket is located:
If the default INBOX directory doesn’t exist, you must create it.
Uploading import files
To upload one or more files to Personalization using the Amazon S3 bucket associated with your account:
Retrieve your credentials in Personalization from your user information.
Configure your Amazon S3 client, using the AWS Access Key ID and AWS Secret Access Key as credentials and the S3 Bucket URL as your path.
Connect to the Amazon S3 bucket provided by Acquia using a local computer client.
Upload the import file you created to your Amazon S3 path. If you have several import files, you can upload all the files at the same time.
Personalization uploads the file and lists the file on the Import/Export page.
After Personalization uploads an import file, it reads each file and then moves the import file to the ARCHIVE path, renaming the file to include the date and time the file was moved. For example, if you name your import file capture.csv and your S3 bucket is located in the United States, the new file name will be like the following:
Personalization saves completed export files to an Amazon S3 directory associated with your account. To download your export file, complete the following steps:
Connect to the Amazon S3 directory provided by Acquia using a local computer client. For example, the S3 folder path will be like the following paths, based on where your S3 directory is located:
Since permission restrictions prevent you from viewing the contents of the main S3 directory, Acquia suggests you use a client specifically designed to access Amazon S3, such as CloudBerry Explorer or Cyberduck
Each export file includes a separate file including the headers for each column of field data in the export file. Header files have the same names as their associated export files, with _header appended to each file name. For example, exporting the event information from Personalization would create files with names like the following:
event_2014-12-27_1.csv
event_2014-12-27_1.csv_header
Note
The Import/Export webpage doesn’t display header files.
Examining the export file
To ensure other applications can read the export file’s data as expected, Personalization adds escape characters ( \ ) to the export file. The escape characters precede certain special characters in the file, including the following:
Pipe symbol: \|
Carriage return: \n
Linefeed: \r
Using escape characters ensures there is no confusion if the special characters are in the content of a field, such as Content Title.
Viewing your S3 bucket’s top-level information
Some users must access the top level of their bucket to browse the entire structure. To do this, you must use a specific structure, or you can’t view your data:
s3://lift.prod.api-file.eu-central-1/EXAMPLEINC/
Be aware the S3 URL uses a trailing slash. URLs without the trailing slash won’t work, due to Amazon restrictions for user security.
S3 bucket file storage policy
Personalization will delete files in the INBOX, ARCHIVE, and OUTBOX directories created more than 31 days ago.
Amazon S3 file management with Personalization
Personalization uses Amazon S3 storage for several purposes, including uploading import files to the Personalization service and exporting visitor information. You can use the information on this page to help you connect to your Amazon S3 bucket to manage your Personalization-related files.
Requirements
Regardless of whether you’re sending files to Amazon S3 or obtaining files stored earlier, be sure to plan for the following requirements:
Component
Requirement
File client
Due to permission restrictions preventing you from viewing the contents of the main S3 bucket, Acquia suggests you use a client specifically designed to access Amazon S3, such as Cyberduck , or the AWS Command Line Interface.
Amazon S3 bucket credentials
Available in the Personalization interface at Admin > Manage Customers by clicking your customer name. Personalization displays the Customer Details webpage, containing the following fields:
AWS Access Key ID
AWS Secret Access Key
S3 Bucket URL
Your Amazon S3 folder path will display like the following paths, based on where your S3 bucket is located:
If the default INBOX directory doesn’t exist, you must create it.
Uploading import files
To upload one or more files to Personalization using the Amazon S3 bucket associated with your account:
Retrieve your credentials in Personalization from your user information.
Configure your Amazon S3 client, using the AWS Access Key ID and AWS Secret Access Key as credentials and the S3 Bucket URL as your path.
Connect to the Amazon S3 bucket provided by Acquia using a local computer client.
Upload the import file you created to your Amazon S3 path. If you have several import files, you can upload all the files at the same time.
Personalization uploads the file and lists the file on the Import/Export page.
After Personalization uploads an import file, it reads each file and then moves the import file to the ARCHIVE path, renaming the file to include the date and time the file was moved. For example, if you name your import file capture.csv and your S3 bucket is located in the United States, the new file name will be like the following:
Personalization saves completed export files to an Amazon S3 directory associated with your account. To download your export file, complete the following steps:
Connect to the Amazon S3 directory provided by Acquia using a local computer client. For example, the S3 folder path will be like the following paths, based on where your S3 directory is located:
Since permission restrictions prevent you from viewing the contents of the main S3 directory, Acquia suggests you use a client specifically designed to access Amazon S3, such as CloudBerry Explorer or Cyberduck
Each export file includes a separate file including the headers for each column of field data in the export file. Header files have the same names as their associated export files, with _header appended to each file name. For example, exporting the event information from Personalization would create files with names like the following:
event_2014-12-27_1.csv
event_2014-12-27_1.csv_header
Note
The Import/Export webpage doesn’t display header files.
Examining the export file
To ensure other applications can read the export file’s data as expected, Personalization adds escape characters ( \ ) to the export file. The escape characters precede certain special characters in the file, including the following:
Pipe symbol: \|
Carriage return: \n
Linefeed: \r
Using escape characters ensures there is no confusion if the special characters are in the content of a field, such as Content Title.
Viewing your S3 bucket’s top-level information
Some users must access the top level of their bucket to browse the entire structure. To do this, you must use a specific structure, or you can’t view your data:
s3://lift.prod.api-file.eu-central-1/EXAMPLEINC/
Be aware the S3 URL uses a trailing slash. URLs without the trailing slash won’t work, due to Amazon restrictions for user security.
S3 bucket file storage policy
Personalization will delete files in the INBOX, ARCHIVE, and OUTBOX directories created more than 31 days ago.
.
Download the export file you requested from your Amazon S3 directory.
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
.
Download the export file you requested from your Amazon S3 directory.
Amazon S3 file management with Personalization | Acquia Product Documentation
Personalization
Amazon S3 file management with Personalization
Did not find what you were looking for?
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Personalization