Activating query results

Ü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 allen Fällen muss die Vorlage die Aktivierung unterstützen, und die Beteiligten sollten die Aktivierung für alle Spalten ihrer eigenen Daten, die aktiviert werden sollen, genehmigen. Datenanbieter geben an, welche Spalten ihrer Daten aktiviert werden, indem sie eine Aktivierungsrichtlinie festlegen. Weitere Informationen zu Clean Room-Richtlinien finden Sie unter Richtlinien für Clean Room-Tabellen.

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

Wichtig

Wenn sich Verbraucher und Anbieter in unterschiedlichen Cloudregionen befinden, müssen Sie Cloud-übergreifende automatische Ausführung in beiden Konten und für beide Clean Rooms 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.

Activation is implemented using a dedicated activation template. In the clean rooms UI, an activation template can be associated with an analysis template, and the user can run the analysis template, view the results, then run the associated activation template. The Snowflake-provided Audience Overlap & Segmentation flow does this.

An activation template need not be identical to any associated analysis template. The activation template is often a subset of the analysis template.

Unterstützte Vorlagen

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

Unterstützte Kombinationen

Activation can be run either by the provider or the consumer. (Learn more about provider-run analyses.)

Die folgenden Kombinationen werden unterstützt:

Anbieter-Aktivierung

Verbraucheraktivierung

Drittanbieter-Aktivierung

Vom Anbieter durchgeführt

nur UI

Vom Verbraucher durchgeführt

nur UI

Ergebnisse

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

Ergebnisse der Verbraucheraktivierung werden im Konto des Verbrauchers in der Tabelle SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.CONSUMER_DIRECT_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 ausgefü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. Provide a segment name: this is an arbitrary string used to identify a set of results from a given run. You can provide a different string for each activation to group each run’s results separately, or you can use the same segment name over multiple runs if you want to combine results.

  6. Wählen Sie Push Data aus.

  7. Informationen zum Anzeigen der aktivierten Ergebnisse finden Sie unter Ergebnisse der Anbieter- und Verbraucheraktivierung anzeigen.

Ergebnisse der Anbieter- und Verbraucheraktivierung anzeigen

Speicherort und Format der Aktivierungsergebnisse

All activation results are appended to a clean room designated table in the provider’s or consumer’s account. Each row in the table maps to a row in the query result. Results from each run are appended to the table (the table is not cleared before each run). You can distinguish between different runs by the ACTIVATION_ID column, which is unique per activation, or the SEGMENT column, which can be specified by the caller for each activation run.

Bemerkung

Die Ergebnisse der Anbieteraktivierung werden in verschlüsseltem Format in eine temporäre Tabelle in der localDB des Verbrauchers geschrieben. Die Ergebnisse werden dann in das Konto des Anbieters kopiert und vor dem Speichern entschlüsselt. Dieser zusätzliche Verschiebungs- und Entschlüsselungsschritt kann bei großen Resultsets zu Verzögerungen führen.

  • 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. Melden Sie sich bei Snowsight an.

  2. Wählen Sie im Navigationsmenü die Option Catalog » Database Explorer aus.

    • Navigieren Sie zur Anbieteraktivierung zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.

    • Navigieren Sie zur Verbraucheraktivierung zu SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » CONSUMER_DIRECT_ACTIVATION_SUMMARY.

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

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. Führen Sie eine Analyse aus und wählen Sie anschließend 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.