1. Help Center
  2. Customer Success Guides

How To: Campaign Tagging

Reviewing how to successfully set up and remove Campaign Tags for the Brand Report

Our new Campaign Reporting feature allows for clients to track each sponsored Campaign's performance in the new Brand Report — creating these tags will populate the Campaign Widget on the Brand Report! These workflow conditions are new to the platform and some function uniquely, so please review and handle with caution!

Do

- Use the Logo Label

- Keep these separate from PTV, use unique language specific to the campaign 

- Use any manually applied tag for the campaign in the workflow conditions.

- Use an advanced workflow to aggregate the tags all together (this makes it easier for product and dev to find any problems)

 

Don't

- Use more than one Sponsor per Campaign (!!!)

- Put Sponsor name in the Campaign tag, (instead you will apply the sponsor in a different line of code)

- Save the workflow without ensuring everything is correct(this removal process is trickier than regular tags)

 

Available WKLF Conditions 

  1. <addSponsor value="Rakuten" />
  2. <removeSponsor value="Rakuten" />
  3. <updateContentSeries value="Highlights" />
  4. <updateContentSeries value="" />
  5. <sponsors operator="Contains" value="Rakuten" />
  6. <sponsors operator="NotContains" value="Rakuten" />
  7. <contentSeries operator="Equal" value="Highlights" />
  8. <contentSeries operator="NotEqual" value="Highlights" />

Definitions

  1. This is how you add a Sponsor into the campaign, this will be in the Actions portion of the WKFL 
    1. MUST use the Logo Label 
  2. This is the action you will use to remove a Sponsor from a Campaign 
  3. This is how you add the Campaign Tag to a zitem whose conditions match the workflow. 
    1. This is applied in the actions portion of wkfl 
    2. Do NOT put the Sponsor name here 
    3. This creates a "hidden" tag, like the PTV  function "Text Mention:"
  4. This is how you remove a Campaign Tag
    1. Go to WKFL
    2. Leave code blank 
    3. Save retroactively 
  5. How to search for Campaigns that are assigned the Sponsor
  6. How to search for Campaigns that are NOT assigned to the Sponsor
  7. How to search for a specific Campaign 
  8. How to search for a campaign other than that specific Campaign 

Examples

Set up Campaign 

<workflow>
  <scope allFeeds="false" />
  <rules>
    <rule>
      <triggers>
        <trigger on="NewItem" />
      </triggers>
      <conditions>
        <and>
          <or>
          <message operator="Contains" value="Happy Birthday" />
          <message operator="Contains" value="HBD" />
          </or>
          <or>
            <fbSponsorTagName operator="Contains" value="Heineken" />
            <mentions operator="Contains" value="Heineken" />
            <message operator="Contains" value="Heineken" />
          <tags operator="Contains" value="Logo AI:Heineken" />
          </or>
        </and>
      </conditions>
      <actions>
      <addTag value="Heineken HBD" /> (This is the front end tag that shows in feed)
      <addSponsor value="Heineken" /> (Sends this Campaign to the Sponsor's Brand Report)
      <updateContentSeries value="Happy Birthday" /> (Creates the Campaign in the Brand Report)
      </actions>
    </rule>
  </rules>
</workflow>

Remove Full Campaign 

<workflow>
  <scope allFeeds="false" />
  <rules>
    <rule>
      <triggers>
        <trigger on="NewItem" />
      </triggers>
      <conditions>
        <and>
          <or>
          <message operator="Contains" value="Happy Birthday" />
          <message operator="Contains" value="HBD" />
          </or>
          <or>
            <fbSponsorTagName operator="Contains" value="Heineken" />
            <mentions operator="Contains" value="Heineken" />
            <message operator="Contains" value="Heineken" />
          <tags operator="Contains" value="Logo AI:Heineken" />
          </or>
        </and>
      </conditions>
      <actions>
    <addTag value="Heineken HBD" />
    <removeSponsor value="Heineken" /> (Notice the Difference here)
    <updateContentSeries value="" />
    </rule>
  </rules>
</workflow>

Use Manual Tag 

<workflow>
  <scope allFeeds="false" />
  <rules>
    <rule>
      <triggers>
        <trigger on="NewItem" />
      </triggers>
      <conditions>
      <and>
        <tags operator="Contains" value="Heineken Happy Birthday" />

        </and>
      </conditions>
    <actions>
    <addTag value="Heineken Happy Birthday" /> (This is the front end tag that shows in feed)
      <addSponsor value="Heineken" /> (Sends this Campaign to the Sponsor's Brand Report)
      <updateContentSeries value="Happy Birthday" /> (Creates the Campaign in the Brand Report)
      </actions>
  </rules>
</workflow>