Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Troubleshooting Campaigns

Understand why things may go wrong and how to fix them

Overview

Overview

Overview

When sending campaigns, you may face a scenario where you added your targeted lists and segment but your estimated recipients are 0 or there are sending or delivery failures. This article will address common issues and how to troubleshoot them.

Estimated recipients showing 0 or less than expected

You may add your Send to lists and/or segments which has contacts but your estimated recipients are still showing 0 or less than expected.

Why this may happen and what you can do?

  1. Missing valid identifier (email, phone or push token): The contacts in your lists or segment do not have the valid identifier required for the channel selected for your campaign. For example,For Email campaigns, email address is missing for the contactsFor SMS/WhatsApp/RCS campaigns, phone number is missing for the contactsFor Push campaigns, push token is missing for the contacts

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email address exists OR Phone number exists

  • You can click on any specific contact to see the identifiers like email, phone or push token

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Subscription attribute not set as Subscribed: The contacts in your lists or segment do not have the Subscription attribute required for the channel set as Subscribed. For example,For Email campaigns, Email Subscription needs to be set as SubscribedFor SMS campaigns, SMS Subscription needs to be set as SubscribedFor WhatsApp campaigns, WhatsApp Subscription needs to be set as Subscribedand so on.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email Subscription is Subscribed exists OR SMS Subscription is Subscribed OR WhatsApp Subscription is Subscribed etc. based on your channel for the campaign

  • You can click on any specific contact to see the attributes like Email Subscription, SMS Subscription, WhatsApp Subscription and so on

  • If subscription is missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Contact identifier (email, phone) is suppressed: The contacts in your lists or segment are suppressed for the channel selected for your campaign for marketing use case. For example, contact's email address is suppressed for Email marketing.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if If contact can receive Email Marketing OR SMS Marketing etc. based on your channel for the campaign

  • You can click on any specific contact to see if their is a suppressed status on their identifier

  • You can also search for the email or phone number in the Audience > Suppression lists section

  • If you want to unsuppress the contact, you can manually go to their 3 dots and unsupress them, however we do not recommend unsuppressing unless you are sure that they have wrongly been suppressed. Identifiers will get automatically suppress due to opt outs and invalid identifier


  1. Don't Send to option has reduced your final recipients: The contacts in your included lists or segments under Send to have been reduced due to exclusion lists or segments you have selected under Don't Send to

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Further add conditions which match the criteria of your exclusion lists or segments to check the final count of your contacts


  1. Missing contact locale when using Strict locale matching: The contacts in your included lists or segments do not have the Locales attribute set with any value and you have selected Strict Locale matching.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Locales has any value

  • You can click on any specific contact to see the value of the Locales attribute

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform

  • You could also switch to Automatic locale matching to ensure every recipient receives a message with default language

You may add your Send to lists and/or segments which has contacts but your estimated recipients are still showing 0 or less than expected.

Why this may happen and what you can do?

  1. Missing valid identifier (email, phone or push token): The contacts in your lists or segment do not have the valid identifier required for the channel selected for your campaign. For example,For Email campaigns, email address is missing for the contactsFor SMS/WhatsApp/RCS campaigns, phone number is missing for the contactsFor Push campaigns, push token is missing for the contacts

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email address exists OR Phone number exists

  • You can click on any specific contact to see the identifiers like email, phone or push token

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Subscription attribute not set as Subscribed: The contacts in your lists or segment do not have the Subscription attribute required for the channel set as Subscribed. For example,For Email campaigns, Email Subscription needs to be set as SubscribedFor SMS campaigns, SMS Subscription needs to be set as SubscribedFor WhatsApp campaigns, WhatsApp Subscription needs to be set as Subscribedand so on.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email Subscription is Subscribed exists OR SMS Subscription is Subscribed OR WhatsApp Subscription is Subscribed etc. based on your channel for the campaign

  • You can click on any specific contact to see the attributes like Email Subscription, SMS Subscription, WhatsApp Subscription and so on

  • If subscription is missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Contact identifier (email, phone) is suppressed: The contacts in your lists or segment are suppressed for the channel selected for your campaign for marketing use case. For example, contact's email address is suppressed for Email marketing.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if If contact can receive Email Marketing OR SMS Marketing etc. based on your channel for the campaign

  • You can click on any specific contact to see if their is a suppressed status on their identifier

  • You can also search for the email or phone number in the Audience > Suppression lists section

  • If you want to unsuppress the contact, you can manually go to their 3 dots and unsupress them, however we do not recommend unsuppressing unless you are sure that they have wrongly been suppressed. Identifiers will get automatically suppress due to opt outs and invalid identifier


  1. Don't Send to option has reduced your final recipients: The contacts in your included lists or segments under Send to have been reduced due to exclusion lists or segments you have selected under Don't Send to

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Further add conditions which match the criteria of your exclusion lists or segments to check the final count of your contacts


  1. Missing contact locale when using Strict locale matching: The contacts in your included lists or segments do not have the Locales attribute set with any value and you have selected Strict Locale matching.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Locales has any value

  • You can click on any specific contact to see the value of the Locales attribute

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform

  • You could also switch to Automatic locale matching to ensure every recipient receives a message with default language

You may add your Send to lists and/or segments which has contacts but your estimated recipients are still showing 0 or less than expected.

Why this may happen and what you can do?

  1. Missing valid identifier (email, phone or push token): The contacts in your lists or segment do not have the valid identifier required for the channel selected for your campaign. For example,For Email campaigns, email address is missing for the contactsFor SMS/WhatsApp/RCS campaigns, phone number is missing for the contactsFor Push campaigns, push token is missing for the contacts

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email address exists OR Phone number exists

  • You can click on any specific contact to see the identifiers like email, phone or push token

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Subscription attribute not set as Subscribed: The contacts in your lists or segment do not have the Subscription attribute required for the channel set as Subscribed. For example,For Email campaigns, Email Subscription needs to be set as SubscribedFor SMS campaigns, SMS Subscription needs to be set as SubscribedFor WhatsApp campaigns, WhatsApp Subscription needs to be set as Subscribedand so on.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Email Subscription is Subscribed exists OR SMS Subscription is Subscribed OR WhatsApp Subscription is Subscribed etc. based on your channel for the campaign

  • You can click on any specific contact to see the attributes like Email Subscription, SMS Subscription, WhatsApp Subscription and so on

  • If subscription is missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform


  1. Contact identifier (email, phone) is suppressed: The contacts in your lists or segment are suppressed for the channel selected for your campaign for marketing use case. For example, contact's email address is suppressed for Email marketing.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if If contact can receive Email Marketing OR SMS Marketing etc. based on your channel for the campaign

  • You can click on any specific contact to see if their is a suppressed status on their identifier

  • You can also search for the email or phone number in the Audience > Suppression lists section

  • If you want to unsuppress the contact, you can manually go to their 3 dots and unsupress them, however we do not recommend unsuppressing unless you are sure that they have wrongly been suppressed. Identifiers will get automatically suppress due to opt outs and invalid identifier


  1. Don't Send to option has reduced your final recipients: The contacts in your included lists or segments under Send to have been reduced due to exclusion lists or segments you have selected under Don't Send to

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Further add conditions which match the criteria of your exclusion lists or segments to check the final count of your contacts


  1. Missing contact locale when using Strict locale matching: The contacts in your included lists or segments do not have the Locales attribute set with any value and you have selected Strict Locale matching.

Troubleshooting Steps:

  • Go to Contacts and apply advanced filters to match the criteria of your lists or segments

  • Add condition if Properties of contact > Locales has any value

  • You can click on any specific contact to see the value of the Locales attribute

  • If missing for some contacts, you can re-import them via csv or adjust your integration attributes mapping sync if the data is present in the source platform

  • You could also switch to Automatic locale matching to ensure every recipient receives a message with default language

Campaign messages are not sent

Your campaign has Sent or Failed status and has sent 0 or less than expected as compared to the targeted recipients

  • Re-check your targeted recipients: If you have missed this while building the campaign or your targeted segment is dynamic it may change over a period of time, hence you can check the Recipients metric in Campaign report which indicates what was the target audience at the time of sending

  • Limit maximum recipients: If you have set a max recipient limit when building the campaign, it will restrict sending to that number

  • Check Failure Reasons Tab in Campaign Reports: Go to Campaign Reports > Failure Reasons to check why your messages are skipped or failed sending

Sending Failure Reasons will prevent all or partial messages of the campaign to be not sent. These can include the following:

Skip/Failure Reason

Description

Troubleshoot

Excluded lists/segments

Contacts skipped as Lists/Segments are selected to be excluded in the campaign

Try recreating a segment with all your inclusions and exclusion segments/lists to check the final recipient count

Frequency cap reached

Recently messaged contacts have been skipped due to frequency cap

Turn off the toggle under Recipients > Advanced to skip recently messaged contacts. Update frequency cap setting if needed.

Not subscribed

Subscription attribute of contacts is not marked Subscribed or they have opted out

Update the subscription attribute if you think these are incorrect. Recommend to consider contact subscription

Suppressed

Recipient identifier i.e.Email / Phone number is suppressed

Check the condition for If contact can receive

Template inactive or missing

Content template is not in active or published or approved status or is missing

Send again by duplicating and reselecting the active template

Campaign messages are sent but not delivered

This means that Bird has sent the message but it has not been successfully delivered to the recipient. This may happen due to a variety of reasons.

Check Failure Reasons Tab in Campaign Reports: Go to Campaign Reports > Failure Reasons to check why your messages have failed delivery

Let’s connect you with a Bird expert.
See the full power of the Bird in 30 minutes.

By submitting, you agree Bird may contact you about our products and services.

You can unsubscribe anytime. See Bird's Privacy Statement for details on data processing.

Newsletter

Stay up to date with Bird through weekly updates to your inbox.

Let’s connect you with a Bird expert.
See the full power of the Bird in 30 minutes.

By submitting, you agree Bird may contact you about our products and services.

You can unsubscribe anytime. See Bird's Privacy Statement for details on data processing.

Newsletter

Stay up to date with Bird through weekly updates to your inbox.

Let’s connect you with a Bird expert.
See the full power of the Bird in 30 minutes.

By submitting, you agree Bird may contact you about our products and services.

You can unsubscribe anytime. See Bird's Privacy Statement for details on data processing.

R

Reach

G

Grow

M

Manage

A

Automate

Newsletter

Stay up to date with Bird through weekly updates to your inbox.