Website tracker SDK | profile.subprofile()

De functie profile.subprofile() maakt een nieuw subprofiel aan of haalt een bestaand subprofiel op dat gekoppeld is aan het profiel van de huidige bezoeker. Deze functie retourneert altijd een JavaScript Promise met een subprofiel-object. Dit object bevat zowel informatie over het subprofiel als handige functies. Meer details over het subprofiel-object vind je in dit artikel over het subprofiel Object.

Je kunt de functie aanroepen via zowel copernica.profile() als copernica.profile. In de onderstaande voorbeelden wordt copernica.profile gebruikt. Het verschil tussen deze aanroepmethoden wordt uitgelegd in het artikel over het profiel.

Subprofiel aanmaken

Om een nieuw subprofiel aan te maken onder het huidige profiel van de bezoeker, geef je de naam van de collectie op, samen met een JavaScript-object dat de velden van het subprofiel beschrijft.

// maak een subprofiel aan in de collectie 'mijn-collectie', met de velden `veld1` en `veld2`
copernica.profile.subprofile('mijn-collectie', { veld1: 'waarde', veld2: 'waarde' }).then(subprofile => {

    // hier hebben we toegang tot het nieuwe subprofiel
    console.log('subprofiel aangemaakt');
}, error => {

    // indien we het subprofiel niet kunnen aanmaken, krijgen we een error
    // we kunnen de error inzien door deze te loggen
    console.log(error);
});

Subprofiel ophalen

De profile.subprofile()-functie ondersteunt drie manieren om een subprofiel op te halen:

Subprofiel ophalen op basis van ID

Bij de eerste methode geef je alleen het ID van het subprofiel mee. Het is niet van belang in welke collectie of miniselectie het subprofiel zich bevindt.

// haal het subprofiel op met het id 12345
copernica.profile.subprofile(12345).then(subprofile => {

    // we hebben nu toegang tot het subprofiel
    console.log('subprofiel opgehaald');
}, error => {

    // indien we het subprofiel niet kunnen ophalen, krijgen we een error
    // we kunnen de error inzien door deze te loggen
    console.log(error);
});

Subprofiel ophalen uit een specifieke collectie

Bij de tweede methode geef je ook de naam van de collectie mee. Dit garandeert dat het opgehaalde subprofiel zich in de opgegeven collectie bevindt.

// haal het subprofiel op met het id 12345 uit de collectie 'mijn collectie'
copernica.profile.subprofile('mijn-collectie', 12345).then(subprofile => {

    // we hebben nu toegang tot het subprofiel
    console.log('subprofiel opgehaald');
}, error => {

    // indien we het subprofiel niet kunnen ophalen, krijgen we een error
    // we kunnen de error inzien door deze te loggen
    console.log(error);
});

Subprofiel ophalen uit een specifieke mini-selectie

Bij de derde methode specificeer je zowel de collectie als de mini-selectie waarin het subprofiel zich moet bevinden. De collectie en mini-selectie worden gescheiden door een punt (.).

// haal het subprofiel op met het id 12345 uit de mini-selectie 'mijn-miniselectie'
// in de collectie 'mijn-collectie'
copernica.profile.subprofile('mijn-collectie.mijn-miniselectie', 12345).then(subprofile => {

    // we hebben nu toegang tot het subprofiel
    console.log('subprofiel opgehaald');
}, error => {

    // indien we het subprofiel niet kunnen ophalen, krijgen we een error
    // we kunnen de error inzien door deze te loggen
    console.log(error);
});