Show Menu
ARGOMENTI×

Guida per gli sviluppatori DULE Policy Service API

L'etichettatura e l'applicazione dell'uso dei dati (DULE) è il meccanismo fondamentale del Adobe Experience Platform Data Governance. DULE Policy Service fornisce un'API RESTful che consente di creare e gestire i criteri di utilizzo dei dati per determinare quali azioni di marketing possono essere eseguite rispetto ai dati etichettati con determinate etichette di utilizzo dei dati.
Questo documento fornisce istruzioni per l'esecuzione delle operazioni chiave disponibili nell' Policy Service API. Se non l'avete ancora fatto, potete iniziare rivedendo la panoramica sulla governance dei dati per acquisire dimestichezza con il framework DULE. Per istruzioni dettagliate sulla creazione e l'applicazione di criteri DULE, vedete l'esercitazione sulla politica DULE.
Questo documento fornisce un'introduzione ai concetti di base da conoscere prima di tentare di effettuare chiamate all' Policy Service API.

Guida introduttiva a DULE Policy Service

Prima di iniziare a lavorare con Policy Service, i dati su Experience Platform devono avere appropriate etichette DULE. Istruzioni dettagliate per l'applicazione delle etichette di utilizzo dei dati ai set di dati e ai campi sono disponibili nella guida utente delle etichette DULE.

Prerequisiti

Questa guida richiede una buona conoscenza dei seguenti componenti del Adobe Experience Platform:
  • Data Governance : Il framework in base al quale Experience Platform viene applicata la conformità all'utilizzo dei dati.
    • Etichette DULE: Le etichette di utilizzo dei dati vengono applicate ai campi di dati Experience Data Model (XDM), specificando le restrizioni relative alle modalità di accesso ai dati.
  • Experience Data Model (XDM) System : Il framework standard con cui Experience Platform organizzare i dati relativi all'esperienza del cliente.
  • Real-time Customer Profile : Fornisce un profilo di consumo unificato e in tempo reale basato su dati aggregati provenienti da più origini.
  • Sandboxes : Experience Platform fornisce sandbox virtuali che dividono una singola Platform istanza in ambienti virtuali separati per sviluppare e sviluppare applicazioni per esperienze digitali.

Lettura di chiamate API di esempio

Questa guida fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, vedete la sezione come leggere chiamate API di esempio nella guida alla Experience Platform risoluzione dei problemi.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è prima necessario completare l'esercitazione sull' autenticazione. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate Experience Platform API, come illustrato di seguito:
  • Autorizzazione: Portatore {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
Tutte le risorse in Experience Platform, comprese quelle appartenenti a Data Governance, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle Platform API richiedono un'intestazione che specifica il nome della sandbox in cui avrà luogo l'operazione:
  • x-sandbox-name: {SANDBOX_NAME}
Per ulteriori informazioni sulle sandbox in Platform, consultate la documentazione sulla panoramica della sandbox.
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un'intestazione aggiuntiva:
  • Content-Type: application/json

Risorse Core e personalizzate

All'interno dell' Policy Service API, tutti i criteri e le azioni di marketing sono denominati o core custom risorse.
Le core risorse sono quelle definite e gestite dal Adobe , mentre custom le risorse sono create e conservate dai singoli clienti e sono pertanto uniche e visibili esclusivamente all'organizzazione IMS che le ha create. Di conseguenza, le operazioni di elenco e ricerca ( GET ) sono le uniche operazioni consentite sulle core risorse, mentre le operazioni di elenco, ricerca e aggiornamento ( POST , PUT , PATCH e DELETE ) sono disponibili per custom le risorse.

Stato dei criteri

I criteri di utilizzo dei dati possono avere uno dei tre stati possibili: DRAFT , ENABLED o DISABLED .
Per impostazione predefinita, solo le politiche "ENABLED" partecipano alla valutazione delle politiche.
I criteri "DRAFT" possono essere considerati anche nella valutazione dei criteri, ma solo impostando il parametro della query ?includeDraft=true . Ulteriori informazioni sulla valutazione delle politiche sono reperibili nel documento relativo all'applicazione delle politiche alla fine del presente documento.

Nomi delle azioni di marketing

I nomi delle azioni di marketing sono identificatori univoci per le azioni di marketing. Ogni azione core di marketing ha un nome univoco che si applica a tutte le organizzazioni IMS. Questi nomi sono definiti e mantenuti dal Adobe . Nel frattempo, tutte le azioni di marketing ( custom risorse) definite dal cliente sono univoche all'interno della vostra organizzazione e non sono visibili o condivise con altre organizzazioni IMS.
I passaggi per lavorare con le azioni di marketing nell' Policy Service API sono descritti nella sezione Azioni di marketing più avanti in questo documento.

Passaggi successivi

Ora che disponete delle conoscenze e delle credenziali preliminari, potete continuare a leggere le chiamate API di esempio fornite in questa guida per gli sviluppatori: