Delivery Details

On this page, you will find information regarding the various methods available for receiving your data feeds and details about the organization of the folder where the deliverables are stored.

Delivery options

Placer offers various options to gain access to its POI analytics insights exported as CSV files. Customers can choose one of the following delivery options as per the availability of each feed type.

Customer-owned bucket

Amazon Web Services (AWS) S3

Customers can decide to have the data feed pushed into their own bucket or pull data off the Placer-owned bucket.

Share your S3 bucket with Placer

1. Create or reuse an S3 bucket for receiving the export files
2. Create a user (or share existing user permissions) and provide your Placer customer success manager with the following credentials:
   AWS_ACCESS_KEY_ID
   AWS_SECRET_ACCESS_KEY
3. The user needs the following permissions
   "s3:PutObject",
   "s3:GetObject",
   "s3:DeleteObject",
   "s3:ListBucket",
   "s3:GetBucketLocation"

This is an example of a user-Policy:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObject",
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": [                
                "arn:aws:s3:::{{bucket goes here}}",
                "arn:aws:s3:::{{bucket goes here}}/*"
            ]
        }
    ]
}

Why do we require these bucket permissions?

4. Test bucket policy by downloading and running the placer_s3_export.py test script as follows:
   (replace with the relevant parameters)

python placer_s3_export_test.py <bucket-name> <access-key> <access-secret>

Missing User-Policy permissions will be listed in the script response. Once enabled, Placer's data will be uploaded to the desired bucket.

Google Cloud Storage (GCS)

Share your GCS bucket with Placer

1. Create a Google Cloud Storage bucket
2. Create a new Service Account (or use an existing account) and provide your Placer account manager the credentials file associated with the account (JSON file)
3. Provide 'Storage Admin' permission for the bucket, to the newly created Service Account
4. All done! Once enabled, Placer's data will be uploaded to the desired bucket.

Microsoft Azure sync

Placer currently support only export to Microsoft Azure customer-owned buckets.
To sync your exports with Microsoft Azure, follow these steps in your Microsoft Azure account:

1. Create a dedicated (or use existing) Azure container
2. A role with Microsoft.Storage/storageAccounts/listkeys/action permission
3. Provide Placer with the bucket information:

• Storage account name
• Storage account key
• path to store the data feet (container name and internal path)

Requesting Placer bucket set up

Contact your customer success manager if you are interested in getting data pulled from using a Placer-owned bucket. Once your bucket is ready, Placer will share with you the required credentials and the path to access your bucket.

Email

Placer can grant you access to your data feed via a temporary storage link delivered to mail recipients of your choice.
Contact your customer success manager to request this option.

SFTP

An additional option to receive data feed(available for some of the data feeds only) is by using an SFTP connection. We strongly recommend choosing any of the other options listed above due to the robust security and high availability offered by all cloud providers.

Snowflake

Some Placer's data feeds are available for access via your Snowflake account. You may contact your customer success manager to set up a Snowflake view for you.

Delivery folders organization - V3

📘

Relevancy note

This section is relevant for Chain/Venue multi-metrics and Premium export.

1. File path will be as follows:
   '/placer-analytics/SCHEMA/EXPORT_TYPE/DATE_STRING/ENTITY_TYPE/FILE_TYPE

2. Files are GZip compressed
3. In case the feed is configured to include an explicit list of entities ( venues/complexes/billboards) the files will be located under the property folder in case the configuration was for a list of chains (include their sub-entities or not) the files will be located under the chain folder.
4. Folders structure example:

Delivery folders organization - V4

📘

Relevancy note

This section is relevant for Chain/Venue multi-metrics, Premium export, and Origins feeds.

1. File path will be as follows:
   '/placer-analytics/SCHEMA/EXPORT_TYPE/DATE_STRING/FILE_TYPE/

2. Files are GZip compressed
3. File partitioning optimization is employed.
4. Folders structure example:

Delivery Scheduling

📘

Relevancy note

This section is relevant for Chain/Venue multi-metrics, Premium export and Origins feed.

Please find below the delivery schedule for each feed by its delivery frequency:

Delivery Completion Indication

To receive notifications upon the completion of the entire delivery and the availability of files for retrieval, Placer offers various notification choices:

1. .success file - This file is the final file being delivered and it is empty; its arrival signals that all deliverables are ready for retrieval. You can find the file's location within the various available file structures above.
2. Amazon Simple Notification Service - you can learn more about it here.