Importera och använda externa målgrupper

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.

Komma igång

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:

Målgrupper jämfört med segmentdefinitioner

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.

Skapa ett identitetsnamnutrymme för den externa målgruppen

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.

Skapa ett schema för segmentmetadata

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.

Skapa en datauppsättning för schemat

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.

Konfigurera och importera målgruppsdata

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.

Infoga data med en batchanslutning

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.

Importera data via en direktuppspelningsanslutning

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.

Struktur för målgruppsmetadata

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"
        }
    }
}

Skapa segment med importerade målgrupper

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.

Nästa steg

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.

Bilaga

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.

Ställ in ett externt målschema för segmentmedlemskap

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.

Konfigurera datauppsättningen

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.

Ställ in och importera externa data för målgruppsmedlemskap

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.

Infoga data med en batchanslutning

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.

Importera data via en direktuppspelningsanslutning

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.

Segmentmedlemsstruktur

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"
                    }
                }
            }
        }
    }
}