Documentatie Experience Platform Handleiding voor bestemmingen

Aangepaste verpersoonlijkingsverbinding

Laatst bijgewerkt: 29 augustus 2024

Onderwerpen:
Destinations

Gemaakt voor:

Beheerder
Gebruiker

Doelwijziging

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

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

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

Gebruik SDK van het Web van Adobe Experience Platformals u gegevens van uw website wilt verzamelen.
Gebruik Adobe Experience Platform Mobile SDKals u gegevens van uw mobiele toepassing wilt verzamelen.
Gebruik de Server API van de Edge Networkals u SDK van het Webof Mobiele SDKniet gebruikt, of als u de gebruikerservaring wilt personaliseren die op profielattributen wordt gebaseerd.

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

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

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

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

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

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

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

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

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