Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

createtrackingoptout and deletetrackingoptout

Deactivate and reactivate the use of action-based data for a recipient in Optimizely Campaign.

These procedures are available in the form and mail service.

On forms or in emails, you can give recipients the option to reject the use of personally identifiable data. If they do, the recipients are not included in action-based target groups (e.g., "has clicked Link B in Mailing A"), even if they meet the conditions of the target group.

📘

Notes on tracking opt-out

  • Opens and clicks are still saved anonymously and included in global reports. The open and clicks in a mailing of such a recipient would therefore be counted. However, the recipient is not taken into account if you create a target group containing all recipients of this mailing who opened or clicked it.
  • All personal action-based data are anonymized from the time of activation. Action data in the recipient history is not retrospectively anonymized.

Parameter

NameMandatoryDefault valueDescription
bmRecipientIdYes/NoThe recipient ID (usually the email address)
This parameter is not required when using the mail service. This parameter is required when using the form service.

Return values

ValueDescription
ok- createtrackingoptout – The use of action-based data was deactivated for the recipient.
- deletetrackingoptout – The use of action-based data was reactivated for the recipient
vetoedThe execution of this operation was prevented because it is deactivated. Ask customer support to activate this feature.
wrong_tagAuthorization failed.
Error codes:
- 501=wrong authentication tag
- 502=wrong request IP
- 503=wrong request method
- 504=wrong protocol
- 505=wrong recipient list
- 506=wrong action
- 507=action not found
If a verification of the authentication tag does not solve the problem, contact customer support.
missing_idNo bmRecipientId was transmitted (mandatory) when using the form service.
system_errorA general error has occurred

Example 1

.../form/.../[email protected] 

The use of action-based data has been deactivated for the recipient with ID [email protected].

Example 2

.../form/.../[email protected] 

The use of action-based data has been reactivated for the recipient with ID [email protected].