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à.
code language-json line-numbers |
---|
|
code language-json line-numbers |
---|
|
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à:
- Deve avere Stato = Live, o deve essere stato attivato in precedenza
- L'esecuzione deve essere durata abbastanza a lungo per consentire l'esecuzione dell'attività della campagna, in modo che il modello disponga di dati su cui eseguire la campagna.
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à.
/blockList/
fa distinzione tra maiuscole e minuscole nella richiesta.code language-json line-numbers |
---|
|
code language-json line-numbers |
---|
|
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.
- Il corpo della richiesta richiede
blockedFeatures
oblockedFeatureSources
. Entrambi possono essere inclusi. - Popolare
blockedFeatures
con valori identificati dainternalName
. Vedi Passaggio 1. - Popolare
blockedFeatureSources
con i valori della tabella seguente.
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
code language-json line-numbers |
---|
|
code language-json line-numbers |
---|
|
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
.
code language-json line-numbers |
---|
|
code language-json line-numbers |
---|
|
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>
.
code language-json line-numbers |
---|
|
code language-json line-numbers |
---|
|
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".