[Beperkte beschikbaarheid]{class="badge informative"}
Google Cloud Storage configureren voor publiekssourcing
Volg de stappen in deze handleiding om uw Google Cloud Storage (GCS) emmertje aan Adobe Real-Time CDP Collaboration aan te sluiten en begin het bron van de gegevens van het eerste publiek door UI.
Sluit een GCS-emmertje aan op Collaboration om rechtstreeks en zonder technische ondersteuning toegang te krijgen tot de gegevens van het eerste publiek. Zodra verbonden, levert Collaboration publiek van uw emmer op een terugkerend programma en stelt hen voor activering en overlappende analyse binnen uw samenwerkingsprojecten beschikbaar. Het is een vereiste stap om uw publiek te voeden voordat u deze kunt activeren of gebruiken in een overlappende analyse met medewerkers.
Deze gids behandelt het configuratiewerkschema van begin tot eind: het voorbereiden van eerste vereisten, het voor authentiek verklaren van uw emmertje GCS, het herzien van auto-in kaart gebrachte identiteitsgebieden, het plannen van gegevens verfrissen zich, en het bevestigen dat het kopen met succes voltooide.
Publiek dat afkomstig is uit Google Cloud Storage, hanteert dezelfde regels voor governance en gegevensverwerking als publiek dat afkomstig is uit Adobe Experience Platform.
Andere beschikbare het bron methodes omvatten Experience Platform , Amazon S3 , Snowflake , en CSV- dossierupload .
Vereisten prerequisites
Voltooi alle punten in deze sectie alvorens de configuratiewerkschema te beginnen. De onvolledige eerste vereisten zijn de gemeenschappelijkste redenopstelling ontbreekt of het publiek verschijnt niet na het betrekken. Alvorens deze gids te volgen, moet u rekening op het instappen en opstelling hebben voltooid.
Voor sommige stappen in deze sectie is een handeling van een Google Cloud -beheerder vereist. Als u niet de Google Cloud beheerder voor uw organisatie bent, identificeer de aangewezen persoon alvorens te beginnen.
GCS-toegang en -machtigingen gcs-access-permissions
Bevestig voordat u verdergaat het volgende met uw Google Cloud -beheerder:
- Aan Adobe zijn de machtigingen verleend die vereist zijn voor verificatie op basis van uw GCS-emmertje en het lezen van publieksbestanden. Voor geleidelijke instructies, zie de sectie van de toestemmingsopstelling .
- Google Cloud Storage sourcing van het publiek is beschikbaar in uw regio. De beschikbaarheid varieert per regio (NA, EMEA, ANZ). Als GCS-sourcing nog niet beschikbaar is in uw regio, neemt u contact op met uw Adobe-accountvertegenwoordiger om een tijdlijn te bevestigen.
Uw publieksgegevens voorbereiden prepare-audience-data
Uw publieksdossiers moeten aan de Specificatie van de Bron van het Publiek (v1.2) alvorens het bron begint in overeenstemming zijn. Herzie de specificatie voor de volledige schemadefinitie en gebied-vlakke voorbeelden. De belangrijkste vereisten zijn:
- formaat van het Dossier: CSV, die komma’s als gebiedsscheidingstekens en pijpen (
|) gebruiken als separators voor veelvoudige waarden binnen één enkel gebied. - Vereiste gebieden: Elk verslag moet een
AUDIENCE_IDkolom en minstens één gesteunde kolom van de gelijkesleutel omvatten. - Gesteunde gelijke sleutels:
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_ID. - Hashing vereisten: Alle gelijke zeer belangrijke waarden moeten worden bijgesneden, worden verlaagd, en SHA256-hashed alvorens te uploaden. Collaboration hash of normaliseert gegevens niet voordat ze worden ingenomen.
- consistentie van de Kolom: als uw emmertje veelvoudige publieksdossiers bevat, moeten alle dossiers identieke kolomstructuren gebruiken.
Alle overeenkomende sleutels die aanwezig zijn in de bestanden voor uw publiek, moeten ook zijn ingeschakeld voor uw Collaboration-account. Om gelijke sleutels toe te voegen of toe te laten, zie de passleutels van de Opstelling .
Waarden vereist voordat u begint required-values
Heb de volgende waarden klaar alvorens de configuratietovenaar te beginnen.
sourcing/testdata/path1/ ).Uw Google Cloud Storage verbinding configureren configure-gcs-connection
De configuratieworkflow bestaat uit meerdere stappen in de werkruimte van Setup . Voltooi elke stap in de juiste volgorde. U kunt terugkeren naar elke gewenste stap met het potloodpictogram op het laatste revisiescherm voordat u de verbinding maakt.
Nieuwe gegevensverbinding toevoegen add-data-connection
Van het My audiences lusje binnen de Setup werkruimte, selecteer het add pictogram (
) en selecteer vervolgens Audience .
Als dit uw eerste publiek is, kunt u ook de optie Add selecteren.
De workflow voor het toevoegen van publiek wordt weergegeven. Selecteer Add a new data connection en selecteer vervolgens Next .
{modal="regular"}
Google Cloud Storage selecteren als gegevensbron select-gcs
In het selectiescherm van de gegevensbron worden alle beschikbare verbindingstypen weergegeven. Selecteer Google Cloud Storage en selecteer vervolgens Next .
Er verschijnt een dialoogvenster met verplichte configuratiestappen (bijvoorbeeld GCS bucket-instelling en IAM-roltoewijzing) waarin wordt aangegeven dat gegevens moeten voldoen aan de Audience Sourcing Specification . Selecteer Start onboarding om de compatibiliteit te bevestigen voordat u verdergaat.
Voer uw Google Cloud Storage verbindingsgegevens in authenticate-gcs-connection
Geef de gegevens op die Collaboration nodig heeft om toegang te krijgen tot uw Google Cloud Storage emmertje. Selecteer Next nadat u de vereiste informatie hebt ingevoerd.
Bevestig toestemming en de erkenning van het gegevensgebruik confirm-consent
U moet bevestigen dat de optie om te weigeren toestemming te geven uit de publieksgegevens is verwijderd voordat Collaboration deze kan verwerken. Als u onzeker bent of uw gegevens aan dit vereiste voldoen, herzie de gids van het beleid en van de handhavingsacties alvorens te werk te gaan. Schakel het selectievakje voor bevestiging in en selecteer vervolgens OK om door te gaan.
Verbindingsgegevens opgeven provide-connection-details
Voer een naam en een optionele beschrijving in voor deze gegevensverbinding. De naam die u opgeeft, wordt weergegeven op het tabblad My data connections en u kunt deze bron beter onderscheiden als u meerdere gegevensverbindingen beheert.
- Data connection name (vereist)
- Data connection description (optioneel).
Selecteer Next om door te gaan.
Automatisch toegewezen identiteitsvelden controleren auto-mapped-fields
Het scherm Mapping is alleen-lezen. Collaboration wijst bronidentiteitsvelden van uw publieksbestanden automatisch toe aan doelvelden op basis van de kolomnamen die zijn gedefinieerd in de Specificatie Audience Sourcing. In dit stadium kunt u geen transformaties toevoegen, verwijderen of toepassen op toegewezen velden.
Bevestig dat de weergegeven toewijzingen de velden in uw publieksbestanden weerspiegelen. Als zij niet, ophouden en uw dossiers verbeteren om aan de Specificatie van de Bron van de Publiek in overeenstemming te zijn alvorens te werk te gaan. Selecteer Next om door te gaan.
Gegevens plannen vernieuwen schedule-data-refresh
Stel in de weergave Schedule de frequentie in waarmee Collaboration bijgewerkte publieksgegevens ophaalt uit uw GCS-emmertje en definieer het actieve datumbereik voor de bron.
Gebruik het vervolgkeuzemenu Frequency om te bepalen hoe vaak Collaboration bijgewerkte publieksgegevens ophaalt uit uw GCS-emmertje. De beschikbare intervallen lopen van Daily tot Every 6 days .
Typ een datumbereik in het invoerveld of selecteer het kalenderpictogram om de Start date en End date voor de actieve bronperiode in te stellen. Wanneer de einddatum wordt bereikt, eindigt de bron en eerder afkomstig publiek en niet meer beschikbaar voor gebruik in samenwerkingsprojecten.
Selecteer Next om door te gaan.
De verbinding controleren en voltooien review-and-complete
Controleer het configuratieoverzicht voordat u de verbinding maakt. In het samenvattingsscherm worden de volgende secties weergegeven:
- Data connection: De GCS bucket-referenties en het mappad dat u hebt geconfigureerd.
- Details: De naam en optionele beschrijving van deze gegevensverbinding.
- Mapping: De automatisch toegewezen bron- en doelidentiteitsvelden.
- Schedule: De vernieuwingsfrequentie en het actieve datumbereik.
Selecteer het potloodpictogram (
) naast een sectie om terug te keren naar die stap en wijzigingen aan te brengen. Selecteer Complete als alle secties correct zijn.
Er wordt een bevestigingsvenster weergegeven waarin wordt aangegeven dat Collaboration de gegevensverbinding heeft gemaakt en dat de doelgroep bezig is met het aanschaffen van de verbinding.
Bronpubliek bekijken review-sourced-audiences
Nadat u de configuratietovenaar voltooit, begint Collaboration asynchroon publiek van uw emmertje van GCS te betrekken. Navigeer naar Setup > My audiences om de voortgang te controleren. De bron wordt niet onmiddellijk voltooid. De vereiste tijd is afhankelijk van de grootte van uw gegevens en de geconfigureerde vernieuwingsfrequentie.
De voortgang van de doelgroep controleren monitor-sourcing-progress
Terwijl Collaboration uw publieksgegevens ophaalt, geeft een banner boven aan de My audiences -werkruimte aan dat de bron bezig is. Individuele doelgroepen worden pas in de lijst weergegeven nadat de bron voor elk publiek is voltooid.
Details van publiek van bron weergeven view-audience-details
Nadat de bron is voltooid, verschijnt het Google Cloud Storage -publiek op het tabblad My audiences naast het publiek dat afkomstig is van andere verbindingen. Selecteer een rij-item of View audience om de detailweergave voor een bepaald publiek te openen.
In de gedetailleerde weergave worden de status, de bron en de naam van de gegevensverbinding van het publiek weergegeven, samen met de volgende deelvensters:
- Identities: Het totale aantal identiteiten en de verdeling voor het publiek, zodra de gegevens beschikbaar komen.
- Categories: Alle tags die zijn toegepast voor het organiseren of filteren van het publiek.
- Connection access: Of het publiek privé, openbaar is of met specifieke medewerkers wordt gedeeld.
- Metadata visibility: Welke publieksinformatie — zoals het aantal identiteiten, het overlappingspercentage en de index — is zichtbaar voor deelnemers.
Controleer deze instellingen voordat u het publiek in een samenwerkingsproject gebruikt. Om categorieën, verbindingstoegang, of meta-gegevenszicht bij te werken, zie Mening en beheer individuele publiek .
De publieksinstellingen bewerken edit-audience-settings
U kunt publieksmetagegevens rechtstreeks vanuit de lijstweergave van My audiences bewerken zonder de detailweergave te openen. Schakel het selectievakje voor een publiek in om de actiewerkbalk weer te geven en selecteer vervolgens een actie: Edit metadata visibility, Edit connection access, Edit name and description, Edit categories of Delete .
De GCS-gegevensverbinding weergeven view-gcs-connection
Navigeer naar Setup > My data connections om de verbinding zelf, inclusief de overeenkomende toetsen en het plannen, te controleren of te beheren. Uw nieuwe GCS-verbinding is hier direct beschikbaar. De publieksbron wordt weergegeven als Google Cloud Storage .
Bekende beperkingen known-limitations
Houd rekening met de volgende beperkingen bij het configureren en gebruiken van Google Cloud Storage publiek sourcing:
- Gelijke zeer belangrijke beperkingen: Zodra een gelijke sleutel voor een gegevensverbinding wordt toegelaten, kan het niet worden verwijderd. U kunt gelijke sleutels aan een bestaande verbinding toevoegen, maar u kunt niet hen onbruikbaar maken of schrappen. Om de actieve gelijke sleutels te veranderen, moet u de gegevensverbinding schrappen en nieuwe creëren.
- Één actieve gegevensverbinding per bron: slechts één actieve Google Cloud Storage gegevensverbinding wordt gesteund tegelijkertijd. Als u publiek van een verschillend emmertje moet bron, schrapt de bestaande verbinding en creeer nieuwe die aan het nieuwe emmertje richten.
- Subfolder steun: de dossiers van het publiek moeten direct binnen de gespecificeerde omslagweg worden gevestigd. Collaboration voert in dat pad geen submappen over.
Problemen oplossen troubleshooting
In deze sectie kunt u problemen oplossen die optreden nadat u de eerste verbinding hebt gemaakt. Voor fouten die tijdens authentificatie voorkomen, herzie uw geloofsbrieven en emmertoestemmingen, of contacteer uw beheerder.
de Soorten van het publiek verschijnen niet of de bron neemt langer dan verwacht
- De de tijdschaal van de bron met gegevensvolume en gevormd verfrist frequentie. De uitgebreide verwerkingstijd wordt verwacht voor grote datasets.
- Als het publiek niet binnen 24 uur is weergegeven, controleert u of de bestanden voor het publiek aanwezig zijn in het mappad dat u tijdens de installatie hebt opgegeven en of ze voldoen aan de specificatie voor audiobronnen.
- Controleer het tabblad My data connections op foutindicatoren voor de verbinding.
- Als het probleem zich blijft voordoen nadat u deze stappen hebt uitgevoerd, neemt u contact op met de klantenondersteuning van Adobe en verstrekt u de naam en de gegevens van de gegevensverbinding.
de gegevensverbinding toont een ontbroken status na aanvankelijk succesvol
- Bevestig dat de toestemmingen en geloofsbrieven van het emmertje GCS niet zijn veranderd aangezien u de verbinding creeerde. Om het even welke verandering die Adobe toegang tot de emmer verwijdert veroorzaakt verdere broninglooppas om te ontbreken.
- Verifieer dat de publieksdossiers nog bij de gevormde omslagweg bestaan en aan de Specificatie van de Bron van de Publiek in overeenstemming zijn.
- Als de kwestie na het bevestigen van toestemmingen en dossierbeschikbaarheid voortduurt, schrapt de verbinding en creeer nieuwe, of contacteer de klantensteun van Adobe.
de fouten van het het dossierformaat van het publiek komen tijdens voor gepland verfrist zich
- Bevestig dat de bijgewerkte dossiers in het emmertje met de kolomstructuur en gebiedsvereisten in de Specificatie van de Bron van de Publiek voldoen.
- Zorg ervoor dat alle bestanden in het geconfigureerde mappad identieke kolomstructuren gebruiken. Bestanden met gemengde indeling in hetzelfde pad kunnen leiden tot gedeeltelijk bronfout.
Google Cloud Storage -machtigingen instellen setup-gcs-permissions
Google Cloud Storage biedt een veilige, schaalbare manier om uw gegevens in de cloud op te slaan en te openen. Als u Adobe wilt toestaan om te lezen vanaf uw GCS-emmers, moet u de juiste identiteitsmachtigingen (Identity and Access Management, IAM) en toegang tot serviceaccount in uw Google Cloud -account configureren.
Informatie over Adobe Google Service Account verzamelen collect-account-information
Om aan de slag te gaan, noteert u Google Service Account voor Adobe die overeenkomt met uw regio. U hebt deze informatie nodig om Adobe toegang te verlenen in latere stappen.
kk9930000@va3-22da.iam.gserviceaccount.comkze830000@sfc-eufrankfurt-1-g4a.iam.gserviceaccount.comknhv20000@sfc-au-1-nla.iam.gserviceaccount.comIAM-rol instellen setup-iam-role
Voer de onderstaande stappen uit om een aangepaste IAM-rol te maken met de benodigde machtigingen en deze toe te wijzen aan het Adobe-serviceaccount. Dit zorgt ervoor dat Adobe veilige toegang heeft tot uw GCS-publieksgegevens.
IAM-rol maken create-iam-role
Maak eerst een aangepaste IAM-rol in uw Google Cloud -project met de benodigde machtigingen om toe te wijzen aan Adobe.
In de IAM & Admin pagina van de Google Cloud Console , navigeer aan Roles en selecteer Create role. Vul de vereiste gegevens in, zoals de titel en de id voor uw nieuwe rol.
Voeg vervolgens de volgende machtigingen toe aan de rol:
storage.buckets.getstorage.objects.getstorage.objects.listVoor meer informatie over toestemmingen, zie {de toestemmingen van 0} GCS IAM 🔗. Voor geleidelijke instructies, zie hoe te om douanerollen tot stand te brengen.
IAM-rol toewijzen aan Adobe assign-role
Open vervolgens de Bucketspagina in de Google Cloud Console en selecteer het emmertje dat uw publieksgegevens bevat.
Navigeer naar de tab Permissions , kies View by principals en selecteer Grant access .
In de Add principals dialoog, voeg de Rekening van de Dienst van Adobe Google als hoofd toe en wijs de rol van douaneIAM toe u vroeger creeerde. Selecteer Save om de instelling te bevestigen.
Adobe heeft nu veilige toegang tot uw publieksgegevens in het geselecteerde GCS-emmertje. Herzie om het even welke extra eerste vereisten zoals nodig, of ga te werk beginnen bronend publiek van GCS in Collaboration .
Google Cloud Storage details verzamelen collect-gcs-details
Tot slot verzamel de details voor uw emmertje GCS zoals aangetoond in de hieronder lijst. U hebt deze informatie nodig om de verbinding tussen uw GCS en Collaboration in te stellen.
customer-data-bucket/ om alle bestanden te lezen.sourcing/testdata/path1/Volgende stappen next-steps
U hebt Google Cloud Storage geconfigureerd als gegevensbron in Collaboration. Nadat de bron is voltooid, zijn uw publiek beschikbaar in de My audiences -werkruimte en klaar voor gebruik in samenwerkingsprojecten.
Vanaf hier kunt u:
Voor andere methoden voor publiekssourcing raadpleegt u: