MG+ Backoffice Manual
Breadcrumbs

Assign a List of Players to an Offer

This article provides instructions on how to assign a list of players to an offer.

For instructions on how to assign an offer to a specific player, refer to the View a List of Offers Assigned to a Player article.

The user can access this page by clicking on the Assign Players action icon. This icon can be found on the row of the offer on the Offer List page, or in the offer info section of the Offer Details page for offers that have an Active status.

image-20240807-013830.png
Assign a List of Players to an Offer


This page provides a summary where users can see an overview of the offer details.

Follow the steps below to assign a list of players to the offer:

  1. Step 1 - Download the .CSV file example using the Example link provided on the UI.

    image-20240314-060329.png


  1. Format the .CSV file by adding player IDs to the list. Please note that the maximum number of players on the list is restricted to 20,000. Name and save the file in .CSV format - other formats are not supported.

  2. Click Choose File on the UI and navigate to your .CSV file.

  3. Click the Upload .CSV button and wait for the file to finish uploading.

  4. Once the file is uploaded, a summary table will appear with the following information. If invalid player IDs are detected, the user will not be able to click the Assign button. The user will have to correct the player IDs listed on the original file and re-upload the .CSV file.

Column Name

Description

File Name

The name of the .CSV file that was uploaded.

Player Entries

The total number of players detected on the .CSV file.

Invalid Player IDs

The count of players who encountered errors during the file validation process. The user cannot proceed with assigning the players if there are errors. To view a detailed list of players with errors, the user can refer to the Invalid Player IDs table located below the Summary table.

The player ID must be alphanumeric (A-Z, 0-9) and can contain a maximum of 50 characters. The ID may also contain underscores ( _ ) or hyphens ( - ).

Duplications Found

The count of players where the system has detected multiple assignments to the offer. If a player ID appears multiple times, each occurrence will result in a duplicate assignment instead of updating a single record.

  1. Step 2 - Specify the start date and time of the offer instance for the player. Refer to the Free Games Glossary for more information. The time zone field is displayed for reference purposes only; to change the time zone, visit the Settings page.

    1. The date must be within the preset offer period, starting from the current date or later.

    2. The end date of the offer period can serve as the start date for the instance.

    3. The player can use the instance until the end of the validity period.

  2. Click the Assign button. A confirmation modal will appear. Click Accept to proceed with the batch assignment process, or cancel to go back to the previous screen.

The system will proceed with the assignment process. A note will be displayed indicating that the assignment process is in progress, along with the respective batch reference number.

Step 3 - Once the batch job assignment is finished, the user will see a confirmation message indicating the completion status. The page will list out the batch reference number, the count of assigned players out of the total player entries, as well as any player IDs with errors encountered or duplicates detected during the process. Users can click the View Player List button to be redirected to the View Players page.

Summary Table[data-colorid=yk7dbcikm6]{color:#36b37e} html[data-color-mode=dark] [data-colorid=yk7dbcikm6]{color:#4cc994}Column NameDescriptionFile NameThe name of the .CSV file that was uploaded.Player EntriesThe total number of players detected on the .CSV file.Errors FoundThe number of players who encountered errors during the assignment process. Players with errors will not be assigned to the offer. To view a detailed list of these players, refer to the Errors Found table located below the Summary table.The Errors Found table includes an Export button, which allows users to download the table summary as an Excel .CSV file. Note: The Assignment Complete status does not necessarily mean that all player IDs have been successfully assigned. For example, if the API encounters an error during the assignment process, affected players will appear in the Errors Found list. In such cases, users must reupload a .CSV file containing only the failed player IDs. Duplications FoundThe count of players where the system has detected multiple assignments to the offer. If a player ID appears multiple times, each occurrence will result in a duplicate assignment instead of updating a single record. Note that this is not an error - player IDs that have encountered errors will be displayed in the Errors Found section.New PlayersThe count of new players that have been created and assigned to the offer, as the player IDs listed do not exist in the MG+ system.