Beispiel-JavaScript-SDK und Anleitung

Das einfachste Modell für die Verwendung des SDK ist ein Erfassungspunkt mit einem einzigen Zweck ohne Themen und dem Interaktionstyp „Nur Formularübermittlung“.  Bei Interaktionen vom Typ „Nur Formularübermittlung“ klickt ein Benutzer auf die Schaltfläche „Formular übermitteln“ oder auf eine ähnliche Schaltfläche und ein Einwilligungsvorgang wird für einen einzigen Verarbeitungszweck erstellt.

Im Folgenden finden Sie ein Beispiel für die SDK-Ausgabe für dieses Modell unter Verwendung nicht gehosteter Einstellungen:

<!-- OneTrust Consent Receipt Start -->
 
<script src="https://{BASE URL}/consent-receipt-scripts/otconsent-1.0.js" type="text/javascript" charset="UTF-8" id="consent-receipt-script">
triggerId="trigger";
identifierId="inputEmail";
confirmationId="confirmation";
token="eyJhbGciOiJSUzUxMiJ9.eyJwcm9jZXNzSWQiOiJlNWM1MzJjMi0yYzAyLTQ4OGEtYWY5MS02ZDBkOWNmZGVlZjUiLCJpYXQiOiIyMDE4LTA3LTI0VDExOjAzOjQxLjUyIiwibW9jIjoiV0VCX0ZPUk0iLCJzdWIiOiJlbWFpbCIsImlzcyI6Imh0dHBzOi8vZ292aWNwIiwidGVuYW50SWQiOiIxODRhMjBlNC1jODU4LTRlZDYtOTI5NC05ZDBjN2JiYzFhOWMiLCJkZXNjcmlwdGlvbiI6ImdvdmljcCIsImNvbnNlbnRUeXBlIjoiRk9STVNVQk1JVCIsInBvbGljeV91cmkiOiJodHRwczovL2dvdmljcCIsInB1cnBvc2VzIjpbeyJpZCI6IjM2NzMwNGIyLWU4MDktNDRmMi1iOWZhLTcwMGEwNjAyNGEzNSIsInRvcGljcyI6W119XSwiZHNEYXRhRWxlbWVudHMiOlsiRmlyc3ROYW1lIiwiTGFzdE5hbWUiXX0.muL6uxuSi7irrd0iqDBn3faggx748-2lsV_IHpu_jPfiSjNP9DWw9zUBvcb8K_STB5RU1Ku3k5vQmhVOv34tsEdrinLEVailGDIQapY1xxhPMUfosO2s5KM7ECPlFStodPt3c6c5xVDDYteAWoPy-1CtStHto2jLY6zd_CQaDA6llIu1ebNnv5Z2B261mfxpUZ5loIBXa1Z0Qd2NH6zgi-GTWZXv82e6HcZtIMLcSJ3HHh-CJPsvB-Xdx7SyF8t9xrFXQ4zIR4fpFHRqD2F8RU911KNj4Pa88vDEtpyXfkVLitqdCkfdWUgkWghPPkzU8Vh4X1PQMv58GEloOtLvdg";
settings="eyJyZWNlaXB0QXBpRW5kcG9pbnQiOiJodHRwczovL2NyLWRzLWVhc3R1cy5kZXYub3RkZXYub3JnL3JlcXVlc3QvdjEvY29uc2VudHJlY2VpcHRzIiwibWFudWFsVHJpZ2dlciI6ZmFsc2UsImNvbnRpbnVlT25FcnJvciI6dHJ1ZX0=";
</script>
<script type="text/javascript" charset="UTF-8">
  OneTrust.ScriptTag.Preferences = [
    {
       "purpose": "{PURPOSE GUID}",
       "identifierAttributes": "value",
       "identifierValues": "Purpose1 Name",
        "labels": [
        {
        "language": "de",
        "label": "Purpose1 DE",
        "description": "Allows us to send you news and information about our products and services. DE"
        },
        {
        "language": "en-us",
        "label": "Purpose1",
        "description": "Allows us to send you news and information about our products and services."
        },
        {
        "language": "fr",
        "label": "Purpose1 FR",
        "description": "Allows us to send you news and information about our products and services. FR"
        }
      ]
    }
  ];
</script>
<!-- OneTrust Consent Receipt End -->

So verwenden Sie das obige Skript:

Wenn Sie die Einwilligung für mehrere Verarbeitungszwecke und/oder Themen, die einem Zweck hinzugefügt wurden, einholen und Ihr Erfassungspunkt einen Kontrollkästchen-Interaktionstyp verwendet, sucht das SDK nach Kontrollkästchen-Elementen im Webformular, um die Einwilligung für jeden Zweck anzuzeigen. Sie müssen das SDK so konfigurieren, dass die korrekten Bestätigungs- und Einwilligungsvorgangsinformationen erstellt werden, wenn Besucher die verschiedenen Optionen auswählen, um ihre Einwilligung anzugeben.

Im Folgenden finden Sie ein Beispiel für die SDK-Ausgabe für dieses Modell:

<!-- OneTrust Consent Receipt Start -->
 
<script src="https://{BASE URL}/consent-receipt-scripts/otconsent-1.0.js" type="text/javascript" charset="UTF-8" id="consent-receipt-script">
triggerId="trigger";
identifierId="inputEmail";
conditionalConsentTriggerId="conditionalCheckbox";
confirmationId="confirmation";
token="eyJhbGciOiJSUzUxMiJ9.eyJwcm9jZXNzSWQiOiJlNWM1MzJjMi0yYzAyLTQ4OGEtYWY5MS02ZDBkOWNmZGVlZjUiLCJpYXQiOiIyMDE4LTA3LTI0VDExOjAzOjQxLjUyIiwibW9jIjoiV0VCX0ZPUk0iLCJzdWIiOiJlbWFpbCIsImlzcyI6Imh0dHBzOi8vZ292aWNwIiwidGVuYW50SWQiOiIxODRhMjBlNC1jODU4LTRlZDYtOTI5NC05ZDBjN2JiYzFhOWMiLCJkZXNjcmlwdGlvbiI6ImdvdmljcCIsImNvbnNlbnRUeXBlIjoiT1BUSU5DSEVDS0JPWCIsInBvbGljeV91cmkiOiJodHRwczovL2dvdmljcCIsInB1cnBvc2VzIjpbeyJpZCI6IjM2NzMwNGIyLWU4MDktNDRmMi1iOWZhLTcwMGEwNjAyNGEzNSIsInRvcGljcyI6W119LHsiaWQiOiJiYTU0ZWIyNS05MGYwLTQ2MzMtYWIxMi1jN2JmNWFmZGQ4NTYiLCJ0b3BpY3MiOlt7ImlkIjoiMDBiZTYwOGItMjhkZC00NzBhLWJlNjItZGE5ZWMwNTBlYjQwIn0seyJpZCI6ImY3MTJmNzczLWUyMWUtNDc1Mi05NjEwLWNlZTA0YjU2ZDMxMSJ9LHsiaWQiOiI0NmYwYzkwYS1lZTdiLTRhODQtYTkzMi1hZDU2MDlkNzE2YTIifV19XSwiZHNEYXRhRWxlbWVudHMiOlsiRmlyc3ROYW1lIiwiTGFzdE5hbWUiXX0.lE9D0Ri025kLyhfcKUJ2OV6CfH3wrhijh_J8rs_9yW9wmoQ3RcLzgeTtDiX8GAKc6AFwSQXukyscMW_xg-Agjq0e6RqOUoE3hBZhmcKX4DKQ_Oo8a-Kom5AMOndrpgGHjn2emNBrHnhG_snVMeW_Rl0KUkb6xqXwfyUjqrdLS5K6K39hJJLQDZDtKzRUEtbK0AL98ImzWyrECXnIc4B04BXIF9fGjDSql0aRCq8Lx64a5rY2qWKUf6m8Z0LFcvFYsHykDT-Aa5GCg0SOgR6rg2WGa1rafJuZd-fCNw8jeN9bRKn559RNz24n6kUIx9eGXIJsPdNMVrCBhvvz6zgyDQ";
settings="eyJyZWNlaXB0QXBpRW5kcG9pbnQiOiJodHRwczovL2NyLWRzLWVhc3R1cy5kZXYub3RkZXYub3JnL3JlcXVlc3QvdjEvY29uc2VudHJlY2VpcHRzIiwibWFudWFsVHJpZ2dlciI6ZmFsc2UsImNvbnRpbnVlT25FcnJvciI6dHJ1ZX0=";
</script>
<script type="text/javascript" charset="UTF-8">
OneTrust.ScriptTag.Preferences = [
   {
       "purpose": "{GUID}",
       "identifierAttributes": "value",
       "identifierValues": "Purpose1 Name",
        "labels": [
        {
        "language": "de",
        "label": "Purpose1 DE",
        "description": "Allows us to send you news and information about our products and services. DE"
        },
        {
        "language": "en-us",
        "label": "Purpose1",
        "description": "Allows us to send you news and information about our products and services."
        },
        {
        "language": "fr",
        "label": "Purpose1 FR",
        "description": "Allows us to send you news and information about our products and services. FR"
        }
      ]
    } ,
    {
       "purpose": "{GUID}",
       "identifierAttributes": "value",
       "identifierValues": "Purpose2 Name",
        "labels": [
        {
        "language": "de",
        "label": "Purpose2 DE",
        "description": "Allows us to send you news and information about our products and services. DE"
        },
        {
        "language": "en-us",
        "label": "Purpose2",
        "description": "Allows us to send you news and information about our products and services."
        },
        {
        "language": "fr",
        "label": "Purpose2 FR",
        "description": "Allows us to send you news and information about our products and services. FR"
        }
      ]
       "topics" : [
        {  
            "topic": "{GUID}",
            "identifierAttributes": "value",
            "identifierValues": "Topic1",
            "labels": [
            {
            "language": "en-us",
            "label": "Topic1"
            },
            {
            "language": "de",
            "label": "Topic1 DE"
            }
          ]
        } ,
        {
            "topic": "{GUID}",
            "identifierAttributes": "value",
            "identifierValues": "Topic2",
            "labels": [
            {
            "language": "en-us",
            "label": "Topic2"
            },
            {
            "language": "de",
            "label": "Topic2 DE"
            }
          ]
        } ,
        {
            "topic": "{GUID}",
            "identifierAttributes": "value",
            "identifierValues": "Topic3",
            "labels": [
            {
            "language": "en-us",
            "label": "Topic3"
            },
            {
            "language": "de",
            "label": "Topic3 DE"
            }
          ]
        }
       ]
    }
];
 
</script>
<!-- OneTrust Consent Receipt End -->

So verwenden Sie das obige Skript:

Wenn Sie den obigen Code verwenden, müssen Sie möglicherweise die Werte identifierAttributes und identifierValues so ändern, dass sie dem Formular auf Ihrer Seite entsprechen (oder Ihr Formular so bearbeiten, dass diese Werte verwendet werden), und zwar für jeden Zweck der Verarbeitung in Ihrem Erfassungspunkt.

Beispiel: Die erste Zweckzuordnung im obigen Code (mit „identifierAttributes“: „value“ und „identifierValues“: „Purpose1 Name“) würde dem folgenden Kontrollkästchen zugeordnet werden: <input type="checkbox" value="Purpose1 Name" />

Die Zuordnungen für benutzerdefinierte Präferenzen funktionieren ähnlich denen von Zwecken und Themen. Zu jedem Zweck müssen die Optionen für benutzerdefinierte Präferenzen „identifierAttributes“ und „identifierValues“ zu den IDs in den Formularfeldern passen, die es dem SDK ermöglichen, die korrekten Werte beim Übermitteln abzurufen.

Im Folgenden finden Sie ein Beispiel für die Zuordnung benutzerdefinierter Präferenzen in JavaScript.

<script>
OneTrust.ScriptTag.Preferences = [
    {
      "purpose": "{GUID}",
      "identifierValues": "purpose1",
      "identifierAttributes": "value",
      "topics": [],
      "customPreferences": [
        {
          "customPreference": "{GUID}",
          "options": [
            {
              "option": "{GUID}",
              "identifierValues": "customPreference1Option1",
              "identifierAttributes": "value"
            },
            {
              "option": "{GUID}",
              "identifierValues": "customPreference1Option2",
              "identifierAttributes": "value"
            },
            {
              "option": "{GUID}",
              "identifierValues": "customPreference1Option3",
              "identifierAttributes": "value",
               
            }
          ]
        }
      ]
    }
  ]
}];
</script>

Im Folgenden finden Sie ein Beispiel für die Zuordnung benutzerdefinierter Präferenzen in HTML-Webformularen.

<form action="confirm.html" method="get">
    <input type="hidden" id="confirmation" name="receiptId" value="" />
 
    <label for="firstName" class="sr-only">Your first name</label>
    <input type="text" id="firstName" placeholder="Your first name" autocomplete='given-name'>
 
    <label for="lastName" class="sr-only">Your last name</label>
    <input type="text" id="lastName" placeholder="Your last name" autocomplete='family-name'>
 
    <label for="inputEmail" class="sr-only">Email address</label>
    <input type="email" id="inputEmail"placeholder="Email address" required
            autocomplete='email'>
 
    <div class="checkbox">
        <label>
            <input type="checkbox" value="purpose1"> Purpose checkbox for Purpose 1
        </label>
 
        <div class="ml-1 my-1">
            <h6>Custom Preferences</h6>
 
            <label>
                <select id="customPreferenceOptions">
                    <option selected value="">
                        -----------
                    </option>
                    <option value="customPreference1Option1">
                        Custom Preference Option 1
                    </option>
 
                    <option value="customPreference1Option2">
                        Custom Preference Option 2
                    </option>
 
                    <option value="customPreference1Option3">
                        Custom Preference Option 3
                    </option>
                </select>
            </label>
        </div>
    </div>
 
    <button id="trigger" type="button">Submit form</button>
</form>

interface CustomPreferenceDefinition {
   identifierValues: string;
   identifierAttributes: string;
   customPreference: string;
   getOptionsValue(): string[];
}

OneTrust.Api.SetCustomPreferencesDefinitions(purpose: string, definitions: CustomPreferenceDefinition[]): void;

<form action="confirm.html" method="get">
    <input type="hidden" id="confirmation" name="receiptId" value="" />
 
    <label for="firstName">Your first name</label>
    <input type="text" id="firstName" placeholder="Your first name" autocomplete='given-name'>
 
    <label for="lastName">Your last name</label>
    <input type="text" id="lastName" placeholder="Your last name" autocomplete='family-name'>
 
    <label for="inputEmail" class="sr-only">Email address</label>
    <input type="email" id="inputEmail" placeholder="Email address" requiredautocomplete='email'>
 
    <div>
        <label>
            <input type="checkbox" value="purpose1"> Purpose checkbox for Purpose 1
        </label>
 
        <div class="ml-1 my-1">
            <h6>Custom Preferences</h6>
 
            <label>
                <select id="customPreferenceOptions">
                    <option selected value="">
                        -----------
                    </option>
                    <option value="customPreference1Option1">
                        Custom Preference Option 1
                    </option>
                    <option value="customPreference1Option2">
                        Custom Preference Option 2
                    </option>
                    <option value="customPreference1Option3">
                        Custom Preference Option 3
                    </option>
                </select>
            </label>
        </div>
    </div>
 
    <button id="trigger" type="button">Submit form</button>
</form>

// To ensure external settings are loaded, use the Initialized promise:
OneTrust.Api.Initialized.then(() => {
    console.log("External settings loaded. We're ready to use them.");
 
    const PURPOSE_ID = 'a6570910-4d90-48f8-8f8d-5f0b4af0ce12';
 
    // custom function to get the ID of the selected option
    const getOptionsValue = () => { 
        // select with id "customPreferenceOptions"
        const options = document.getElementById('customPreferenceOptions');
 
        // return the option's value attribute
        return options ? [options.value] : [];
    };
 
    // define custom preferences definitions for purpose with id PURPOSE_ID
    OneTrust.Api.SetCustomPreferencesDefinitions(PURPOSE_ID, [{
        identifierValues: 'customPreference1',
        getOptionsValue
    }]);
});

Wenn Sie die Version des SDK mit gehosteten Einstellungen verwenden, können Sie die folgenden beiden Optionen nutzen:

Option 1:

Ändern Sie Ihr Formular so, dass es standardmäßig „identifierValues“ und „identifierAttributes“ verwendet. Weitere Informationen finden Sie in der Attributtabelle in Beispiel B.

Option 2:

Überschreiben Sie die gehosteten Werte. Weitere Informationen finden Sie unter „Überschreiben der gehosteten SDK-Einstellungen“.

// To ensure external settings are loaded, use the Initialized promise:
OneTrust.Api.Initialized.then(() => {       
    // Override identifier value
    let customDefinitions = OneTrust.Api.GetPurposeDefinitions();
    customDefinitions[0].identifierValues = "purpose1-modified";
    OneTrust.Api.SetPurposeDefinitions(customDefinitions);
});

OneTrust.Api.Initialized.then(() => {
    // Override purpose value
    OneTrust.Api.SetPurposeIdentifier("<purpose GUID>", "<purpose identifier value>");
 
    // Override purpose value
    OneTrust.Api.SetTopicIdentifier("<topic GUID>", "<topic identifier value>");
});

Das SDK unterstützt auch die Möglichkeit, Datenelementwerte aus einem Formular zu senden, die in OneTrust gespeichert werden (Name, Land, Unternehmen usw.). Dazu müssen die Datenelementnamen zuerst für den Erfassungspunkt konfiguriert werden.

Nach der Konfiguration können Sie zusätzlichen JavaScript-Code hinzufügen, ähnlich dem folgenden Beispiel. Ähnlich wie bei den Zwecken oben müssen die Datenelemente „identifierAttributes“ und „identifierValues“ mit den Bezeichnern in den Formularfeldern übereinstimmen, damit das SDK beim Übermitteln die richtigen Werte abrufen kann.

Im Folgenden finden Sie ein Beispiel für das Übermitteln von Datenelementwerten im SDK:

<script type="text/javascript" charset="UTF-8">
    OneTrust.ScriptTag.DataElements = [
      {
        "identifierAttributes": "id",
        "identifierValues": "firstName",
        "dataElementName": "First Name"
      },
      {
        "identifierAttributes": "id",
        "identifierValues": "lastName",
        "dataElementName": "Last Name"
      },
      {
        "identifierAttributes": "id",
        "identifierValues": "Company",
        "dataElementName": "Company"
      }
    ];
  </script>

Wenn Sie die Sprachen für einen Erfassungspunkt definieren, enthält das SDK alle verfügbaren Textbeschriftungen für die Zwecke und Themen, für die die Übersetzungen erstellt wurden. Die beiden obigen Auszüge zeigen Beispiele für diese Bezeichnungen, die auch in der Datei der gehosteten SDK-Einstellungen enthalten sind. OneTrust bietet eine Reihe von JavaScript-Methoden für die Verwendung dieser Beschriftungen in der Benutzeroberfläche Ihres Webformulars. So können Sie sicherstellen, dass Ihre Formulare die gleiche Sprache für Zwecke und Themen verwenden, die betroffenen Personen bei der Anmeldung in den Präferenz-Centern angezeigt wird.

Im Folgenden finden Sie ein Beispiel für unterstützte JavaScript-Methoden für Sprachen:

// To ensure external settings are loaded first, use the Initialized promise:
OneTrust.Api.Initialized.then(() => {
 
    // Get all purpose labels for a language(can always be skipped to get a single/default/first label entry):
    const frenchPurposeLabels = OneTrust.Api.GetPurposeLabels("fr");
 
    // Get purpose label by language and purposeId/domIdentifier
    const frenchPurpose1Label = OneTrust.Api.GetPurposeLabel("purpose1", "fr");
 
    // Get all topic labels for a language:
    const frenchTopicLabels = OneTrust.Api.GetTopicLabels("fr");
 
    // Get topic label by language and topicId/domIdentifier
    const frenchTopic1Label = OneTrust.Api.GetTopicLabel("topic1", "fr");
 
    // Get all purpose labels for a default language(should only be used when a single language is defined)
    var allPurposeLabels  = OneTrust.Api.GetPurposeLabels();
});

Jede Beschriftung hat die folgende Struktur:

{
    id: "{GUID}",
    domId: "HTML attribute value used to find the checkbox on the page",
    language: "language code of the label",
    label: "Purpose/Topic label for a given language"
    description: "Purpose description for a given language(not defined for Topic labels)"
}

Das SDK kann die Sprache für eine betroffene Person zusammen mit der Formularübermittlung senden, was als Attribut dieser betroffenen Person gespeichert wird. OneTrust verwendet dann diesen Sprachcode, um E-Mail-Benachrichtigungen in der gespeicherten Sprache der betroffenen Person zu versenden. 

Um die Spracheinstellung einer betroffenen Person korrekt zu speichern, muss Ihr Webformular die Sprache in einem ISO-Standardsprache- oder Sprachkulturcode-Format generieren. Dazu wird die Variable OneTrust.ScriptTag.Language gesetzt.

Nachstehend finden Sie ein Beispiel für die Einstellung der Sprachpräferenz einer betroffenen Person:

<script type="text/javascript" charset="UTF-8">
    OneTrust.ScriptTag.Language = "en-GB";
</script>

Sie können nicht codierte Einstellungen direkt in Ihre Seite schreiben, um Änderungen am JavaScript einfacher vorzunehmen.

identifierAttributes und identifierValues müssen mit den Kennungen in den Formularfeldern übereinstimmen, damit das SDK die korrekten Werte übergeben kann, wenn das Formular gesendet wird.

Die Einstellungen sollten nach dem Tag <body> in der HTML für die Seite platziert werden. Im Folgenden finden Sie ein Beispiel für nicht kodierte Einstellungen.

<script type="text/javascript" charset="UTF-8">
  
OneTrust.ScriptTag.ReceiptApiEndpoint = "{endpoint URL}";  //optional - can be left in settings - but if used settings can be removed completely.
   
OneTrust.ScriptTag.DataElements = [     
{    
"identifierAttributes": "id",       
"identifierValues": "firstName",  
"dataElementName": "First Name"     
},
     
{      
"identifierAttributes": "id",     
"identifierValues": "lastName",      
"dataElementName": "Last Name"    
},
     
{       
"identifierAttributes": "id",      
"identifierValues": "inputEmail",      
"dataElementName": "Email"     
}  
];
  
OneTrust.ScriptTag.Preferences = [      
{          
"purpose": "622ab782-8ad7-4886-9dc3-8618dcf03900",          
"identifierValues": "Sample Purpose",   
"identifierAttributes": "value",         
"topics": [
                {
                    "topic": "2b55ca4e-c232-4396-9602-d6f2ea5bbd18",                   
                    "identifierValues": "A Topic",                   
                    "identifierAttributes": "value"
                },
                {
                    "topic": "e4e19d3b-7de6-4054-a3f0-fd6b8a82775a",                 
                    "identifierValues": "AA Topic",                   
                    "identifierAttributes": "value"
                }           
]       
}  
];
</script>

manualTrigger ist eine boolesche Variable, die im Teil für kodierte Einstellungen des SDK enthalten ist. Sie können die Einstellungen mit einem base64-Dekodierungstool dekodieren, ändern und die Einstellungs-Zeichenfolge neu kodieren. Der Standardwert ist „false“, wenn Sie den Wert jedoch auf „true“ setzen, kann der benutzerdefinierte Arbeitsablauf ausgeführt werden. Dies ermöglicht Szenarien, in denen Sie eine alternative Logik oder einen Arbeitsablauf verwenden möchten, um die Zahlungsgenerierungsaktion auszulösen, anstatt das Standard-Kontrollkästchen/die Sendelogik zu verwenden.

Wenn die Auslöserbedingungen erfüllt sind, rufen Sie Receipt.TriggerReceiptAction(downloadRawReceipt) aus JavaScript auf, um die Bestätigung zu erstellen. Um die reine Bestätigungssignatur herunterzuladen, setzen Sie den Parameter downloadRawReceipt auf „true“.

Nachdem Sie Ihr Skript konfiguriert haben, kann es über ein Tag-Management-Tool wie Google Tag Manager geladen werden. Es muss nur auf die Seite geladen werden, auf der sich Ihr Webformular befindet. Wenn Sie Google Tag Manager verwenden, setzen Sie den Auslöser für die Seite auf „DOM Ready“, um sicherzustellen, dass das Formular selbst vollständig vor dem Skript geladen wird.

Um mehrere Formulare auf einer einzelnen Seite zu unterstützen, können Sie sowohl den Bezeichner als auch das Token über JavaScript mit einem benutzerdefinierten Fluss übergeben. Sie können auch die Bestätigungsanfrage auslösen.

OneTrust.Api.TriggerReceiptAction("user@identifier.com", "CP token"); // pass both token and identifier, which can be used to create receipts for multiple CPs with a single script tag
OneTrust.Api.TriggerReceiptAction("user@identifier.com"); // pass custom identifier only, when shared default token from the script tag is to be used.
OneTrust.Api.TriggerReceiptAction(); // trigger receipt request with defaults working as before

var purposes = [{Id: "b0dc5e4e-ffe8-4db5-ae5f-577747e5f86a"}];
OneTrust.Api.TriggerReceiptAction("user@identifier.com", "CP token", purposes); // pass both token and identifier, which can be used to create receipts for multiple CPs with a single script tag
OneTrust.Api.TriggerReceiptAction("user@identifier.com", null, purposes); // pass custom identifier only, when shared default token from the script tag is to be used.
OneTrust.Api.TriggerReceiptAction(null, null, purposes); // trigger receipt request with defaults working as before

Da die Verwendung mehrerer Einwilligungsformulare auf einer Seite wahrscheinlich bedeutet, dass mehrere Erfassungspunkte verwendet werden, besteht der häufigste Anwendungsfall darin, sowohl den Bezeichner als auch das Token wie in der ersten Zeile oben zu übergeben. Alle anderen optionalen Parameter (Zwecke, Datenelemente, benutzerdefinierte Präferenzen) können an die Methode OneTrust.API.TriggerReceiptAction() übergeben werden.

Sie können einen Einwilligungsvorgang mit Textinhalt anstelle von JSON auslösen und das Warten auf die Bestätigungs-ID umgehen. Dazu können Sie die Funktion TriggerBeaconReceiptAction aufrufen. Diese Funktion akzeptiert Bezeichner, Token, Zwecke, dsDataElements (Datenelemente der betroffenen Person), customElements und downloadRawReceipt als optionale Parameter.

Im Folgenden finden Sie ein Beispiel für „Fire and Forget“.

<!-- OneTrust Consent Receipt Start -->
<script src="otconsent-1.0.js" type="text/javascript" charset="UTF-8" id="consent-receipt-script">
    settingsUrl="your setting url";
    identifierId="inputEmail1"
</script>
<!-- OneTrust Consent Receipt End -->
<!-- Custom Integration Start -->
<script type="text/javascript" charset="UTF-8">
    $(function () {
        var cp1Purpose = [{Id: "your purpose id"}];
        $("#sample_form1").submit(function (event) {
            event.preventDefault();
            const identifier = $("#inputEmail1").val();
            const token = "your token goes here";
            OneTrust.Api.TriggerBeaconReceiptAction(identifier, token, cp1Purpose).then((data) => {
                console.log("data", data);
                document.location.href = "/beacon-result.html";
            });
        });
    });
</script>
<!-- Custom Integration End -->