Anpassad Personalization-anslutning custom-personalization-connection

Destinationsändringslogg changelog

Använd den här ändringsloggen för att spåra uppdateringar av det anpassade Personalization-målet.

Releasamånad
Uppdateringstyp
Beskrivning
Maj 2023
Funktioner och dokumentation
Från om med maj 2023 har anslutningen Custom personalization stöd för attributbaserad anpassning och är allmänt tillgänglig för alla kunder.
IMPORTANT
Profilattribut kan innehålla känsliga data. Om du vill skydda dessa data använder du Edge Network API när du konfigurerar Custom Personalization-målet för attributbaserad personalisering. Alla Edge Network API-anrop måste göras i en autentiserad kontext.
Hämta profilattribut via Edge Network API genom att lägga till en integration på serversidan som använder samma datastream som du redan använder för din webb- eller Mobile SDK-implementering.
Om ni inte uppfyller kraven ovan baseras personaliseringen endast på målgruppsmedlemskap.

Översikt overview

Ange det här målet för att tillåta externa personaliseringsplattformar, innehållshanteringssystem, annonsservrar och andra program som körs på kundwebbplatser att hämta målgruppsinformation från Adobe Experience Platform.

Förutsättningar prerequisites

Detta mål kräver en av följande datainsamlingsmetoder, beroende på implementeringen:

IMPORTANT
Attributbaserade personaliseringskrav: Om du vill anpassa baserat på profilattribut (inte bara målgruppsmedlemskap) måste använda Edge Network API med autentiserad integration på serversidan, oavsett om du också använder Web SDK eller Mobile SDK för datainsamling.
Endast SDK och SDK för mobiler stöder personalisering enbart baserat på målgruppsmedlemskap. Edge Network API är obligatoriskt för att säkert hämta profilattribut för personalisering.
IMPORTANT
Innan du skapar en anpassad Personalization-anslutning läser du guiden om hur du aktiverar målgruppsdata för kantanpassningsmål. Den här guiden tar dig igenom de nödvändiga konfigurationsstegen för användning av samma sida och nästa sida för personalisering, i flera Experience Platform-komponenter.

Målgrupper supported-audiences

I följande tabell visas de målgruppstyper som du kan exportera till det här målet.

Målgruppsursprung
Stöds
Beskrivning
Segmentation Service
Ja
Publiker som genererats via Experience Platform segmenteringstjänst.
Alla andra målgrupper kommer
Ja

Den här kategorin omfattar alla målgrupper som kommer utanför målgrupper som genereras via Segmentation Service. Läs om de olika målgruppernas ursprung. Några exempel är:

  • anpassade uppladdningsgrupper importerade till Experience Platform från CSV-filer,
  • lookalike-målgrupper,
  • federerade målgrupper,
  • målgrupper som har genererats i andra Experience Platform-appar som Adobe Journey Optimizer,
  • med mera.

Målgrupper som stöds av olika typer av målgruppsdata:

Typ av målgruppsdata
Stöds
Beskrivning
Användningsfall
Målgrupper
Ja
Rikta in er på specifika grupper av människor baserat på kundprofiler.
Ofta köpare, övergivna varukorgar
Kontomålgrupper
Nej
Rikta er till individer inom specifika organisationer för kontobaserade marknadsföringsstrategier.
B2B-marknadsföring
Prospektera målgrupper
Nej
Rikta er till individer som ännu inte är kunder men som delar egenskaper med er målgrupp.
Prospektera med data från tredje part
Datauppsättningsexport
Nej
Samlingar med strukturerade data lagrade i datasjön Adobe Experience Platform.
Arbetsflöden för rapportering, datavetenskap

Exportera typ och frekvens export-type-frequency

I följande tabell beskrivs exporttypen och frekvensen för destinationen.

Objekt
Typ
Anteckningar
Exporttyp
Profile request
Begär alla målgrupper som mappats i det anpassade Personalization-målet för en enda profil. Olika anpassade Personalization-mål kan ställas in för olika Adobe Data Collection-datastreams.
Exportfrekvens
Streaming
Direktuppspelningsmål är alltid API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration.

Anslutningsparametrar parameters

När konfigurerar för det här målet måste du ange följande information:

  • Name: Fyll i det önskade namnet för det här målet.
  • Description: Ange en beskrivning för målet. Du kan till exempel ange vilken kampanj du använder det här målet för. Det här fältet är valfritt.
  • Integration alias: En obligatorisk sträng som identifierar det här målet i personaliseringssvaret. Aliasvärdet returneras till din webbplats eller app tillsammans med målgrupperna (och, om de är konfigurerade, attribut) som är kopplade till det här målet. Använd aliaset i koden på klient- eller serversidan för att hitta och bearbeta rätt personaliseringsobjekt när flera personaliseringsmål är aktiva på samma dataström. Aliaset måste vara unikt i en sandlåda för alla anpassade Personalization-mål.
  • Datastream: Detta avgör i vilken datainsamling som målgrupperna ska inkluderas i svaret på sidan. I den nedrullningsbara menyn visas endast datastreams som har målkonfigurationen aktiverad. Mer information finns i Konfigurera ett datastream.

Aktivera aviseringar enable-alerts

Aktivera aviseringar om du vill få meddelanden om status för dataflödet till det här målet. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet activate

IMPORTANT
För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Läs Aktivera profiler och målgrupper för att kanalisera personaliseringsmål för instruktioner om hur du aktiverar målgrupper till det här målet.

Exporterade data exported-data

Om du använder taggar i Adobe Experience Platform för att distribuera Experience Platform Web SDK använder du funktionen send event complete . Din anpassade kodsåtgärd kommer att ha en event.destinations-variabel som du kan använda för att visa exporterade data.

Här är ett exempelvärde för variabeln event.destinations:

[
   {
      "type":"profileLookup",
      "destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
      "alias":"personalizationAlias",
      "segments":[
         {
            "id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         },
         {
            "id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         }
      ]
   }
]

Om du inte använder taggar för att distribuera Experience Platform Web SDK kan du använda kommandosvar för att se exporterade data.

Tolka JSON-svaret från Adobe Experience Platform för att hitta integreringsaliaset för programmet som du integrerar med Adobe Experience Platform. Skicka målgrupps-ID:n till programmets kod som målparametrar. Nedan visas ett exempel på hur detta ser ut när det gäller målsvaret.

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
}).then(function(result) {
    if(result.destinations) { // Looking to see if the destination results are there

        // Get the destination with a particular alias
        var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
        if(personalizationDestinations.length > 0) {
             // Code to pass the audience IDs into the system that corresponds to personalizationAlias
        }
        var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
        if(adServerDestinations.length > 0) {
            // Code to pass the audience IDs into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

Exempelsvar för anpassad Personalization med attribut example-response-attributes

När du använder Custom Personalization With Attributes ser API-svaret ut ungefär som i exemplet nedan.

Skillnaden mellan Custom Personalization With Attributes och Custom Personalization är inkluderingen av avsnittet attributes i API-svaret.

[
    {
        "type": "profileLookup",
        "destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
        "alias": "personalizationAlias",
        "attributes": {
             "countryCode": {
                   "value" : "DE"
              },
             "membershipStatus": {
                   "value" : "PREMIUM"
              }
         },
        "segments": [
            {
                "id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            },
            {
                "id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            }
        ]
    }
]

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Översikt över datastyrning.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6