Implementierung der Aktivierung in Ihrem Clean Room

Überblick über die Aktivierung

Der Anbieter oder Verbraucher kann die Ergebnisse der Vorlagen außerhalb des Clean Room in einem Prozess namens Aktivierung versenden. Snowflake unterstützt drei Arten der Aktivierung:

  • Anbieteraktivierung, bei der die Ergebnisse in eine Tabelle im Snowflake-Konto des Anbieters übertragen werden.

  • Verbraucheraktivierung, bei der die Ergebnisse in eine Tabelle im Snowflake-Konto des Verbrauchers übertragen werden.

  • Drittanbieter-Aktivierung, bei der der Anbieter oder Verbraucher die Ergebnisse über einen Aktivierungskonnektor an einen von Snowflake zugelassenen Drittanbieter wie LiveRamp oder Meta Ads Manager weiterleitet.

In jedem Fall muss die Vorlage die Aktivierung unterstützen. Die andere Partei muss die Aktivierung für alle Spalten ihrer eigenen Daten, die exportiert werden sollen, genehmigen.

Die Aktivierung unterstützt die differentielle Privatsphäre, wenn sie aktiviert ist, und respektiert die Regeln und Budgets für differentielle Privatsphäre.

Um Daten von einem Teilnehmer in einer anderen Cloudregion zu aktivieren, müssen Sie die Cloud-übergreifende automatische Ausführung aktivieren.

Anbieter- und Verbraucheraktivierung

Sie können einen Clean Room so konfigurieren, dass Vorlagenergebnisse im Snowflake-Konto des Anbieters oder Verbrauchers gespeichert werden. Sowohl der Anbieter als auch der Verbraucher müssen der Aktivierung von Daten außerhalb des Clean Room zustimmen.

Die Aktivierung wird mit einer speziellen Aktivierungsvorlage durchgeführt. In der Clean Room UI kann eine Analysevorlage mit einer Analysevorlage verknüpft werden, und der Benutzer kann die Analysevorlage ausführen und die Ergebnisse ansehen, dann die Ergebnisse der zugehörigen Aktivierungsvorlage ausführen und aktivieren. Der von Snowflake zur Verfügung gestellte „Audience Overlap & Segmentation“-Ablauf übernimmt dies.

Eine Aktivierungsvorlage muss nicht mit der zugehörigen Analysevorlage identisch sein. Die Aktivierungsvorlage ist oft eine Teilmenge der Analysevorlage.

Unterstützte Vorlagen

Die folgenden Vorlagen unterstützen die Anbieter- und Verbraucheraktivierung:

Unterstützte Kombinationen

Die Aktivierung kann entweder durch den Anbieter oder den Verbraucher erfolgen. Sie können verschiedene Kombinationen von vom Anbieter und Verbraucher durchgeführten Analysen mit der Verbraucher- und Anbieteraktivierung kombinieren. (Erfahren Sie mehr über vom Anbieter durchgeführte Analysen.)

Die folgenden Kombinationen werden unterstützt:

Anbieter-Aktivierung

Verbraucheraktivierung

Vom Anbieter durchgeführt

Vom Verbraucher durchgeführt

Ergebnisse

Die Ergebnisse der Anbieteraktivierung werden im Konto des Anbieters in der Tabelle SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.CONSUMER_DIRECT_ACTIVATION_SUMMARY gespeichert.

Die Ergebnisse der Verbraucheraktivierung werden in dem Konto des Verbrauchers in der Tabelle SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY gespeichert.

Siehe Ergebnisse anzeigen, um zu erfahren, wie Sie die Daten lesen können.

Implementierung der Anbieter- oder Verbraucheraktivierung

Setup

1. Clean Room erstellen oder betreten

Wenn Sie einen Clean Room erstellen oder ihm beitreten, geben Sie im Schritt Configure Analysis & Query unter Activation Settings an, welche Spalten zu den Ergebnissen hinzugefügt werden sollen, die für Ihr Konto aktiviert wurden.

2. Vorlage ausführen und Ergebnisse aktivieren

Um die mit Ihrer Analyse verbundene Aktivierung auszuführen, führen Sie die folgenden Schritte aus:

  1. Führen Sie Ihre Analyse durch.

  2. Nachdem Sie eine Analyse durchgeführt haben, wählen Sie Results » Activate.

  3. Wählen Sie unter Activation Hub den Namen des Anbieter- oder Verbraucherkontos, für das Sie die Aktivierung vornehmen möchten.

  4. Geben Sie spezifische Informationen für die Aktivierungsvorlage an, wie z. B. beschreibende Segmentierungsnamen oder die Auswahl von Aktivierungsspalten.

  5. Geben Sie einen Segmentnamen an: Dies ist eine beliebige Zeichenfolge, die zur Identifizierung einer Gruppe von Ergebnissen verwendet wird. Sie können für jede Aktivierung eine andere Zeichenfolge angeben, um die Ergebnisse jeder Ausführung separat zu gruppieren, oder Sie können denselben Segmentnamen für mehrere Ausführungen mit Eingabevariationen verwenden, wenn Sie diese Ergebnisse kombinieren möchten.

  6. Wählen Sie Push Data aus.

  7. Im nächsten Abschnitt erfahren Sie, wie Sie die aktivierten Ergebnisse anzeigen können.

Ergebnisse der Anbieter- und Verbraucheraktivierung anzeigen

Speicherort und Format der Aktivierungsergebnisse

Alle Ergebnisse der Anbieteraktivierung werden an eine von Snowflake bestimmte Tabelle angehängt. Jede Zeile in der Tabelle wird einer Zeile im Abfrageergebnis zugeordnet. Zusätzliche Abfrageergebnisse werden an die Tabelle angehängt. Sie können verschiedene Ausführungen anhand der Spalte ACTIVATION_ID, die pro Aktivierung eindeutig ist, und der Spalte SEGMENT, die vom Aufrufer für jede Aktivierungsausführung angegeben wird, unterscheiden.

  • Die Aktivierungsergebnisse des Anbieters werden unter SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY im Konto des Anbieters gespeichert.

  • Die Ergebnisse der Verbraucheraktivierung werden unter SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.CONSUMER_DIRECT_ACTIVATION_SUMMARY im Konto des Verbrauchers gespeichert.

Diese Tabellen enthalten die folgenden Spalten:

USER_ID:

Eine Zeile mit Ergebnissen im JSON-Format, wobei die Schlüssel die Spaltennamen und die Werte die Werte für diese Spalte in dieser Zeile sind. Das Objekt enthält außerdem eine Spalte für jedes in der Vorlage übergebene Argument.

ACTIVATION_ID:

Eine eindeutige ID für jede Anfrage. Die ID wird bei einer erfolgreichen Aktivierungsanfrage zurückgegeben. Sie können nach dieser Spalte filtern, um alle Ergebnisse für dieselbe Aktivierungsausführung zu erhalten, oder nach SEGMENT filtern, wenn Sie denselben Segmentnamen über mehrere Ausführungen hinweg wiederverwenden. Dies entspricht der Abfrage-ID, die von submit_analysis_request oder run_activation zurückgegeben wird.

CLEANROOM_NAME:

Name des Clean Room, in dem die Abfrage durchgeführt wurde.

CONSUMER:

(Nur Anbieteraktivierung) Der Verbraucher, der diese Aktivierung genehmigt hat.

PROVIDER:

(Nur Verbraucheraktivierung) Der Anbieter, der diese Aktivierung genehmigt hat.

SEGMENT:

Ein beliebiger Zeichenfolgenwert, den Sie zuweisen, wenn Sie die Aktivierung ausführen. Diese Spalte ermöglicht es Ihnen, die Ergebnisse mehrerer Abfragenausführungen zu verknüpfen.

TIMESTAMP:

Wann die Aktivierung ausgeführt wurde.

Beispiel für die Anbieteraktivierung

SELECT * FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY WHERE segment = 'my_segment';

                             USER_ID                          |   CLEANROOM_NAME |   SEGMENT  | CONSUMER |          TIMESTAMP      |  ACTIVATION_ID
"{""AGE_BAND"":55,""ITEM_COUNT"":2328,""STATUS"":""MEMBER""}" |  test activation | my_segment | ABC1234  | 2025-04-01 16:27:14.068 | cleanroomactivationdataanalysisresults20250401231728469
"{""AGE_BAND"":20,""ITEM_COUNT"":88,""STATUS"":""PLATINUM""}" |  test activation | my_segment | ABC1234  | 2025-04-01 16:27:14.068 | cleanroomactivationdataanalysisresults20250401231728469
"{""AGE_BAND"":80,""ITEM_COUNT"":18,""STATUS"":""GOLD""}"     |  test activation | my_segment | ABC1234  | 2025-04-01 16:27:14.068 | cleanroomactivationdataanalysisresults20250401231728469
...

Anbieter- oder Verbraucheraktivierungsergebnisse lesen

Führen Sie den entsprechenden SQL-Befehl aus, um die für Ihr Snowflake-Konto aktivierten Ergebnisse anzuzeigen:

Ergebnisse der Anbieteraktivierung anzeigen

SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   [WHERE segment = <SEGMENT_NAME>] [AND activation_id = <ACTIVATION_ID>];
Copy

Ergebnisse der Verbraucheraktivierung anzeigen

SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.CONSUMER_DIRECT_ACTIVATION_SUMMARY
   [WHERE segment = <SEGMENT_NAME>] [AND activation_id = <ACTIVATION_ID>];
Copy

Jede Datenzeile wird in der Spalte USER_ID zu einem Objekt zusammengefasst. Sie können die Ergebnisse vereinfachen, indem Sie eine Abfrage wie die folgende verwenden:

-- Assuming columns AGE_BAND, STATUS, and ITEM_COUNT
SELECT
  item:"AGE_BAND",
  item:"STATUS",
  item:"ITEM_COUNT"
FROM (SELECT parse_json(user_id)
      AS item
      FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
      WHERE segment = $segment_name)
ORDER BY item:"AGE_BAND", item:"STATUS" ASC
LIMIT 20 ;
Copy

Sehen Sie sich die letzten 10 Ergebniszeilen in Snowsight an:

  1. Öffnen Sie Snowsight und navigieren Sie zu Data » Database.

    • Für die Anbieteraktivierung navigieren Sie zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.

    • Für die Verbraucheraktivierung navigieren Sie zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » CONSUMER_DIRECT_ACTIVATION_SUMMARY.

  2. Wählen Sie Data Preview aus.

Drittanbieter-Aktivierung

Die Drittanbieter-Aktivierung hinterlegt Abfrageergebnisse auf dem Konto eines von Snowflake zugelassenen Drittanbieters, der einen Drittanbieter-Aktivierungskonnektor verwendet.

Die Drittanbieter-Aktivierung wird nur in der Clean Room UI unterstützt, nicht aber bei der Verwendung von benutzerdefinierten Vorlagen.

Die Aktivierung bei Verwendung der Clean Room UI wird nur unterstützt, wenn das Konto für Clean Rooms die Aktivierung zulässt.

Der Clean Room-Administrator muss die Umgebung für die Unterstützung von Aktivierungskonnektoren von Drittanbietern konfigurieren, die zulässigen Konnektoren auswählen und sie konfigurieren, bevor sie in einem Clean Room verwendet werden können.

Die Drittanbieter-Aktivierung unterstützt sowohl von Verbrauchern als auch von Anbietern durchgeführte Analysen.

Unterstützte Vorlagen

Die folgenden Vorlagen unterstützen die Drittanbieter-Aktivierung:

  • Audience Overlap & Segmentation

  • SQL-Abfrage

Implementierung der Drittanbieter-Aktivierung

  1. Erstellen Sie den Clean Room oder treten Sie ihm bei: Wenn Sie den Clean Room erstellen oder ihm beitreten, geben Sie im Schritt Configure Analysis & Query unter Activation Settings an, welche Spalten zu den Ergebnissen hinzugefügt werden sollen, die für Ihr Konto aktiviert wurden.

  2. Aktivieren Sie die Ergebnisse:

    1. Führen Sie Ihre Analyse durch.

    2. Nachdem Sie eine Analyse durchgeführt haben, wählen Sie Results » Activate.

    3. Wählen Sie unter Activation Hub den Namen des Drittanbieters, den Sie aktivieren möchten.

    4. Liefern Sie spezifische Informationen für den Anbieter. Dies kann die Angabe von beschreibenden Namen oder die Auswahl der zu aktivierenden Spalten sein. Die QuickInfos auf der Seite sollten zusätzliche Informationen zu diesem Anbieter enthalten.

    5. Wählen Sie Push Data aus.