Custom Label Max Rule Code #4: Time Based Max Rule – Kargo

Use Case:

Your client wants the text or label of the ad designs to change from one time/date range and then revert back to the default text/label once the date range is no longer valid or active.

The text can be leveraged in a text overlay as part of the design or as a label to activate a certain overlay within the date/time range specified.

Of course, you can use this same label to be applied in the creation of a new Product Set where Product A is activated between the time/date specified and then revert to a BAU Product Set outside of the said date/time range.

Example:

Bed, Bath and Beyond wants to install the words “Black Friday Deal” between midnight to 11:59 pm Eastern Time Zone on Friday, November 24, 2023 through Saturday, November 25, 2023

What would it look like and where do we enter the code?

What is this actually doing?

It is checking the time and date currently and if it is between the start and end date in the code, the text 'Black Friday Deal!” would be applied.

For example, as long as the current time is between the start and end date…

… You can add the Custom Label dynamic text as an overlay

… New Product Set creation: Whenever a product within Product Set is displayed AND the time/date is within range then Add “Black Friday Deal!” to the products shown

Copy and Paste the Code Template (within the gray box):

New York/Eastern Time Zone:

{{#if (is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York')}}YOUR TEXT HERE{{/if}}

{{#if (is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York')}}YOUR TEXT HERE{{/if}}

UK Time Zone:

{{#if (is_current_time_between 'YYYY-MM-DD 00:00 Europe/London' 'YYYY-MM-DD 23:59 Europe/London')}}YOUR TEXT HERE{{/if}}

{{#if (is_current_time_between 'YYYY-MM-DD 00:00 Europe/London' 'YYYY-MM-DD 23:59 Europe/London')}}YOUR TEXT HERE{{/if}}

Instructions:

Copy (control or command C) the code above
Go to Product Catalog → Map section → CUSTOM Field # (an unused one or choose one you are willing to apply for this campaign or instance)
Click on Edit Field (pencil icon)
Paste the code you entered
CHANGE the Date and Time in Max code carefully.
Enter whatever TEXT you want to be applied Make sure you check the exact spelling of the brand name from the catalog itself

Example Use Case:

Eddie Bauer client would like to make sure a large banner that says BLACK FRIDAY DEAL! banner shows up on all products only on Black Friday (November 25, 2023) and then on November 26, 2023 at midnight, automatically have the banner disappear (back to original design).

SOLUTION CODE:

{{#if (is_current_time_between '2023-11-24 00:00 America/New York' '2023-11-24 23:59 America/New York')}}BLACK FRIDAY DEAL!{{/if}}

NOTE:

Is_current_time_between/is_current_time_after - check the current time of when the feed processes
'2022-12-16 00:00 America/Los_Angeles'/… - format for time check
Enter the text here : This is the text you’d like to appear for the date
There is a 100 character text limit that will show up in Meta

Advanced Use Case 1:

Use this Max Rules to ADD TEXT or LABEL to TEXT 1 then change to TEXT 2 afterward the dates are satisfied

{{#if ( is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York') }}ENTER TEXT 1 HERE{{else}}ENTER TEXT 2 HERE{{/if}}

{{#if ( is_current_time_between 'YYYY-MM-DD 00:00 America/Los Angeles' 'YYYY-MM-DD 23:59 America/Los Angeles') }}ENTER TEXT 1 HERE{{else}}ENTER TEXT 2 HERE{{/if}}

NOTE:

Is_current_time_between - check the current time of when the feed processes
'2022-12-16 00:00 America/Los_Angeles'/… - format for time check
Enter/Update the Text here : This is the text you’d like to appear for the dates being applied in yellow

Example Use Case 2:

Similar to Use Case 1, Eddie Bauer client would like to make sure a large banner that says BLACK FRIDAY DEAL! banner shows up on all products only on Black Friday (November 25, 2023) and then on November 26, 2023 at midnight, instead of going to it’s initial state, they want to keep a permanent “ON SALE” Banner Ad to replace the 'Black Friday Deal” banner instead of removing it.

{{#if ( is_current_time_between '2023-11-24 00:00 America/New York' '2023-11-24 23:59 America/New York') }}BLACK FRIDAY DEAL{{else}}ON SALE{{/if}}

Advanced Use Case 2:

Use this Max Rules to ADD Countdown Type Creative

{{#if ( is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York') }}ENTER TEXT 1 HERE{{else if ( is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York' )}}ENTER TEXT 2 HERE{{else if ( is_current_time_between 'YYYY-MM-DD 00:00 America/New_York' 'YYYY-MM-DD 23:59 America/New_York')}}ENTER TEXT 3 HERE{{else}}ENTER ELSE TEXT HERE{{/if}}

{{#if ( is_current_time_between '2023-12-23 00:00 America/Los_Angeles' '2023-12-23 23:59 America/Los_Angeles') }}2 DAYS UNTIL CHRISTMAS!{{else if ( is_current_time_between '2023-12-24 00:00 America/Los_Angeles' '2023-12-24 23:59 America/Los_Angeles' )}}IT'S CHRISTMAS EVE!{{else if ( is_current_time_between '2023-12-25 00:00 America/Los_Angeles' '2023-12-25 23:59 America/Los_Angeles')}}MERRY CHRISTMAS!{{else}}IT'S NOT CLOSE TO CHRISTMAS{{/if}}

NOTE:

Is_current_time_between/is_current_time_after - check the current time of when the feed processes
'2022-12-16 00:00 America/Los_Angeles'/… - format for time check
Enter the text here : This is the text you’d like to appear for the date

Example Use Case:

The Gap would like to create a countdown to Christmas starting from the 23rd of December so that anyone seeing their ads in Meta will see a banner telling them how many days left until Christmas….

So on the 23rd of December, a banner that will say 2 DAYS UNTIL CHRISTMAS! will be applied to all ads
on the 24th a banner that will say IT'S CHRISTMAS EVE! will be applied to all ads
On the 25th of Dec, a banner that will say MERRY CHRISTMAS! will be applied to all ads
Then all other days outside of the above 3 days, a banner that will say IT'S NOT CLOSE TO CHRISTMAS! will be applied to all ad