LiveRamp - Onboarding verbinding liveramp-onboarding

Gebruik de LiveRamp - Onboarding -verbinding met het on-board publiek van Adobe Real-Time Customer Data Platform naar LiveRamp Connect .

Gebruiksscenario’s use-cases

Om u beter te helpen begrijpen hoe en wanneer u de LiveRamp - Onboarding bestemming zou moeten gebruiken, is hier een geval van het steekproefgebruik dat de klanten van Adobe Experience Platform kunnen oplossen door deze bestemming te gebruiken.

Als markator wil ik een publiek van Adobe Experience Platform naar boordidentiteiten sturen naar LiveRamp Connect , zodat ik gebruikers op mobiele, open web-, sociale en CTV -platforms kan besturen met de id Ramp ID .

Vereisten prerequisites

De LiveRamp - Onboarding verbinding voert dossiers uit gebruikend ​ 2} opslag van SFTP van LiveRamp {.

Voordat u gegevens van Experience Platform naar LiveRamp - Onboarding kunt verzenden, hebt u uw LiveRamp -referenties nodig. Neem contact op met uw LiveRamp -vertegenwoordiger om uw referenties te verkrijgen, als u deze nog niet hebt.

Ondersteunde identiteiten supported-identities

LiveRamp - Onboarding steunt de activering van identiteiten zoals op PII-Gebaseerde herkenningstekens, bekende herkenningstekens, en douane IDs, die in de officiële ​ documentatie LiveRamp ​ wordt beschreven.

In de ​ toewijzingsstap ​ van het activeringswerkschema, moet u de doelafbeeldingen als douanekenmerken bepalen.

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

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Audience export
U exporteert alle leden van een publiek met de id's (naam, telefoonnummer of andere) die in de LiveRamp - Onboarding -bestemming worden gebruikt.
Exportfrequentie
Daily batch
Aangezien profielen in Experience Platform worden bijgewerkt op basis van publieksevaluatie, worden de profielen (identiteiten) eenmaal per dag bijgewerkt naar het doelplatform. Lees meer over ​ partij op dossier-gebaseerde 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. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Verifiëren voor bestemming authenticate

Als u voor verificatie bij het doel wilt zorgen, vult u de vereiste velden in en selecteert u Connect to destination .

authentificatie SFTP met wachtwoord

het schermschot van de Steekproef die hoe te om aan de bestemming voor authentiek te verklaren gebruikend SFTP met wachtwoord tonen

  • Port: De poort die wordt gebruikt voor de opslaglocatie van LiveRamp - Onboarding . Gebruik de poort die overeenkomt met uw geografische locatie, zoals hieronder wordt beschreven:

    • NA: poort gebruiken 22
    • AU: poort gebruiken 2222
  • Username: De gebruikersnaam voor de opslaglocatie van LiveRamp - Onboarding .

  • Password: Het wachtwoord voor de opslaglocatie van LiveRamp - Onboarding .

  • PGP/GPG encryption key: U kunt desgewenst een openbare sleutel met RSA-indeling toevoegen om versleuteling toe te voegen aan uw geëxporteerde bestanden. Bekijk een voorbeeld van een correct opgemaakte coderingssleutel in de onderstaande afbeelding.
    Beeld dat een voorbeeld van een correct geformatteerde sleutel PGP in UI toont

  • Subkey ID:Als u een coderingssleutel opgeeft, moet u ook een codering opgeven Subkey ID . Zie LiveRamp ​ encryptiedocumentatie ​ leren hoe te om subkey identiteitskaart te verkrijgen.

SFTP met SSH zeer belangrijke authentificatie

het schermschot van de Steekproef die hoe te om aan de bestemming voor authentiek te verklaren gebruikend sleutel SSH tonen

  • Port: De poort die wordt gebruikt voor de opslaglocatie van LiveRamp - Onboarding . Gebruik de poort die overeenkomt met uw geografische locatie, zoals hieronder wordt beschreven:

    • EU: poort gebruiken 4222
  • Username: De gebruikersnaam voor de opslaglocatie van LiveRamp - Onboarding .

  • SSH Key: De persoonlijke SSH -sleutel die wordt gebruikt om u aan te melden bij uw LiveRamp - Onboarding -opslaglocatie. De persoonlijke sleutel moet zijn opgemaakt als een Base64 -gecodeerde tekenreeks en mag niet met een wachtwoord zijn beveiligd.

    • Als u de SSH -sleutel wilt koppelen aan de LiveRamp - Onboarding -server, moet u een ticket verzenden via de portal voor technische ondersteuning van LiveRamp en uw openbare sleutel opgeven. Zie meer informatie in de ​ documentatie LiveRamp ​.
  • PGP/GPG encryption key: U kunt desgewenst een openbare sleutel met RSA-indeling toevoegen om versleuteling toe te voegen aan uw geëxporteerde bestanden. Bekijk een voorbeeld van een correct opgemaakte coderingssleutel in de onderstaande afbeelding.
    Beeld dat een voorbeeld van een correct geformatteerde sleutel PGP in UI toont

  • Subkey ID:Als u een coderingssleutel opgeeft, moet u ook een codering opgeven Subkey ID . Zie LiveRamp ​ encryptiedocumentatie ​ leren hoe te om subkey identiteitskaart te verkrijgen.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.

{het schermschot van 0} Experience Platform UI die tonen hoe te om details voor uw bestemming in te vullen

  • Name: Een naam waarmee u dit doel in de toekomst herkent.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
  • Region: Geografisch gebied voor uw instantie van de LiveRamp SFTP-opslag.
  • Folder path: Het pad naar de submap LiveRamp uploads die de geëxporteerde bestanden host. Het voorvoegsel uploads wordt automatisch toegevoegd aan het mappad. LiveRamp raadt u aan een speciale submap voor leveringen van Adobe Real-Time CDP te maken om de bestanden gescheiden te houden van andere bestaande feeds en om ervoor te zorgen dat alle automatisering probleemloos wordt uitgevoerd.
    • Als u bijvoorbeeld uw bestanden naar uploads/my_export_folder wilt exporteren, typt u in my_export_folder in het veld Folder path .
  • Compression format: Selecteer het compressietype dat Experience Platform moet gebruiken voor de geëxporteerde bestanden. Beschikbare opties zijn GZIP of None .

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, lees de gids over ​ 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 publieksgegevens aan de uitvoerbestemmingen van het partijprofiel ​ voor instructies bij het activeren van publiek aan deze bestemming.

Planning scheduling

Maak in de stap Scheduling een exportschema voor elk publiek met de onderstaande instellingen.

  • File export options: Export full files . ​ de Incrementele dossieruitvoer ​ wordt momenteel niet gesteund voor de LiveRamp bestemming.
  • Frequency: Daily
  • Date: selecteer de begin- en eindtijd van het exporteren naar wens.

{het schermschot van 0} Experience Platform UI die het publiek toont die stap plannen.

De geëxporteerde bestandsnaam kan momenteel niet door de gebruiker worden geconfigureerd. Alle bestanden die naar de LiveRamp - Onboarding -bestemming worden geëxporteerd, krijgen automatisch een naam op basis van de volgende sjabloon:

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

{het schermschot van 0} Experience Platform UI die het uitgevoerde dossier - naammalplaatje toont.

De naam van een geëxporteerd bestand voor een organisatie met de naam Luma kan er bijvoorbeeld als volgt uitzien:

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

Kenmerken en identiteiten toewijzen map

In de stap Mapping kunt u selecteren welke kenmerken en identiteiten u wilt exporteren voor uw profielen.

IMPORTANT
Deze bestemming ondersteunt de activering van één naamruimte van de bronidentiteit per activeringsstroom. Als u veelvoudige identiteit namespaces, als Email en Phone moet uitvoeren, moet u ​ een afzonderlijke activeringsstroom ​ voor elke identiteit creëren.

In de stap Mapping definieert de toewijzing Target field de naam van de kolomkop in het geëxporteerde CSV-bestand. U kunt de CSV-kolomkoppen in het geëxporteerde bestand wijzigen in elke gewenste vriendelijke naam door een aangepaste naam op te geven voor de Target field .

IMPORTANT
Voor om het even welke veranderingen die aan de doelgebieden na uw aanvankelijke dossierlevering aan LiveRamp worden aangebracht, te informeren gelieve uw LiveRamp accountteam of ​ een kaartje aan Steun LiveRamp ​ voorleggen om ervoor te zorgen dat de veranderingen in het automatiseringsproces worden weerspiegeld.
  1. Selecteer Add new mapping in de stap Mapping . Er verschijnt een nieuwe toewijzingsrij op het scherm.

    de schermopname van Experience Platform UI die het scherm van de Afbeelding toont.

  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk dat u wilt toewijzen, of kies de categorie Select identity namespace en selecteer de identiteit die u wilt toewijzen aan uw doel.

    het schermschot van Experience Platform UI die het scherm van de bronToewijzing toont.

  3. Voer in het venster Select target field de kenmerknaam in waaraan u het geselecteerde bronveld wilt toewijzen. De hier gedefinieerde kenmerknaam wordt in het geëxporteerde CSV-bestand weergegeven als kolomkop.

    de screeshot van Experience Platform UI die het scherm van het doelToewijzing toont.

    U kunt de kenmerknaam ook invoeren door deze rechtstreeks in Target field te typen.

    de screeshot van Experience Platform UI die het scherm van het doelToewijzing toont.

Nadat u alle gewenste toewijzingen hebt toegevoegd, selecteert u Next en voltooit u de activeringsworkflow.

Geëxporteerde gegevens/Gegevens valideren bij exporteren exported-data

Uw gegevens worden als CSV-bestanden geëxporteerd naar de opslaglocatie van LiveRamp - Onboarding die u hebt geconfigureerd.

Geëxporteerde bestanden hebben een maximale grootte van 10 miljoen rijen. Experience Platform genereert meerdere bestanden per levering als het geselecteerde publiek groter is dan 10 miljoen rijen. Als u verwacht dat u de limiet voor één bestand overschrijdt, neemt u contact op met uw LiveRamp -vertegenwoordiger en vraagt u deze om batch-opname voor u te configureren.

Wanneer het uitvoeren van dossiers aan de LiveRamp - Onboarding bestemming, produceert Experience Platform één Csv- dossier voor elke ​ identiteitskaart van het fusiebeleid ​.

Neem bijvoorbeeld het volgende publiek:

  • Publiek A (Samenvoegingsbeleid 1)
  • Publiek B (Samenvoegingsbeleid 2)
  • Publiek C (Samenvoegingsbeleid 1)
  • Publiek D (Samenvoegingsbeleid 1)

Experience Platform exporteert twee CSV-bestanden naar LiveRamp - Onboarding :

  • één CSV-bestand met soorten publiek A, C en D;
  • Eén CSV-bestand met publiek B.

Geëxporteerde CSV-bestanden bevatten profielen met de geselecteerde kenmerken en de corresponderende publieksstatus, in afzonderlijke kolommen, met de kenmerknaam en audience_namespace:audience_ID paren als kolomkoppen, zoals in het onderstaande voorbeeld wordt getoond:

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

De profielen in de geëxporteerde bestanden kunnen overeenkomen met een van de volgende kwalificatiestatus van het publiek:

  • Active: Het profiel is momenteel gekwalificeerd voor het publiek.
  • Expired: het profiel is niet langer gekwalificeerd voor het publiek, maar is in het verleden wel gekwalificeerd.
  • "" (lege tekenreeks): Het profiel wordt nooit in aanmerking genomen voor het publiek.

Bijvoorbeeld, een uitgevoerd CSV dossier met één email attribuut, twee publiek uit de Dienst van de Segmentatie van Experience Platform 🔗 voortkomt, en één ​ ingevoerd ​ extern publiek, kon als dit kijken:

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

In het voorbeeld hierboven, beschrijven de ups_aa2e3d98-974b-4f8b-9507-59f65b6442df en ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f secties publiek dat uit de Dienst van de Segmentatie voortkomt, terwijl CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e een publiek beschrijft dat in Experience Platform als a ​ wordt ingevoerd uploadt ​.

Aangezien Experience Platform één Csv- dossier voor elke ​ identiteitskaart van het fusiebeleid ​ produceert, produceert het ook een afzonderlijke dataflow looppas voor elke identiteitskaart van het fusiebeleid.

Dit betekent dat de Identities activated en Profiles received metriek in de ​ dataflow looppas ​ pagina voor elke groep van publiek worden samengevoegd die het zelfde fusiebeleid gebruiken, in plaats van wordt getoond voor elk publiek.

Als gevolg van dataflow looppas die voor een groep van publiek wordt geproduceerd die het zelfde fusiebeleid gebruiken, worden de publieksnamen niet getoond in het ​ controledashboard ​.

het schermopname van Experience Platform UI die de metrisch geactiveerde identiteiten toont.

Geëxporteerde gegevens uploaden naar LiveRamp upload-to-liveramp

Nadat uw gegevens naar de LiveRamp - Onboarding -opslag zijn geëxporteerd, moet u de gegevens uploaden naar het LiveRamp -platform.

Voor meer informatie over hoe te om uw dossiers van de LiveRamp - Onboarding opslag aan een LiveRamp publiek te uploaden, zie de volgende documentatie: ​ Overwegingen wanneer het Uploaden van het Eerste Dossier aan een Publiek ​.

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

Aanvullende bronnen additional-resources

Voor meer details op hoe te om uw LiveRamp - Onboarding opslag te vormen, zie de ​ officiële documentatie ​.

Changelog changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
Maart 2024 Bijwerken van functionaliteit en documentatie
  • Extra ondersteuning voor leveringen aan instanties van Europa en Australië LiveRamp SFTP .
  • Bijgewerkte documentatie om specifieke configuraties voor onlangs gesteunde gebieden te beschrijven.
  • Maximale bestandsgrootte is verhoogd tot 10 miljoen rijen (van 5 miljoen, eerder).
  • Bijgewerkte documentatie die op verhoogde dossiergrootte wijst.
Juli 2023 Eerste release Eerste doelversie en documentatie gepubliceerd.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6