Slutpunkt för sammanslagningsprinciper

Med Adobe Experience Platform kan ni sammanföra datafragment från flera olika källor och kombinera dem för att få en fullständig bild av varje enskild kund. Sammanslagningsprinciper är reglerna som Platform använder för att avgöra hur data ska prioriteras och vilka data som ska kombineras för att skapa en enhetlig vy.

Om en kund till exempel interagerar med ert varumärke i flera kanaler kommer organisationen att ha flera profilfragment som är kopplade till den enskilda kunden som visas i flera datauppsättningar. När de här fragmenten hämtas till Platform sammanfogas de för att skapa en enda profil för kunden. När data från flera källor står i konflikt (t.ex. ett fragment listar kunden som"enkel" medan det andra listar kunden som"gift") avgör sammanfogningspolicyn vilken information som ska inkluderas i profilen för den enskilda personen.

Med RESTful API:er eller användargränssnittet kan du skapa nya kopplingsprofiler, hantera befintliga profiler och ange en standardkopplingsprofil för organisationen. Den här handboken innehåller steg för hur du arbetar med sammanfogningsprinciper med API:t.

Om du vill arbeta med sammanfogningsprinciper med hjälp av användargränssnittet, se gränssnittshandbok för sammanslagningsprinciper. Om du vill veta mer om policyer för sammanslagning i allmänhet och deras roll i Experience Platform börjar du med att läsa sammanfogningsprinciper - översikt.

Komma igång

API-slutpunkten som används i den här guiden är en del av Real-time Customer Profile API. Läs igenom komma igång-guide för länkar till relaterad dokumentation, en guide till hur du läser exempel-API-anrop i det här dokumentet och viktig information om vilka huvuden som behövs för att kunna ringa anrop till Experience Platform API.

Komponenter i sammanfogningsprinciper

Sammanslagningsprinciper är privata för IMS-organisationen, vilket gör att du kan skapa olika profiler för att sammanfoga scheman på de specifika sätt som du behöver. Alla API-åtkomstmöjligheter Profile data kräver en sammanfogningsprincip, men ett standardvärde kommer att användas om det inte uttryckligen anges. Platform innehåller en standardprincip för sammanfogning, eller så kan du skapa en sammanfogningsprincip för en specifik XDM-schemaklass (Experience Data Model) och markera den som standard för din organisation.

Även om varje organisation kan ha flera sammanfogningsprinciper per per schemaklass, kan varje klass bara ha en standardsammanfogningsprincip. Alla sammanfogningsprinciper som anges som standard används om namnet på schemaklassen anges och en sammanfogningsprincip krävs men inte anges.

OBSERVERA

När du anger en ny sammanfogningsprincip som standard uppdateras automatiskt alla befintliga sammanfogningsprinciper som tidigare var inställda som standard så att de inte längre används som standard.

För att säkerställa att alla profilkonsumenter arbetar med samma vy på kanterna kan sammanfogningsprinciper markeras som aktiva på kanten. För att ett segment ska kunna aktiveras på kanten (markeras som ett kantsegment) måste det vara kopplat till en sammanfogningspolicy som är markerad som aktiv på kanten. Om ett segment not som är knutna till en sammanfogningsprincip som är markerad som aktiv på kanten markeras segmentet inte som aktivt på kanten och markeras som ett direktuppspelningssegment.

Dessutom kan varje IMS-organisation bara ha en sammanfogningsprincip som är aktiv vid sidan. Om en sammanfogningsprincip är aktiv på kant kan den användas för andra system på kanten, t.ex. Edge Profile, Edge Segmentation och Destinations on Edge.

Slutför policyobjekt för sammanfogning

Det fullständiga principobjektet för sammanfogning representerar en uppsättning inställningar som styr aspekter av sammanfogning av profilfragment.

Kopplingsprincipobjekt

    {
        "id": "{MERGE_POLICY_ID}",
        "name": "{NAME}",
        "imsOrgId": "{ORG_ID}",
        "schema": {
            "name": "{SCHEMA_CLASS_NAME}"
        },
        "version": 1,
        "identityGraph": {
            "type": "{IDENTITY_GRAPH_TYPE}"
        },
        "attributeMerge": {
            "type": "{ATTRIBUTE_MERGE_TYPE}"
        },
        "isActiveOnEdge": "{BOOLEAN}",
        "default": "{BOOLEAN}",
        "updateEpoch": "{UPDATE_TIME}"
    }
Egenskap Beskrivning
id Den systemgenererade unika identifieraren som tilldelats vid skapandetillfället
name Eget namn som sammanfogningsprincipen kan identifieras med i listvyer.
imsOrgId Organisations-ID som den här sammanfogningsprincipen tillhör
schema.name Del av schema -objekt, name -fältet innehåller den XDM-schemaklass som sammanfogningsprincipen relaterar till. Mer information om scheman och klasser finns i XDM-dokumentation.
version Platform en sparad version av sammanfogningsprincipen. Det här skrivskyddade värdet ökas stegvis när en sammanfogningsprincip uppdateras.
identityGraph Identitetsdiagram objekt som anger det identitetsdiagram från vilket relaterade identiteter hämtas. Profilfragment som hittas för alla relaterade identiteter sammanfogas.
attributeMerge Koppla attribut objekt som anger hur sammanfogningsprincipen prioriterar profilattribut vid datakonflikter.
isActiveOnEdge Booleskt värde som anger om sammanfogningsprincipen kan användas på kanten. Som standard är det här värdet false.
default Booleskt värde som anger om den här sammanfogningsprincipen är standard för det angivna schemat.
updateEpoch Datum för den senaste uppdateringen av sammanfogningsprincipen.

Exempel på sammanfogningsprincip

    {
        "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
        "name": "profile-default",
        "imsOrgId": "{ORG_ID}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "timestampOrdered"
        },
        "isActiveOnEdge": false,
        "default": true,
        "updateEpoch": 1551660639
    }

Identitetsdiagram

Adobe Experience Platform Identity Service hanterar de identitetsdiagram som används globalt och för varje organisation på Experience Platform. The identityGraph attribut för sammanfogningsprincipen definierar hur relaterade identiteter för en användare ska fastställas.

identityGraph-objekt

    "identityGraph": {
        "type": "{IDENTITY_GRAPH_TYPE}"
    }

Plats {IDENTITY_GRAPH_TYPE} är något av följande:

  • "none": Utför ingen identitetssammanfogning.
  • "pdg": Utför identitetssammanfogning baserat på ditt privata identitetsdiagram.

ExempelidentityGraph

    "identityGraph": {
        "type": "pdg"
    }

Koppla attribut

Ett profilfragment är profilinformationen för endast en identitet från listan över identiteter som finns för en viss användare. När typen av identitetsdiagram som används resulterar i mer än en identitet, finns det en risk för att profilattribut som står i konflikt med varandra, och prioritet måste anges. Använda attributeMergekan du ange vilka profilattribut som ska prioriteras i händelse av en sammanslagningskonflikt mellan datamängder av typen nyckelvärde (postdata).

attributeMerge, objekt

    "attributeMerge": {
        "type": "{ATTRIBUTE_MERGE_TYPE}"
    }

Plats {ATTRIBUTE_MERGE_TYPE} är något av följande:

  • timestampOrdered: (standard) Prioritera profilen som uppdaterades senast. Med den här sammanfogningstypen kan du data inget attribut krävs.
  • dataSetPrecedence: Prioritera profilfragment baserat på den datauppsättning som de kommer från. Detta kan användas när information som finns i en datauppsättning är att föredra eller betrodd framför data i en annan datauppsättning. När du använder den här sammanfogningstypen order -attribut krävs eftersom datauppsättningarna anges i prioritetsordning.
    • order: När "dataSetPriedence" används, order matrisen måste ha en lista med datauppsättningar. Datauppsättningar som inte ingår i listan kommer inte att sammanfogas. Datamängder måste med andra ord anges explicit för att sammanfogas till en profil. The order arrayen listar ID:n för datauppsättningarna i prioritetsordning.

Exempel attributeMerge objekt använda dataSetPrecedence type

    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "dataSetId_2",
            "dataSetId_3",
            "dataSetId_1",
            "dataSetId_4"
        ]
    }

Exempel attributeMerge objekt använda timestampOrdered type

    "attributeMerge": {
        "type": "timestampOrdered"
    }

Schema

Schemaobjektet anger XDM-schemaklassen (Experience Data Model) som sammanfogningsprincipen skapas för.

schemaobject

    "schema": {
        "name": "{SCHEMA_NAME}"
    }

Där värdet för name är namnet på XDM-klassen som schemat som är kopplat till sammanfogningsprincipen baseras på.

Exempelschema

    "schema": {
        "name": "_xdm.context.profile"
    }

Om du vill veta mer om XDM och arbeta med scheman i Experience Platform börjar du med att läsa XDM - systemöversikt.

Åtkomst till sammanfogningsprinciper

Använda Real-time Customer Profile API, /config/mergePolicies Med slutpunkten kan du utföra en uppslagsbegäran för att visa en specifik sammanfogningsprincip utifrån dess ID, eller få tillgång till alla sammanfogningsprinciper i din IMS-organisation, filtrerade efter specifika villkor. Du kan också använda /config/mergePolicies/bulk-get slutpunkt för att hämta flera sammanfogningsprinciper efter deras ID. Steg för att utföra dessa anrop beskrivs i följande avsnitt.

Åtkomst till en sammanfogningsprincip via ID

Du kan få åtkomst till en enskild sammanfogningsprincip via dess ID genom att göra en GET-förfrågan till /config/mergePolicies slutpunkt och inklusive mergePolicyId i sökvägen till begäran.

API-format

GET /config/mergePolicies/{mergePolicyId}
Parameter Beskrivning
{mergePolicyId} Identifieraren för den sammanfogningsprincip som du vill ta bort.

Begäran

curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/10648288-cda5-11e8-a8d5-f2801f1b9fd1' \
  -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}

Svar

Ett lyckat svar returnerar information om sammanfogningsprincipen.

{
    "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
    "imsOrgId": "{ORG_ID}",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "pdg"
    },
    "attributeMerge": {
        "type": "timestampOrdered"
    },
    "isActiveOnEdge": "false",
    "default": false,
    "updateEpoch": 1551127597
}

Se komponenter i sammanfogningsprinciper i början av det här dokumentet om du vill ha information om vart och ett av de enskilda elementen som utgör en sammanfogningspolicy.

Hämta flera sammanfogningsprinciper efter deras ID:n

Du kan hämta flera sammanfogningsprinciper genom att göra en POST-förfrågan till /config/mergePolicies/bulk-get slutpunkten och inklusive ID:n för de sammanfogningsprinciper som du vill hämta i begärandetexten.

API-format

POST /config/mergePolicies/bulk-get

Begäran

Begärandetexten innehåller en "ids"-array med enskilda objekt som innehåller "id" för varje sammanfogningsprincip som du vill hämta information för.

curl -X POST \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/bulk-get' \
  -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 'Content-Type: application/json' \
  -d '{
        "ids": [
          {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b"
          },
          {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130"
          }
        ]
      }'

Svar

Ett lyckat svar returnerar HTTP-status 2007 (Multi-Status) och information om de sammanfogningsprinciper vars ID:n angavs i begäran om POST.

{
    "results": {
        "0bf16e61-90e9-4204-b8fa-ad250360957b": {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "isActiveOnEdge": true,
            "default": true,
            "updateEpoch": 1552086578
        },
        "42d4a596-b1c6-46c0-994e-ca5ef1f85130": {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "isActiveOnEdge": false,
            "default": false,
            "updateEpoch": 1576099719
        }
    }
}

Se komponenter i sammanfogningsprinciper i början av det här dokumentet om du vill ha information om vart och ett av de enskilda elementen som utgör en sammanfogningspolicy.

Lista flera sammanfogningsprinciper efter villkor

Du kan visa flera sammanfogningsprinciper inom IMS-organisationen genom att skicka en GET-förfrågan till /config/mergePolicies slutpunkt och valfria frågeparametrar för att filtrera, ordna och numrera svaret. Flera parametrar kan inkluderas, avgränsade med et-tecken (&). Om du anropar den här slutpunkten utan parametrar hämtas alla kopplingsprofiler som är tillgängliga för organisationen.

API-format

GET /config/mergePolicies?{QUERY_PARAMS}
Parameter Beskrivning
default Ett booleskt värde som filtrerar resultat genom att sammanfogningsprinciperna är standard för en schemaklass eller inte.
limit Anger sidstorleksgränsen för att styra antalet resultat som ska inkluderas på en sida. Standardvärde: 20
orderBy Anger fältet som resultaten ska sorteras efter orderBy=name eller orderBy=+name för att sortera efter namn i stigande ordning, eller orderBy=-name, för att sortera i fallande ordning. Om du utelämnar det här värdet blir standardsorteringen av name i stigande ordning.
isActiveOnEdge Ett booleskt värde som filtrerar resulterar i om sammanfogningsprinciperna är aktiva på kanten eller inte.
schema.name Namnet på schemat som tillgängliga sammanfogningsprinciper ska hämtas för.
identityGraph.type Filtrerar resultat efter typen av identitetsdiagram. Möjliga värden är none och pdg (Private graph).
attributeMerge.type Filtrerar resultat efter den attributsammanfogningstyp som används. Möjliga värden är "timestampOrdered" och "dataSetPriedence".
start Sidförskjutning - ange det första ID:t för data som ska hämtas. Standardvärde: 0
version Ange det här alternativet om du vill använda en specifik version av sammanfogningsprincipen. Som standard används den senaste versionen.

Mer information om schema.name, identityGraph.typeoch attributeMerge.type, se komponenter i sammanfogningsprinciper tidigare i denna handbok.

Begäran

I följande begäran visas alla sammanfogningsprinciper för ett givet schema:

curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies?schema.name=_xdm.context.profile' \
  -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}

Svar

Ett lyckat svar returnerar en numrerad lista med sammanfogningsprinciper som uppfyller villkoren som anges av frågeparametrarna som skickas i begäran.

{
    "_page": {
        "totalCount": 2,
        "pageSize": 2
    },
    "children": [
        {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "isActiveOnEdge": true,
            "default": true,
            "updateEpoch": 1552086578
        },
        {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "isActiveOnEdge": false,
            "default": false,
            "updateEpoch": 1576099719
        }
    ],
    "_links": {
        "next": {
            "href": "@/mergePolicies?start=K1JJRDpFaWc5QUpZWHY1c2JBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQldBQkVBQVBnaFFQLzM4VUIvL2tKQi8rLysvMUpBLzMrMi8wRkFmLzR4UUwvL0VrRC85em4zRTBEcmNmYi92Kzh4UUwvL05rQVgzRi8rMStqNS80WHQwN2NhUUVzQUFBUUFleGpLQ1JnVXRVcEFCQUFFQVBBRA==&orderBy=&limit=2"
        }
    }
}
Egenskap Beskrivning
_links.next.href En URI-adress för nästa resultatsida. Använd denna URI som begärandeparameter för ett annat API-anrop till samma slutpunkt för att visa sidan. Om det inte finns någon nästa sida blir värdet en tom sträng.

Skapa en kopplingsprofil

Du kan skapa en ny sammanfogningsprincip för din organisation genom att göra en POST-förfrågan till /config/mergePolicies slutpunkt.

API-format

POST /config/mergePolicies

Begäran
I följande begäran skapas en ny sammanfogningsprincip som konfigureras av attributvärdena i nyttolasten:

curl -X POST \
  https://platform.adobe.io/data/core/ups/config/mergePolicies \
  -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 'Content-Type: application/json' \
  -d '{
    "name": "Loyalty members ordered by ID",
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type":"dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "schema": {
        "name":"_xdm.context.profile"
    },
    "isActiveOnEdge": true,
    "default": true
}'
Egenskap Beskrivning
name Ett användarvänligt namn som sammanfogningsprincipen kan identifieras med i listvyer.
identityGraph.type Identitetsdiagramtypen som relaterade identiteter ska sammanfogas från. Möjliga värden: "none" eller "pdg" (privat diagram).
attributeMerge Sättet som profilattributvärden ska prioriteras på vid datakonflikter.
schema Den XDM-schemaklass som är associerad med sammanfogningsprincipen.
isActiveOnEdge Anger om den här sammanfogningsprincipen är aktiv vid kant.
default Anger om den här sammanfogningsprincipen är standard för schemat.

Se komponenter i sammanfogningsprinciper för mer information.

Svar

Ett lyckat svar returnerar information om den nya sammanfogningsprincipen.

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Se komponenter i sammanfogningsprinciper i början av det här dokumentet om du vill ha information om vart och ett av de enskilda elementen som utgör en sammanfogningspolicy.

Uppdatera en sammanfogningsprincip

Du kan ändra en befintlig kopplingsprofil genom att redigera enskilda attribut (PATCH) eller genom att skriva över hela kopplingsprofilen med nya attribut (PUT). Nedan visas exempel på vart och ett av dem.

Redigera enskilda kopplingsprincipfält

Du kan redigera enskilda fält för en sammanfogningsprincip genom att göra en PATCH-förfrågan till /config/mergePolicies/{mergePolicyId} slutpunkt:

API-format

PATCH /config/mergePolicies/{mergePolicyId}
Parameter Beskrivning
{mergePolicyId} Identifieraren för den sammanfogningsprincip som du vill ta bort.

Begäran

Följande begäran uppdaterar en angiven sammanfogningsprincip genom att ändra värdet för dess default egenskap till true:

curl -X PATCH \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -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 'Content-Type: application/json' \
  -d '{
    "op": "add",
    "path": "/default",
    "value": "true"
  }'
Egenskap Beskrivning
op Anger vilken åtgärd som ska utföras. Exempel på andra PATCH-åtgärder finns i JSON Patch-dokumentation
path Sökvägen till det fält som ska uppdateras. Godkända värden är: "/name", "/identityGraph.type", "/attributeMerge.type", "/schema.name", "/version", "/default", "/isActiveOnEdge"
value Värdet som det angivna fältet ska anges till.

Se komponenter i sammanfogningsprinciper för mer information.

Svar

Ett lyckat svar returnerar information om den nyligen uppdaterade sammanfogningsprincipen.

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Skriv över en sammanfogningsprincip

Ett annat sätt att ändra en kopplingsprofil är att använda en PUT-begäran, som skriver över hela kopplingsprofilen.

API-format

PUT /config/mergePolicies/{mergePolicyId}
Parameter Beskrivning
{mergePolicyId} Identifieraren för den sammanfogningsprincip som du vill skriva över.

Begäran

Följande begäran skriver över den angivna sammanfogningsprincipen och ersätter dess attributvärden med dem som anges i nyttolasten. Eftersom den här begäran helt ersätter en befintlig sammanfogningsprincip måste du ange alla fält som krävdes när sammanfogningsprincipen ursprungligen definierades. Den här gången anger du dock uppdaterade värden för de fält som du vill ändra.

curl -X PUT \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -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 'Content-Type: application/json' \
  -d '{
        "name": "Loyalty members ordered by ID",
        "imsOrgId": "{ORG_ID}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "dataSetPrecedence",
            "order": [
                "5b76f86b85d0e00000be5c8b",
                "5b76f8d787a6af01e2ceda18"
            ]
        },
        "isActiveOnEdge": true,
        "default": true,
        "updateEpoch": 1551898378
    }'
Egenskap Beskrivning
name Ett användarvänligt namn som sammanfogningsprincipen kan identifieras med i listvyer.
identityGraph Det identitetsdiagram som relaterade identiteter ska sammanfogas från.
attributeMerge Sättet som profilattributvärden ska prioriteras på vid datakonflikter.
schema Den XDM-schemaklass som är associerad med sammanfogningsprincipen.
isActiveOnEdge Anger om den här sammanfogningsprincipen är aktiv vid kant.
default Anger om den här sammanfogningsprincipen är standard för schemat.

Se komponenter i sammanfogningsprinciper för mer information.

Svar

Ett lyckat svar returnerar information om den uppdaterade sammanfogningsprincipen.

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Ta bort en sammanfogningsprincip

Du kan ta bort en sammanfogningsprincip genom att göra en DELETE-begäran till /config/mergePolicies slutpunkten och ID:t för den sammanfogningsprincip som du vill ta bort i sökvägen för begäran.

OBSERVERA

Om sammanfogningsprincipen har isActiveOnEdge inställd på true, sammanfogningsprincipen inte tas bort. Använd antingen PATCH eller PUT slutpunkter för att uppdatera sammanfogningsprincipen innan den tas bort.

API-format

DELETE /config/mergePolicies/{mergePolicyId}
Parameter Beskrivning
{mergePolicyId} Identifieraren för den sammanfogningsprincip som du vill ta bort.

Begäran

Följande begäran tar bort en sammanfogningsprincip.

curl -X DELETE \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -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}' \

Svar

En slutförd borttagningsbegäran returnerar HTTP-status 200 (OK) och en tom svarstext. Du kan bekräfta att borttagningen lyckades genom att utföra en GET-förfrågan och visa sammanfogningsprincipen efter dess ID. Om sammanfogningsprincipen togs bort får du ett HTTP-statusfel 404 (Hittades inte).

Nästa steg

Nu när ni vet hur ni skapar och konfigurerar sammanfogningspolicyer för er organisation kan ni använda dem för att justera visningen av kundprofiler inom Platform och för att skapa målgruppssegment utifrån era Real-time Customer Profile data.

Se Dokumentation för Adobe Experience Platform Segmenteringstjänst för att börja definiera och arbeta med segment.

På denna sida