Note: Promotional content is available for apps that meet our eligibility criteria for premium growth tools.
Promotional content can be created at any time but must be submitted within 60 days of the event start date. It can take up to four days to approve your event; submit your event at least four days before the start date to ensure that it goes live in time.
Note: Google Play Partner Programme for Games participants must submit promotional content at least 14 days in advance of the event start date in order to experience the quality feedback benefit.
To create a promotional content event:
1. Go to the Promotional contentpage (Grow users > Store presence > Promotional content).
2. Click Create event.
3. Add the following information:
- Event name: An internal event name that is only displayed in Play Console.
- Event type: Choose an event type (see Types of promotional content).
- Offer type: If your promotional content is an offer, specify what type of offer it is. This allows Google Play to display offers correctly, helps our review team to quickly evaluate them and enables users to see offers of similar types.
- Note: It’s important to choose the offer type that matches what users will see and get in your app. The available types are as follows:
- Discount: Offers that give users a discount on one or more items, or for performing an action. For example, '10% off gems', '£5 off when you spend £25' or '15% off sale across the shop'.
- Value-add: Offers that give items away free of charge with other things or increase overall value. For example, 'Buy 1 get 1 free', 'Get 60 coins for the price of 40', 'Free muffin with a latte' or 'Starter pack bundle for £4.99, normally worth £20'.
- £0 item or free-of-charge reward: Offers that give users a £0 item for performing an action. For example, 'Race in this week's tournament and get 100 gems for £0', '£0 shipping for this week only' or 'Bonus item if you open the game today'.
- Subscription trial: £0 or discounted trials for a subscription. For example, '50% off your first two months'.
- Note: It’s important to choose the offer type that matches what users will see and get in your app. The available types are as follows:
- Countries/regions: One or more countries or regions where this event will be displayed
- Start date and time and End date and time: The start and end dates and times for your event, which can have a maximum duration of four weeks. Note the following:
- Offers can be set to have no end time. This is useful when you have a standard offer for a type of user, such as a new-starter offer. Selecting this will automatically set eligibility for your offer to new users only. We plan to introduce more eligibility criteria such as buyer state, time since the last engagement and churned users in the future.
- Major updates have a set duration of 28 days and pre-registration announcements have a set duration of 1 week.
- Preview event: Choose whether or not you want to show your event on Google Play before its start time and specify a date and time. Preview events are selected by default, so make sure that you change the selection if you don't want to show your event before the start date. You cannot preview offers.
- Request featuring: By default, your events will appear on your store listing. Events that meet our quality guidelines may also show up on high-visibility areas of Google Play, including the homepage and search results. You can create as many events as you'd like each quarter without requesting featuring.
In addition, you can request featuring to signal to Google that you'd like this event to be featured more prominently. You can do this for a limited number of times each quarter:- Four times for any event type targeting everyone and potential users.
- Two times for any event type targeting a specific audience which may be user state, buyer state or a custom audience.
Important: Events that request featuring must be submitted at least 14 days prior to the event start date
Events that request featuring have a greater chance of showing up more prominently on key surfaces, such as at the top of homepages, in search and in the future, across more of Google Play and beyond. This radically increases the potential spread, visibility and value.
4. Provide your event’s text and graphical assets:
- Tagline (required): Make sure that your tagline is descriptive and specific to your event. Don’t use a generic tagline that could be reused for other events or by other titles. If you're configuring an offer, include the items that are being discounted, and by how much. For example: ‘Holiday sale! 25% off when you spend over £50', 'New course: Try Prince’s Highway this weekend and unlock your exclusive legendary car' or 'Buy any 4 books for the price of 3'.
- Description (required): Don't duplicate your tagline text in your event’s description; it will be shown alongside the tagline in Google Play. Make sure that your description is relevant to the event. If you're configuring an offer, include any relevant limitations or conditions, such as eligibility, total number available, number per user or how to claim. The description should be as expressive as possible so that even users who may not know your app or game would understand it. See Description requirements.
- Primary image (required): Make sure that your image is relevant to the event and helps users to visualise the event. Don't include any text on images (including brand logos, slogans or app/game names) and don't include critical visual elements into cut-off zones. See Image requirements.
- Square image (required): Required to be shown on various Google Play surfaces and lists. See Image requirements.
- Video (highly recommended): This must be a public YouTube video with monetisation turned off. See Video requirements.
A common reason for events and offers being rejected by our review team is that they have been entered in the wrong language. Make sure that you enter your tagline and description in the correct language(s).Note: The default language is the language that the developer has set when the app was created.
5. Recommended: You can also localise your event into different languages so that you can reach users in different countries, similar to custom store listings. Select Manage translations > Manage your own translations and select the additional languages that you’d like to provide for your event.
Note: Other languages will use the graphic assets that you uploaded in Step 6 by default. You can manually provide locale-specific assets by selecting a language and uploading the required graphic assets for each locale.
6. Click Submit event to publish it on Google Play. You can click Save as draft to save your work without submitting it to Google Play.
Important: You can’t edit your event after you submit it, so double-check your work before submitting it.
View your events
The Promotional content page has several tables that provide an overview of all your events, so you can quickly see event statuses and key information, such as countries, start/end date and priority level, along with the following:
- Promotional-content events: Contains draft and published events
- Rejected events table: Contains events that have been reviewed and rejected
- If your event is rejected, you’ll receive a rejection notice and a reason for rejection in Play Console.
- Previous events: Contains expired or cancelled events
Copy an event
To make it easier to create similar events, you can copy information from previous events.
Prerequisite: Review the content quality guidelines to ensure that this event is sufficiently different from the original. You cannot have events that are identical or very similar to each other live at the same time.
To copy a promotional content event:
- Go to the Promotional content page (Grow users > Store presence > Promotional content).
- On the main page, click Copy to new event.
- A copy of the event will be created. You can edit the details that you want to change (these details are described in the preceding section Create promotional content).
Import events
You can bulk-upload events using a CSV template.
To import events:
- Go to the Promotional content page (Grow users > Store presence > Promotional content).
- Click Import events.
- On the Import events page, click Download CSV template.
- Complete the template using the tips below.
- When you have completed the template, drop your .csv file in the upload box or click Upload event.
Tip: If you want to make edits, there’s an option to download drafts only. Click the Download events drop-down, select whether your event has images and select Draft apps. You can then make your edits and re-upload the changes. When making changes using the CSV, remember to provide the event_ID.
Tips for completing the CSV template- event_ID: Leave this blank for new events
- Event_type: Must be one of:
OFFER
,TIME-LIMITED_EVENT
,MAJOR_UPDATE
- Priority: Must be one of:
FEATURING_REQUESTED
,FEATURING_NOT_REQUESTED
- submission_state: Must be one of:
DRAFT
,SUBMITTED
- start_time_utc and end_time_utc: Times are in UTC and must follow the format YYYY-MM-DD HH:MM
- default_language_code: Enter language code separated by ‘;’
- countries: Enter country codes separated by ‘;’
- taglines and long_description: Should use the format: language code=tagline and separated by ‘;’ for each language.
- For example:
en-US=testUS;en-GB=testGB
- For example:
- images/video_ids: Similar to taglines, you can target graphic assets by language. If you don’t have localised assets, just use the default_language_code and we will use that same asset for all other languages you are targeting. For example:
en-US=testus.jpg;en-GB=testgb.jpg
en-US=YeT0t1C_y20;en-GB=r-ERajkMXw0
- user_eligibility: For offers, one of
EVERYONE
,NEW_USERS_ONLY
(keep this empty if event_type is something other thanOFFER
) - preview_opt_in: Is one of:
OPT_IN
,OPT_OUT
- preview_time_utc: Follows the format: YYYY-MM-DD HH:MM
- Event_subtype:
- If Offer, must be one of:
DISCOUNT,
VALUE_ADD
,FREE_REWARD
orSUBSCRIPTION_TRIAL
- If Time-limited event, must be one of:
COMPETITION_CHALLENGE
,REAL-TIME
orSPECIAL
- If Major update, must be one of:
FEATURES_&_ANNOUNCEMENTS
,NEW_CONTENT
orPRE_REGISTRATION _UPDATE
- If Offer, must be one of: