Adobe Experience Platform har stöd för import av externa målgrupper, som sedan kan användas som komponenter för en ny segmentdefinition. 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ålgruppssegment. 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 segmentdata och segmentmetadata.
Segmentdata avser de profiler som uppfyller kriterierna för att kvalificera segment, och är därför en del av målgruppen.
Metadata för segment är information om själva segmentet, som innehåller namn, beskrivning, uttryck (om tillämpligt), datum då segmentet skapades, datum för senaste ändring och ett ID. ID:t länkar segmentmetadata till de enskilda profiler som uppfyller segmentkvalificeringen och är en del av den slutliga målgruppen.
Segmentdata | Segmentmetadata |
---|---|
Profiler som uppfyller kraven för segment | Information om själva segmentet |
Det första steget för att använda externa målgrupper är att skapa ett identitetsnamnutrymme. Med identitetsnamnutrymmen kan plattformen associera varifrån ett segment kommer.
Följ instruktionerna i 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.
Om du vill börja använda anpassade namnutrymmen med externa målgrupper måste du skapa en supportanmälan. Kontakta din Adobe-representant om du vill ha mer information.
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 i det vänstra navigeringsfältet, följt av Create schema i det övre högra hörnet av arbetsytan Scheman. Här väljer du 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. Nu väljer du 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 generiska 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 att direktuppspela postdata.
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 extern 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 i det vänstra navigeringsfältet, följt av Create schema i det övre högra hörnet av arbetsytan Scheman. Här väljer du 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. Välj 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 generiska 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 att direktuppspela postdata.
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} |
Detta ä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. |