Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add relevant information from KB articles #8436

Merged
merged 5 commits into from
Nov 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,9 @@ It's also important to understand your [active users]({{site.baseurl}}/user_guid

### Feature awareness

If your goal is to draw your users toward a new feature or app version, use a multichannel strategy with a focus on in-app channels. [In-app messages][5] and [Content Cards][7] are generally less disruptive if a user doesn't wish to update immediately. Be sure to include [deep links]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/deep_linking_to_in-app_content/) to the appropriate app store.
If your goal is to draw your users toward a new feature or app version, use a multichannel strategy with a focus on in-app channels. [In-app messages][5] and [Content Cards][7] are generally less disruptive if a user doesn't wish to update immediately.

Be sure to include [deep links]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/deep_linking_to_in-app_content/) to the appropriate app store.

Persuading users to update their app or change how they use your app can be difficult, so let them know about all the benefits of the new version or features and how it will improve their experience with your app.

Expand All @@ -60,10 +62,18 @@ To ensure higher ratings, ask your power users to review your app in the app sto
- Has used these apps more than 10 times in the last 14 days
- Has spent more than 50 dollars

![][6]
![An example of a segment that targets power users of an app.][6]

Visiting the app store takes time on the part of your users. To maximize the likelihood that they will go through the extra effort, request a rating or review after they just had a positive experience with your app. For instance, ask them after they beat a game level or made a purchase using a discount code. Our article on [data opt-in]({{site.baseurl}}/user_guide/message_building_by_channel/email/managing_user_subscriptions/#subscription-states) has more information on ways to ensure your request agrees with users' workflow expectations.

## Scheduling your campaigns

When editing campaign schedules or audiences, note the following best practices:

- **One-time schedule campaigns:** You can edit the campaign up until the scheduled send time.
- **Recurring scheduled Campaigns:** You can edit the campaign up until the scheduled send time.
- **Local send time campaigns:** Don't make edits 24 hours prior to the scheduled send time.
- **Optimal send time campaigns:** Don't make edits 24 hours prior to midnight of the day the campaign is scheduled to send on.

[6]: {% image_buster /assets/img_archive/ratings_power_users.png %}
[5]: {{site.baseurl}}/user_guide/message_building_by_channel/in-app_messages/about/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ tool:

> This reference article covers what can be changed in a Canvas after the initial launch.

For Canvases launched with Canvas Flow or the original editor, you can edit your Canvases after launch by:
You can edit your Canvases after launch by:

* Inserting new Canvas steps into the user journey
* Adding new variants and connections
* Adjusting variant distribution
Expand Down Expand Up @@ -66,7 +67,8 @@ Stopping a Canvas will not exit users who are waiting to receive a message. If y

## Canvas details

You can edit these Canvas settings and information after a Canvas launches using either editor (the original or Canvas Flow):
You can edit the following Canvas settings and information after a Canvas launches:

* Canvas name and description
* Teams and tags
* Entry type, schedule, and controls
Expand All @@ -77,12 +79,14 @@ You can edit these Canvas settings and information after a Canvas launches using
* Target audience

After a Canvas has launched:

- Conversion events can't be edited.
- [Audience paths]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/audience_paths/), [action paths]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/action_paths/), and [experiment paths]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/experiment_step) can't be added or removed to these steps and can't be reordered to adjust the ranking. As a workaround, edit the active Canvas and duplicate the step, which will be editable until you launch the draft.

### Individual steps

For individual Canvas steps, you can edit the following details after launch:

* Name
* Message content
* Triggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,32 +25,50 @@ To create or edit your custom footer, do the following:
1. Go to **Settings** > **Email Preferences**.

{% alert note %}
If you are using the [older navigation]({{site.baseurl}}/navigation), this page is called **Email Settings** and is located under **Manage Settings**.
If you're using the [older navigation]({{site.baseurl}}/navigation), this page is called **Email Settings** and is located under **Manage Settings**.
{% endalert %}

{: start="2"}
2. Go to the **Custom Footer** section and turn on custom footers.
3. Edit your footer in the **Compose** section and send a test message.
3. Edit your footer in the **Compose** section.
4. Send a test message.

![][20]
![An example of a custom footer.][20]

The default footer uses the {% raw %}`{{${set_user_to_unsubscribed_url}}}`{% endraw %} attribute and our physical mailing address. To comply with CAN-SPAM regulations, your custom footer must include {% raw %}`{{${set_user_to_unsubscribed_url}}}`{% endraw %}. You won't be able to save a custom footer without this attribute.
The default footer uses the {% raw %}`{{${set_user_to_unsubscribed_url}}}`{% endraw %} attribute and our physical mailing address. If you're using this default, be sure to select **<other>** for the **Protocol**.

If using the default footer, which uses the {% raw %}`{{${set_user_to_unsubscribed_url}}}`{% endraw %} attribute, be sure to select **<other>** for the **Protocol**.
{% alert important %}
To comply with CAN-SPAM regulations, your custom footer must include {% raw %}`{{${set_user_to_unsubscribed_url}}}`{% endraw %}. You won't be able to save a custom footer without this attribute.
{% endalert %}

![Protocol and URL values needed for the custom footer.][24]{: style="max-width:50%;"}

## Footers without unsubscribe links

Be very careful when using a template with the custom footer {% raw %}`{{${email_footer}}}` but without the `{{${set_user_to_unsubscribed_url}}}`{% endraw %} unsubscribe link tag. A warning will appear, but it'll be your choice to send an email with or without an unsubscribe link.

**Warning within email composer:**<br>![Example email composed without a footer.][21]
Here's a warning in the email composer:

![Example email composed without a footer.][21]

Here's a warning in the campaign composer:

**Warning within campaign composer:**<br>![No-footer campaign composition.][22]
![No-footer campaign composition.][22]

### Adding a custom unsubscribe link

To add a custom unsubscribe link, you can change the unsubscribe link in the custom footer from {% raw %} `{{${set_user_to_unsubscribed_url}}}` {% endraw %} to a link to your own website with a query parameter that includes the user ID. An example is:
{% raw %}
> https://www.braze.com/unsubscribe?user_id={{${user_id}}}
{% endraw %}

Next, call the [`/email/status` endpoint]({{site.baseurl}}/api/endpoints/email/post_email_subscription_status/) to update the user's subscription status. For more details, see our documentation on [changing email subscription status]({{site.baseurl}}/user_guide/message_building_by_channel/email/managing_user_subscriptions/#changing-email-subscriptions).

Then, save this new link. The default Braze unsubscribe tag {%raw%}(``${set_user_to_unsubscribed_url}``){%endraw%} must be in the footer. This means you need to include the default link by "hiding" it by either placing the tag in a comment or in a hidden `<div>` tag.

## Best practices

Braze suggests the following best practices when creating and using custom footers.
We suggest the following best practices when creating and using custom footers.

### Personalizing with attributes

Expand All @@ -73,7 +91,9 @@ As a best practice, Braze recommends including both an unsubscribe link (such as

### Setting custom footers for plaintext emails

You can also choose to set a custom footer for plaintext emails from the **Subscription Pages and Footers** tab on the **Email Preferences** page, which follows the same rules as the custom footer for HTML emails. If you don't include a plaintext footer, Braze will automatically build one from the HTML footer. When your custom footers are to your liking, click **Save** at the bottom of the page.
You can also choose to set a custom footer for plaintext emails from the **Subscription Pages and Footers** tab on the **Email Preferences** page, which follows the same rules as the custom footer for HTML emails.

If you don't include a plaintext footer, Braze will automatically build one from the HTML footer. When your custom footers are to your liking, select **Save**.

![Email with Set Custom Plaintext Footer option selected.][23]{: style="max-width:70%" }

Expand Down
8 changes: 7 additions & 1 deletion _docs/_user_guide/message_building_by_channel/email/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Finally, your business and the types of emails you send may also affect delivery
Email delivery metrics (deliveries, bounces, and spam rate) may not add up to 100% because of emails that are soft bounced and then not delivered after the retry period of up to 72 hours.

Soft bounces are emails that bounce due to a temporary or transient issue such as "mailbox full," "server temporarily not available," and more. If a soft bounced email is still not delivered after 72 hours, this email will not be accounted for in the campaign delivery metrics.
å

### What are open tracking pixels?

[Open tracking pixels]({{site.baseurl}}/user_guide/administrative/app_settings/email_settings/#changing-location-of-tracking-pixel) leverage a sender's email click tracking domain to track email open events. The pixel is an image tag appended to the email's HTML. It is most commonly the last HTML element within the body tag. When a user loads their email, a request is made to populate the image from the branded tracking domain, which logs an open event.
Expand All @@ -66,6 +66,12 @@ Certain elements of an email message, such as overly long messages or too many e

For best practices on how to handle these responses, refer to [Handling increases in click rates]({{site.baseurl}}/help/help_articles/email/open_rates/).

### How can I remove an email address from the bounce or spam list?

You can remove bounced emails and emails on the spam list with the following endpoints:
- [`/email/bounce/remove`]({{site.baseurl}}/api/endpoints/email/post_remove_hard_bounces)
- [`/email/spam/remove`]({{site.baseurl}}/api/endpoints/email/post_remove_spam)

### How can I check a user's email subscription group?

- **User Profile:** Individual user profiles can be accessed through the Braze dashboard from the [Search Users]({{site.baseurl}}/user_guide/engagement_tools/segments/user_profiles/#access-profiles) page. Here, you can look up user profiles by email address, phone number, or external user ID. When inside a user profile, under the Engagement tab, you can view a user's email subscription groups.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ No, Braze does not offer this functionality. This is because an increasing major

There is a redirection option for the unsubscribe page.

You could change the unsubscribe link in the custom footer from {% raw %} `{{${set_user_to_unsubscribed_url}}}` {% endraw %} to a link to your own website with a query parameter that includes the user ID. For example, something like:
You could change the unsubscribe link in the custom footer from {% raw %} `{{${set_user_to_unsubscribed_url}}}` {% endraw %} to a link to your own website with a query parameter that includes the user ID. An example is:
{% raw %}
> https://www.braze.com/unsubscribe?user_id={{${user_id}}}
{% endraw %}
Expand Down