Aangepaste verpersoonlijkingsverbinding custom-personalization-connection

Doelwijziging changelog

Releasedatum
Type bijwerken
Beschrijving
Mei 2023
Bijwerken van functionaliteit en documentatie
Vanaf Mei 2023, steunt de Custom personalization verbinding ​ op attribuut-gebaseerde verpersoonlijking ​ en is over het algemeen beschikbaar aan alle klanten.
IMPORTANT
Profielkenmerken kunnen vertrouwelijke gegevens bevatten. Om dit gegeven te beschermen, moet u ​ Edge Network API ​ gebruiken wanneer het vormen van de Custom Personalization bestemming voor op attribuut-gebaseerde verpersoonlijking. Alle Edge Network API vraag moet in een ​ voor authentiek verklaarde context ​ worden gemaakt.
u kunt profielattributen via ​ Edge Network API ​ terugwinnen door een server-zijintegratie toe te voegen die de zelfde gegevensstroom gebruikt die u reeds voor uw implementatie van het Web of Mobiele SDK gebruikt.
als u niet de hierboven vereisten volgt, zal de verpersoonlijking op publiekslidmaatschap slechts gebaseerd zijn.

Overzicht overview

Stel deze bestemming in om externe personalisatieplatforms, contentbeheersystemen en servers en andere toepassingen die op websites van klanten worden uitgevoerd, toe te staan om publieksinformatie van Adobe Experience Platform op te halen.

Vereisten prerequisites

Deze bestemming vereist het gebruik van één van de volgende methodes van de gegevensinzameling, afhankelijk van uw implementatie:

IMPORTANT
Alvorens een verbinding van de douaneverpersoonlijking tot stand te brengen, lees de gids op hoe te ​ publieksgegevens aan de bestemmingen van de randverpersoonlijking ​ activeren. Deze handleiding begeleidt u door de vereiste configuratiestappen voor het gebruik van dezelfde pagina en volgende pagina's voor personalisatie, voor meerdere Experience Platform-componenten.

Ondersteunde doelgroepen supported-audiences

In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.

Oorsprong publiek
Ondersteund
Beschrijving
Segmentation Service
Het publiek produceerde door de Dienst van de Segmentatie van Experience Platform 🔗.
Aangepaste uploads
Het publiek ​ ingevoerde ​ in Experience Platform van Csv- dossiers.

Type en frequentie exporteren export-type-frequency

Item
Type
Notities
Exporttype
Profile request
U vraagt om alle soorten publiek die voor één profiel zijn toegewezen in de aangepaste verpersoonlijkingsbestemming. De verschillende bestemmingen van de douaneverpersoonlijking kunnen opstelling voor verschillende ​ de gegevensstromen van de Inzameling van Gegevens van Adobe ​ zijn.
Exportfrequentie
Streaming
Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over ​ het stromen bestemmingen ​.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations ​ toegangsbeheertoestemmingen ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het ​ leerprogramma van de bestemmingsconfiguratie ​ worden beschreven.

Verbindingsparameters parameters

Terwijl ​ vestiging ​ deze bestemming, u de volgende informatie moet verstrekken:

  • Name: vul de voorkeursnaam voor dit doel in.
  • Description: voer een beschrijving in voor uw doel. U kunt bijvoorbeeld opgeven voor welke campagne u deze bestemming wilt gebruiken. Dit veld is optioneel.
  • Integration alias: deze waarde wordt als een JSON-objectnaam verzonden naar de Experience Platform Web SDK.
  • Datastream: hiermee bepaalt u in welke gegevensstroom voor gegevensverzameling het publiek wordt opgenomen in de reactie op de pagina. Het drop-down menu toont slechts gegevensstromen die de toegelaten bestemmingsconfiguratie hebben. Zie ​ Vormend een datastream ​ voor meer details.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij ​ het intekenen aan bestemmingsalarm gebruikend UI ​.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT
Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments ​ toegangsbeheertoestemmingen ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Lees ​ activeer profielen en de de verpersoonlijkingsbestemmingen van de doelpubliek van de doelgroep ​ voor instructies bij het activeren van publiek aan deze bestemming.

Geëxporteerde gegevens exported-data

Als u ​ Markeringen in Adobe Experience Platform ​ gebruikt om het Web SDK van Experience Platform op te stellen, gebruik ​ verzendt gebeurtenis volledige ​ functionaliteit en uw actie van de douanecode zal een event.destinations variabele hebben die u kunt gebruiken om de uitgevoerde gegevens te zien.

Hier volgt een voorbeeldwaarde voor de variabele 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"
         }
      ]
   }
]

Als u niet ​ Markeringen ​ gebruikt om het Web SDK van Experience Platform op te stellen, gebruik ​ bevelreacties ​ om de uitgevoerde gegevens te zien.

Het JSON-antwoord van Adobe Experience Platform kan worden geparseerd om de bijbehorende integratiealias te zoeken van de toepassing die u integreert met Adobe Experience Platform. De gebruikers-id's kunnen als doelparameters worden doorgegeven aan de code van de toepassing. Hieronder ziet u een voorbeeld van hoe dit er specifiek uitziet voor de doelrespons.

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.
  });

Voorbeeld van reactie voor Custom Personalization With Attributes

Wanneer u Custom Personalization With Attributes gebruikt, ziet de API-reactie eruit zoals in het onderstaande voorbeeld.

Het verschil tussen Custom Personalization With Attributes en Custom Personalization is de opname van de sectie attributes in de API-reactie.

[
    {
        "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"
            }
        ]
    }
]

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, lees het ​ overzicht van het Beleid van Gegevens ​.

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