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 av 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 guiden Identitetsnamnrymd om du vill skapa ett identitetsnamnutrymme. När du skapar ditt identitetsnamnutrymme lägger du till källinformationen i identitetsnamnutrymmet och markerar dess Type som en 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.

Om du vill börja komponera ett schema väljer du först Schemas i det vänstra navigeringsfältet, följt av Create schema i det övre högra hörnet på 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. Välj nu klassen Segment definition 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 fältet _id som primär identitet markerar du schemats titel, följt av växlingstecknet Profile. Välj Enable om du vill 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ändarhandboken för datauppsättningen. Du bör följa alternativet 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ändarhandboken för datauppsättningen för att aktivera den här datauppsättningen för kundprofilen 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 gruppanslutning kan du följa instruktionerna i den allmänna användargränssnittshandboken för lokal filöverföring. En fullständig lista över tillgängliga källor som du kan använda import av data med finns i källöversikten.

Importera data via en direktuppspelningsanslutning

Om du vill skapa en direktuppspelningsanslutning kan du följa instruktionerna i API-självstudiekursen eller gränssnittsjälvstudiekursen.

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. Om du vill lära dig hur du skickar data till de här slutpunkterna kan du läsa självstudiekursen om direktuppspelning av postdata.

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 fliken Audiences i avsnittet Fields.

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. Om du vill veta mer om hur du skapar segment kan du läsa självstudiekursen 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

Om du vill börja komponera ett schema väljer du först Schemas i det vänstra navigeringsfältet, följt av Create schema i det övre högra hörnet på arbetsytan Scheman. Välj XDM Individual Profile härifrån.

Nu när schemat har skapats måste du lägga till fältgruppen för segmentmedlemskap som en del av schemat. Om du vill göra det väljer du 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ändarhandboken för datauppsättningen. Du bör följa alternativet 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ändarhandboken för datauppsättningen för att aktivera den här datauppsättningen för kundprofilen 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 gruppanslutning kan du följa instruktionerna i den allmänna användargränssnittshandboken för lokal filöverföring. En fullständig lista över tillgängliga källor som du kan använda import av data med finns i källöversikten.

Importera data via en direktuppspelningsanslutning

Om du vill skapa en direktuppspelningsanslutning kan du följa instruktionerna i API-självstudiekursen eller gränssnittsjälvstudiekursen.

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. Om du vill lära dig hur du skickar data till de här slutpunkterna kan du läsa självstudiekursen om direktuppspelning av postdata.

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