Uniepunten

Laatst bijgewerkt: 4 april 2025
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Unions (of samenvoegingsweergaven) zijn door het systeem gegenereerde, alleen-lezen schema's die de velden samenvoegen van alle schema's die dezelfde klasse delen (XDM ExperienceEvent of XDM Individual Profile ) en die zijn ingeschakeld voor Real-Time Customer Profile .

Dit document behandelt essentiële concepten voor het werken met vakbonden in de API van de Registratie van het Schema, met inbegrip van steekproefvraag voor diverse verrichtingen. Voor meer algemene informatie over unies in XDM, zie de sectie over unies in de grondbeginselen van schemacompositie.

Unieschemavelden

Schema Registry bevat automatisch drie belangrijke velden binnen een samenvoegingsschema: identityMap , timeSeriesEvents en segmentMembership .

Identiteitskaart

Het schema van de unie identityMap is een vertegenwoordiging van de bekende identiteiten binnen de bijbehorende verslagschema's van de unie. In het identiteitsoverzicht worden identiteiten gescheiden in verschillende arrays die door naamruimte worden gebruikt. Elke vermelde identiteit is zelf een object dat een unieke id -waarde bevat. Zie de documentatie van de Dienst van de Identiteitvoor meer informatie.

Gebeurtenissen uit de tijdreeks

De array timeSeriesEvents is een lijst met tijdreeksgebeurtenissen die betrekking hebben op de recordschema's die aan de union zijn gekoppeld. Wanneer profielgegevens naar datasets worden geëxporteerd, wordt deze array opgenomen voor elke record. Dit is handig voor verschillende gebruiksgevallen, zoals het leren van machines waarbij modellen naast de recordkenmerken ook de gehele gedragsgeschiedenis van een profiel nodig hebben.

Segmentlidmaatschapstoewijzing

In de segmentMembership -kaart worden de resultaten opgeslagen van de evaluatie van een segmentdefinitie. Wanneer de segmentbanen met succes gebruikend de Segmentatie APIin werking worden gesteld, wordt de kaart bijgewerkt. segmentMembership slaat ook vooraf beoordeelde soorten publiek op die in Experience Platform worden opgenomen, zodat ze kunnen worden geïntegreerd met andere oplossingen, zoals Adobe Audience Manager. Zie het leerprogramma op creërend publiek gebruikend APIsvoor meer informatie.

Een lijst met vakbonden ophalen

Wanneer u de tag union instelt op een schema, voegt Schema Registry automatisch het schema toe aan de union voor de klasse waarop het schema is gebaseerd. Als er voor de betreffende klasse geen vakbond bestaat, wordt automatisch een nieuwe vakbond gemaakt. $id voor de union is gelijkaardig aan de norm $id van andere Schema Registry middelen, met het enige verschil dat door twee onderstrepingstekens en het woord "union" (__union) wordt toegevoegd.

U kunt een lijst met beschikbare samenvoegingen weergeven door een GET-aanvraag in te dienen bij het eindpunt van /tenant/unions .

API formaat

GET /tenant/unions

Verzoek

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

De antwoordindeling is afhankelijk van de header Accept die in de aanvraag wordt verzonden. De volgende Accept kopteksten zijn beschikbaar voor samenvoegingen:

Accept header
Beschrijving
application/vnd.adobe.xed-id+json
Retourneert een korte samenvatting van elke bron. Dit is de aanbevolen koptekst voor aanbiedingsbronnen. (Limiet: 300)
application/vnd.adobe.xed+json
Retourneert de volledige JSON-klasse voor elke bron, met origineel $ref en allOf inbegrepen. (Limiet: 300)

Reactie

Een geslaagde reactie retourneert HTTP-status 200 (OK) en een results -array in de hoofdtekst van de reactie. Als vakbonden zijn gedefinieerd, worden de gegevens voor elke samenvoeging als objecten in de array gegeven. Als er geen samenvoegingen zijn gedefinieerd, wordt de HTTP-status 200 (OK) nog steeds geretourneerd, maar is de array results leeg.

{
    "results": [
        {
            "title": "XDM Individual Profile",
            "$id": "https://ns.adobe.com/xdm/context/profile__union",
            "meta:altId": "_xdm.context.profile__union",
            "version": "1"
        },
        {
            "title": "Property",
            "$id": "https://ns.adobe.com/{TENANT_ID}/classes/19e1d8b5098a7a76e2c10a81cbc99590__union",
            "meta:altId": "_{TENANT_ID}.classes.19e1d8b5098a7a76e2c10a81cbc99590__union",
            "version": "1"
        }
    ]
}