HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityLog In

createtrackingoptout and deletetrackingoptout

Let you 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

  • **Note**: If a verification of the authentication tag does not solve the problem, contact [customer support](mailto:[email protected]). | | missing\_id | No **bmRecipientId** was transmitted (mandatory) when using the form service. | | system\_error | A 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].


    What’s Next
    Did this page help you?