Panoramica di Models API

L'API Models, denominata anche API di Inserire nell'elenco Bloccati, consente agli utenti di visualizzare e gestire l'elenco delle funzionalità utilizzate nei modelli di apprendimento automatico per le attività Automated Personalization (AP) e Auto-Target (AT). Se un utente desidera escludere una funzione dall’utilizzo da parte dei modelli per attività di AP o AT, può utilizzare l’API Models per aggiungere tale funzione al "inserisco nell'elenco Bloccati di".

blocklist definisce l'insieme di funzionalità che Adobe Target escluderà dai propri modelli di apprendimento automatico. Per ulteriori informazioni sulle funzionalità, vedere Dati utilizzati da Target algoritmi di apprendimento automatico.

È possibile definire i Inserisce nell'elenco Bloccati per attività (livello di attività) o per tutte le attività all'interno di un account Target (livello globale).

Specifiche di Models API

Visualizza la specifica Models API qui.

Prerequisiti

Per utilizzare Models API, devi configurare l'autenticazione utilizzando Adobe Developer Console, esattamente come faresti con Target Admin API. Per ulteriori informazioni, vedere Come configurare l'autenticazione.

Linee guida per l’utilizzo delle API per modelli

Come gestire i inserisce nell'elenco Bloccati di

Passaggio 1: Visualizza l'elenco delle funzionalità per un'attività

Passaggio 2: Controllare il inserisco nell'elenco Bloccati di dell'attività

Passaggio 3: Aggiungi funzionalità al inserisco nell'elenco Bloccati di dell'attività

Passaggio 4: (facoltativo) sblocca

Passaggio 5: (Facoltativo) Gestione del inserisco nell'elenco Bloccati di globale

Passaggio 1: visualizzare l’elenco delle funzioni per un’attività step1

Prima di inserire nell'elenco Bloccati una feature, è necessario visualizzare l'elenco delle feature attualmente incluse nei modelli per tale attività.

GET https://mc.adobe.io/<tenant>/target/models/features/<campaignId>

{
    "features": [
        {
            "externalName": "Visitor Profile - Total Visits to Activity",
            "internalName": "SES_PREVIOUS_VISIT_COUNT",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Total Visits",
            "internalName": "SES_TOTAL_SESSIONS",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Pages Seen Before Activity",
            "internalName": "SES_PREVIOUS_VISIT_COUNT",
            "type": "CONTINUOUS"
        },
        {
            "externalName": "Visitor Profile - Activity Lifetime Time on Site",
            "internalName": "SES_TOTAL_TIME",
            "type": "CONTINUOUS"
        }
    ],
    "reportParameters": {
        "clientCode": <tenant>,
        "campaignId": <campaignId>
    }
}

Nell’esempio mostrato qui, l’utente sta controllando per visualizzare l’elenco delle funzioni utilizzate nel modello per l’attività di cui viene 260840 l’ID attività.

externalName è un nome descrittivo per una funzionalità. Viene creato da Target ed è possibile che questo valore cambi nel tempo. Gli utenti possono visualizzare questi nomi descrittivi nel rapporto Approfondimenti Personalization.

internalName è l'identificatore effettivo della funzionalità. Viene creato anche da Target, ma non può essere modificato. Inserire nell'elenco Bloccati Questo è il valore a cui dovrai fare riferimento per identificare le feature che desideri.

Tieni presente che, affinché l’elenco delle funzioni possa essere compilato con valori (ovvero, affinché non sia nullo), un’attività:

Passaggio 2: controllare il inserisco nell'elenco Bloccati di dell’attività step2

Quindi, visualizza il inserisco nell'elenco Bloccati di. In altre parole, verifica quali funzioni, se presenti, sono attualmente bloccate dall’inclusione nei modelli per questa attività.

GET https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>

Nell’esempio mostrato qui, l’utente sta controllando l’elenco delle funzioni bloccate per l’attività di cui viene 260840 l’ID attività. I risultati sono vuoti, il che significa che questa attività non dispone attualmente di funzioni inserite nell'elenco Bloccati per l’accesso ai dati da parte di un’organizzazione o di un’organizzazione.

Passaggio 3: aggiungere funzioni al inserisco nell'elenco Bloccati di dell’attività step3

Per aggiungere funzionalità al inserisco nell'elenco Bloccati di, modificare la richiesta da GET a PUT e modificare il corpo della richiesta in modo da specificare blockedFeatureSources o blockedFeatures come desiderato.

blockedFeatureSources indica la provenienza di una funzionalità. Ai fini della inserire nell'elenco Bloccati dei gruppi di feature, questi vengono utilizzati come gruppi o categorie di feature che consentono agli utenti di bloccare interi insiemi di feature contemporaneamente. I valori di blockedFeatureSources corrispondono ai primi caratteri dell'identificatore di una caratteristica (blockedFeatures o internalName valori), pertanto possono essere considerati anche "prefissi di funzionalità".

Tabella di blockedFeatureSources valori table

PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>

{
    "blockedFeatureSources": ["AAM"],
    "blockedFeatures": ["SES_PREVIOUS_VISIT_COUNT", "SES_TOTAL_SESSIONS"]
}

{
    "blockedFeatures": [
            "SES_PREVIOUS_VISIT_COUNT",
            "SES_TOTAL_SESSIONS"
        ],
    "blockedFeatureSources": [
            "AAM"
        ]
}

Nell'esempio seguente, l'utente sta bloccando due funzionalità, SES_PREVIOUS_VISIT_COUNT e SES_TOTAL_SESSIONS, che ha identificato in precedenza eseguendo una query sull'elenco completo delle funzionalità per l'attività il cui ID attività è 260480, come descritto in Passaggio 1. Stanno inoltre bloccando tutte le funzionalità provenienti da segmenti Experience Cloud, operazione che si ottiene bloccando le funzionalità con il prefisso "AAM", come descritto nella tabella precedente.

Dopo aver inserito nell'elenco Bloccati una funzione, si consiglia di verificare il inserisco nell'elenco Bloccati di aggiornamento della funzione di eseguendo nuovamente il passaggio 2 (GET il inserisco nell'elenco Bloccati di). Verifica che i risultati vengano visualizzati come previsto (verifica che i risultati includano le funzioni aggiunte dall’ultima richiesta PUT).

Passaggio 4: (facoltativo) sblocca step4

Inserire nell'elenco Bloccati Per sbloccare tutte le funzionalità, cancellare i valori da blockedFeatureSources o blockedFeatures.

PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/<campaignId>

{
    "blockedFeatureSources": [],
    "blockedFeatures": []
}

{
    "blockedFeatures": [],
    "blockedFeatureSources": []
}

Nell’esempio mostrato qui, l’utente sta cancellando il proprio inserisco nell'elenco Bloccati di per l’attività di cui viene 260840 l’ID attività. La risposta conferma la presenza di array vuoti sia per le funzionalità bloccate che per le relative origini, rispettivamente blockedFeatureSources e blockedFeatures.

Come sempre, dopo aver modificato il inserisco nell'elenco Bloccati di, si consiglia di eseguire di nuovo il Passaggio 2 (GET il inserisco nell'elenco Bloccati di per verificare che l'elenco includa le funzioni come previsto). Nell’esempio mostrato qui, l’utente sta verificando che il proprio inserisco nell'elenco Bloccati di sia ora vuoto.

Domanda: come posso eliminare alcuni, ma non tutti, di un inserisco nell'elenco Bloccati di?

Risposta: per rimuovere un sottoinsieme discreto di funzioni inserite nell'elenco Bloccati da un elenco Bloccati di più funzioni, gli utenti possono semplicemente inviare l'elenco aggiornato delle funzioni che desiderano bloccare in la richiesta di di elenco Bloccati di, anziché cancellare l'intero inserisco nell'elenco Bloccati di e aggiungere nuovamente le funzioni desiderate. In altre parole, inviare l'elenco delle funzionalità aggiornato (come mostrato in Passaggio 3), assicurandosi di escludere le funzionalità che si desidera "eliminare" dal inserisco nell'elenco Bloccati di eliminazione del sistema di gestione delle funzionalità di cui si è in possesso.

Passaggio 5: (facoltativo) gestisci il inserisco nell'elenco Bloccati di globale step5

Gli esempi di cui sopra si collocano tutti nel contesto di un’unica attività. Puoi anche bloccare le funzionalità per tutte le attività in un dato client (tenant), invece di dover specificare il inserisco nell'elenco Bloccati di per ogni attività singolarmente. Per eseguire un inserisco nell'elenco Bloccati di globale, utilizzare la chiamata /blockList/global anziché blockList/<campaignId>.

PUT https://mc.adobe.io/<tenant>/target/models/features/blockList/global

{
    "blockedFeatureSources": ["AAM", "PRO", "ENV"],
    "blockedFeatures": ["AAM_FEATURE_1", "AAM_FEATURE_2"]
}

{
    "blockedFeatures": [
        "AAM_FEATURE_1",
        "AAM_FEATURE_2"
    ],
    "blockedFeatureSources": [
        "AAM",
        "PRO",
        "ENV"
    ]
}

Nella richiesta di esempio mostrata sopra, l’utente sta bloccando due funzionalità, "AAM_FEATURE_1" e "AAM_FEATURE_2", per tutte le attività nel proprio account Target. Ciò significa che, indipendentemente dall’attività, "AAM_FEATURE_1" e "AAM_FEATURE_2" non saranno inclusi nei modelli di apprendimento automatico per questo account. Inoltre, l’utente blocca a livello globale anche tutte le funzioni il cui prefisso è "AAM", "PRO" o "ENV".

Domanda: l'esempio di codice qui sopra non è ridondante?

Risposta: Sì. È ridondante bloccare le funzioni con valori che iniziano con "AAM", bloccando al contempo tutte le funzioni la cui origine è "AAM". Il risultato netto è che tutte le funzioni originate dall’AAM (segmenti Experience Cloud) verranno bloccate. Pertanto, se l’obiettivo è quello di bloccare tutte le funzioni di Experience Cloud Segments, non è necessario specificare singolarmente alcune funzioni che iniziano con "AAM", nell’esempio precedente.

Passaggio finale: a livello di attività o globale, è consigliabile verificare il inserisco nell'elenco Bloccati di aggiornamento dopo averlo modificato, per assicurarsi che contenga i valori previsti. Per eseguire questa operazione, modificare PUT in GET.

La risposta di esempio mostrata di seguito indica che Target sta bloccando due singole funzionalità, più tutte quelle fornite da "AAM", "PRO" e "ENV".