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. Innan du fortsätter bör du granska 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 components-of-merge-policies

Sammanslagningsprinciper är privata för din organisation, 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.

NOTE
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 en målgrupp ska kunna aktiveras på kanten (markeras som en målgrupp) måste den vara kopplad till en sammanfogningspolicy som är markerad som aktiv på kanten. Om en publik not som är knutna till en sammanfogningspolicy som är markerad som aktiv på sidan, kommer målgruppen inte att markeras som aktiv på sidan och kommer att markeras som en målgrupp för direktuppspelning.

Dessutom kan varje organisation endast 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 kommer att 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 identity-graph

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 identitetssammanslagning.
  • pdg: Utför identitetssammanfogning baserat på ditt privata identitetsdiagram.

ExempelidentityGraph

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

Koppla attribut attribute-merge

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 den profil 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 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 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 access-merge-policies

Använda Real-Time Customer Profile API, /config/mergePolicies Med slutpunkten kan du utföra en sökbegäran för att visa en specifik sammanfogningsprincip utifrån dess ID, eller få tillgång till alla sammanfogningsprinciper i organisationen, 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 sammanslagningsprincip 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 samkörningsprinciper inom 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 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 sammanfogningsprincip

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 update

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 sammanslagningsprincip 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.

NOTE
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 sammanslagningsprincip 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 du vet hur man skapar och konfigurerar sammanfogningspolicyer för organisationen kan du använda dem för att justera visningen av kundprofiler inom Platform och för att skapa målgrupper 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 målgrupper.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b