Dokumentationen innehåller information från en tidigare version av publikens dokumentation och är därför inaktuell.
Adobe Experience Platform stöder import av externa användare, som sedan kan användas som komponenter för en ny publik. Det här dokumentet innehåller en självstudiekurs om hur du konfigurerar Experience Platform för att importera och använda externa målgrupper.
Den här självstudiekursen kräver en fungerande förståelse för de olika Adobe Experience Platform tjänster som används för att skapa målgrupper. Innan du börjar med den här självstudiekursen bör du läsa dokumentationen för följande tjänster:
Innan du börjar importera och använda externa målgrupper är det viktigt att förstå skillnaden mellan målgrupper och segmentdefinitioner.
Publiken refererar till den grupp profiler som du försöker filtrera mot. När du använder segmentdefinitioner kan du skapa en målgrupp genom att skapa en segmentdefinition som filtrerar dina profiler till den delmängd som uppfyller kriterierna för segmentkvalificering.
Segmentdefinitioner innehåller information som namn, beskrivning, uttryck (om tillämpligt), skapandedatum, senaste ändringsdatum och ett ID. ID:t länkar segmentmetadata till de enskilda profiler som uppfyller segmentkvalificeringen och är en del av den slutliga målgruppen.
Målgrupper | Segmentdefinition |
---|---|
Den grupp med profiler som du försöker hitta. När du använder segmentdefinitioner innebär det att det är den grupp av profiler som uppfyller villkoren för segment. | Den grupp regler som används för att segmentera målgruppen du söker. |
Det första steget för att använda externa målgrupper är att skapa ett identitetsnamnutrymme. Med identitetsnamnutrymmen kan plattformen associera var en målgrupp kommer ifrån.
Följ instruktionerna i dialogrutan för att skapa ett identitetsnamnutrymme guide för identitetsnamnutrymme. När du skapar ditt identitetsnamnutrymme lägger du till källinformationen i identitetsnamnutrymmet och markerar dess Type som Non-people identifier.
När du har skapat ett identitetsnamnutrymme måste du skapa ett nytt schema för det segment som du ska skapa.
Börja med att välja Schemas till vänster navigeringsfält, följt av Create schema i det övre högra hörnet av arbetsytan Scheman. Välj Browse om du vill se ett fullständigt urval av tillgängliga schematyper.
Eftersom du skapar en segmentdefinition, som är en fördefinierad klass, väljer du Use existing class. Välj Segment definition klass, följt av Assign class.
Nu när schemat har skapats måste du ange vilket fält som ska innehålla segment-ID:t. Det här fältet bör markeras som primär identitet och tilldelas de namnutrymmen som du skapade tidigare.
När du har markerat _id
som primär identitet väljer du schemats titel, följt av växlingens etikett Profile. Välj Enable för att aktivera schemat för Real-Time Customer Profile.
Det här schemat är nu aktiverat för profilen, med den primära identifieringen tilldelad till det icke-personliga ID-namnområdet som du skapade. Detta innebär att segmentmetadata som importeras till plattformen med det här schemat kommer att importeras till profilen utan att sammanfogas med andra personrelaterade profildata.
När du har konfigurerat schemat måste du skapa en datauppsättning för segmentets metadata.
Om du vill skapa en datauppsättning följer du instruktionerna i användarhandbok för datauppsättning. Du bör följa Create dataset from schema med det schema som du skapade tidigare.
När du har skapat datauppsättningen fortsätter du att följa instruktionerna i användarhandbok för datauppsättning för att aktivera den här datauppsättningen för kundprofil i realtid.
När datauppsättningen är aktiverad kan data nu skickas till plattformen antingen via användargränssnittet eller med Experience Platform API:er. Du kan importera dessa data antingen via en batch- eller direktuppspelningsanslutning.
Om du vill skapa en batchanslutning kan du följa instruktionerna i det allmänna användargränssnittshandbok för lokal filöverföring. En fullständig lista över tillgängliga källor som du kan använda importdata med finns i källöversikt.
Om du vill skapa en direktuppspelningsanslutning följer du instruktionerna i API, genomgång eller Självstudiekurs om användargränssnitt.
När du har skapat en direktuppspelningsanslutning får du tillgång till din unika slutpunkt för direktuppspelning som du kan skicka data till. Läs mer om hur du skickar data till dessa slutpunkter i självstudiekurs om dataströmmar.
När du har skapat en anslutning kan du nu importera dina data till plattformen.
Ett exempel på den externa målgruppens nyttolastmetadata visas nedan:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
Egenskap | Beskrivning |
---|---|
schemaRef |
Schemat måste hänvisar till det tidigare skapade schemat för segmentmetadata. |
datasetId |
Datauppsättnings-ID måste referera till den tidigare skapade datauppsättningen för det schema du just skapade. |
xdmEntity._id |
ID:t måste referera till samma segment-ID som du använder som din externa målgrupp. |
xdmEntity.identityMap |
Detta avsnitt måste innehåller den identitetsetikett som användes när det namnutrymme som skapades tidigare skapades. |
{IDENTITY_NAMESPACE} |
Detta är etiketten för det identitetsnamnutrymme som skapades tidigare. Om du till exempel anropar ditt identitetsnamnutrymme "externalAudience", använder du det som nyckel för arrayen. |
segmentName |
Namnet på det segment som du vill att den externa målgruppen ska segmenteras av. |
När de importerade målgrupperna har konfigurerats kan de användas som en del av segmenteringsprocessen. Om du vill hitta externa målgrupper går du till segmentbyggaren och väljer Audiences i Fields -avsnitt.
Nu när ni kan använda externa målgrupper i era segment kan ni använda segmentverktyget för att skapa segment. Läs mer om hur du skapar segment i självstudiekurs om hur du skapar segment.
Förutom att använda importerade externa målgruppsmetadata och använda dem för att skapa segment, kan du även importera externa segmentmedlemskap till plattformen.
Börja med att välja Schemas till vänster navigeringsfält, följt av Create schema i det övre högra hörnet av arbetsytan Scheman. Välj XDM Individual Profile.
Nu när schemat har skapats måste du lägga till fältgruppen för segmentmedlemskap som en del av schemat. Gör detta genom att välja Segment Membership Details, följt av Add field groups.
Kontrollera dessutom att schemat är markerat för Profile. För att kunna göra detta måste du markera ett fält som primär identitet.
När du har skapat schemat måste du skapa en datauppsättning.
Om du vill skapa en datauppsättning följer du instruktionerna i användarhandbok för datauppsättning. Du bör följa Create dataset from schema med det schema som du skapade tidigare.
När du har skapat datauppsättningen fortsätter du att följa instruktionerna i användarhandbok för datauppsättning för att aktivera den här datauppsättningen för kundprofil i realtid.
När datauppsättningen är aktiverad kan data nu skickas till plattformen antingen via användargränssnittet eller med Experience Platform API:er. Du kan importera dessa data antingen via en batch- eller direktuppspelningsanslutning.
Om du vill skapa en batchanslutning kan du följa instruktionerna i det allmänna användargränssnittshandbok för lokal filöverföring. En fullständig lista över tillgängliga källor som du kan använda importdata med finns i källöversikt.
Om du vill skapa en direktuppspelningsanslutning följer du instruktionerna i API, genomgång eller Självstudiekurs om användargränssnitt.
När du har skapat en direktuppspelningsanslutning får du tillgång till din unika slutpunkt för direktuppspelning som du kan skicka data till. Läs mer om hur du skickar data till dessa slutpunkter i självstudiekurs om dataströmmar.
När du har skapat en anslutning kan du nu importera dina data till plattformen.
Ett exempel på nyttolasten för det externa målgruppsmedlemskapet visas nedan:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
Egenskap | Beskrivning |
---|---|
schemaRef |
Schemat måste hänvisar till det tidigare skapade schemat för segmentmedlemskapsdata. |
datasetId |
Datauppsättnings-ID måste hänvisa till den tidigare skapade datauppsättningen för det medlemsschema som du just skapade. |
xdmEntity._id |
Ett lämpligt ID som används för att unikt identifiera posten i datauppsättningen. |
{TENANT_NAME}.identities |
Det här avsnittet används för att koppla fältgruppen för anpassade identiteter till de användare som du tidigare importerat. |
segmentMembership.{IDENTITY_NAMESPACE} |
Det här är etiketten för det anpassade identitetsnamnutrymmet som skapades tidigare. Om du till exempel anropar ditt identitetsnamnutrymme "externalAudience", använder du det som nyckel för arrayen. |
Som standard tas externa medlemskap bort efter 30 dagar. För att förhindra att de tas bort och sparas i mer än 30 dagar använder du validUntil
när ni hämtar in målgruppsdata. Mer information finns i guiden Schemafältgrupper för detaljer om segmentmedlemskap.