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 verpersoonlijkingen is over het algemeen beschikbaar aan alle klanten.
IMPORTANT
Profielkenmerken kunnen vertrouwelijke gegevens bevatten. Om dit gegeven te beschermen, moet u de Server API van de Edge Networkgebruiken wanneer het vormen van de Custom Personalization bestemming voor op attribuut-gebaseerde verpersoonlijking. Alle Server API vraag moet in een voor authentiek verklaarde contextworden gemaakt.
u kunt profielattributen via de Server API van de Edge Network terugwinnen APIdoor een server-zijintegratie toe te voegen die de zelfde gegevensstroom gebruikt die u reeds voor uw Web of Mobiele implementatie 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 randverpersoonlijkingactiveren. Deze gids neemt u door de vereiste configuratiestappen voor zelfde-pagina en volgende-paginagrootte het gebruiksgevallen van het verpersoonlijkingsgebruik, over veelvoudige 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 het Experience Platform 🔗.
Aangepaste uploads
Het publiek ingevoerdein 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 gegevensstromen van de Inzameling van Gegevens van de Adobezijn.
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 toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

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

Verbindingsparameters parameters

Terwijl vestigingdeze 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 Web SDK van het Experience Platform.
  • Datastream ID: 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 datastreamvoor 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 toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

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

Geëxporteerde gegevens exported-data

Als u Markeringen in Adobe Experience Platformgebruikt om het Web SDK van het Experience Platform op te stellen, gebruik verzendt gebeurtenis volledigefunctionaliteit 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 Markeringenniet gebruikt om het Web SDK van het Experience Platform op te stellen, gebruik bevelreactiesom 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