Skip to main content

Push ad format

Caroline avatar
Written by Caroline
Updated over 2 months ago

1. Click on the campaign where you want to add an ad

You will be taken to the "Ads" section. Click the "+" button to add a new creatives

Important:

This field is not for selecting the language of the GEO or audience.

Instead, it defines the language of the macros used in your push notification (for example, the name of the city in {{CITY}} or the date in {{DATE}}).

The content of the notification itself (title, text, image) can be in any language — make sure it matches the target audience for your GEO.

If you're targeting multiple GEOs with different languages, we recommend creating separate campaigns for each language version.

You can use macros in the ad title:

{{CITY}} – The system will automatically insert the user's city (in the nominative case)

Ad preview example: Pensioner from {{CITY}}

Displayed ad example: Pensioner from Berlin

{{DATE}} – This macro inserts the current date based on the user’s timezone

Ad preview example: Only on {{DATE}}! 60% off…

Displayed ad example: Only on July 10! 60% off…

Macros are optional and can be added to enhance relevance

Important Macros Guidelines

Please note: Push ad macros differ from native – square brackets won’t work here

Supported push macros:

{AD_ID} – passes the ID of the ad

{BLOCK_ID} – passes the ID of the ad block (placement)

{CLICK_ID} – passes a unique click identifier

{BID} – passes the ad's bid amount

{CAMPAIGN_ID} – passes the campaign ID

{COUNTRY} – passes the 2-letter country code

Push macros use single curly brackets only!

  • In titles, you can use: {CITY} and {DATE}

  • For buttons: {OPEN} and {CLOSE}

  • If you set a campaign-level budget limit, the campaign will automatically stop once 85% of the limit is reached.

  • Ads cannot be deleted, but they can be paused or archived.

  • If anything other than the URL or bid is changed after moderation, the old ad will be archived and a new ad will be created with zero stats and sent for moderation again.

Due to the specifics of the push format, push campaigns will pause when the balance drops to $600 or lower.


This limit does not affect native campaigns.

2. Fill in the required fields:

  1. Title (up to 120 characters)

  2. Description (up to 120 characters)

  3. URL (make sure to include the full protocol: http:// or https://)

  4. Notification language

Bid (min. bid varies by GEO — contact your manager to get updated info)

Important: Push ad spend may slightly exceed the set limits due to delayed clicks (sometimes up to several days)

To avoid going into negative balance, the minimum account balance required to run push campaigns is $600. If the balance drops below this amount, push delivery will stop automatically

3. Upload an image and icon for your ad by clicking the "Upload image" button

You can upload in two ways:

  • From your computer

  • Via direct URL

To upload from your computer: Drag and drop the files or use the upload dialog

Image requirements:

  1. Formats: jpg, jpeg, png

  2. File size: no more than 2 MB

  3. Minimum resolution
    – Main image: 300x225 px
    Icon: 150x150 px

  4. Maximum resolution: 1920x1440 px

Second method – via direct URL:

  1. Enter the image URL

  2. Once the image is uploaded, you’ll see a preview of your ad

  3. Click the desktop and mobile icons to view how your ad will appear in web and mobile formats

4. Enter the button label and icon for the redirect link

  1. The macro {OPEN} automatically inserts the word "Read" in the selected notification language

  2. You can also enter your own custom label instead of using a macro

  3. The macro {CLOSE} inserts the word "Close" in the selected language

  4. Again, a custom label can be used if preferred

Icon requirements:

  1. Formats: jpg, jpeg, png

  2. File size: no more than 2 MB

  3. Minimum resolution: 50x50 px

5. After uploading your images and filling in all required fields, click "Add"

6. Your ad has been created and submitted for moderation

Once approved, you can launch the ad by selecting it and clicking the "Start" button

Did this answer your question?