Pinterest Ads URL Macro Glossary

{adgroupid}

Pulls the ID of the ad group, which serves as the ad group's unique identifier.

{adgroupname}, {ad_group_name}

Those macros capture the respective ad group's name. Pinterest Ads supports two different macros for the name of the ad group.

{adid}

Captures the Pin promotion ID, which serves as its unique identifier.

{campaignid}

Pulls the ID of the campaign, which serves as its unique identifier.

{campaignname}, {campaign_name}

Those macros capture the respective campaign's name. Pinterest Ads supports two different macros for the name of the campaign.

{creative_id}

Captures the Pin promotion ID, which serves as its unique identifier.

{device}

Captures the device of the Pinterest user who clicked on the ad. Pinterest Ads abbreviates the various devices as follows:

• Computer: c
• Mobile: m
• Tablet: t

{keyword}

Captures the keyword string that matched the standard ad. The keyword string is percent-encoded, sometimes also referred to as URL encoded. This means that certain characters that are not accepted for usage in URLs. A space will for example replaced with %20. So, if the keyword is cell phone case the captures keyword string will be cell%20phone%20case.

{keyword_id}

Captures the ID of the keyword that matched the standard ad.

{lpurl}

Pulls the URL from either the ad_link or the link field. It's important to note that the URL will be pulled differently depending on the placement of the macro. If the macro is placed in or after a tracking URL, certain characters (e.g., slash, question mark, colon, equal sign, quotation mark, hash, ampersand, space) will automatically be percent-encoded. For example, a colon will be replaced with %3A, while a slash will be replaced with %2F. So, https:// would be encoded as https%3A%2F%2F. If, however, the macro is placed before the tracking URL, no percent-encoding will take place, meaning the URL will be pulled as is.

{organic_url}

Captures the entirety of the URL given at Pin creation. This macro applies to manually created collection ads that don't use the catalog sales objective.

{product_id}

Pulls the ID of the product, which serves as its unique identifier.

{product_name}

This macro captures the name of the product in question.

{product_partition_id}

Captures the ID of the product group, which serves as its unique identifier.

{promoted_product_group_id}

This macro pulls the ID of the product group within the Ads Manager, which serves as its unique identifier.

{unescapedlpurl}

Unlike the {lpurl} macro, the {unescapedlpurl} macro pulls the URL as is. This means that the placement of the macro has no bearing on the pulled URL and no percent-encoding of characters takes place.