Verwenden der Entwickler-APIs, um die Ergebnisse zur Aktivierung an den Anbieter zu senden¶

Manchmal möchten die Teilnehmer, dass der Verbraucher eine Analyse durchführt und die Ergebnisse dann zur Aktivierung an den Anbieter zurückschickt. Unter diesem Thema wird beschrieben, wie Sie die Entwickler-APIs verwenden, um Ergebnisse vom Verbraucher an den Anbieter zu senden.

Der grundlegende Ablauf für die Aktivierung eines Anbieters ist folgender:

Anbieter:

Erstellt eine Vorlage, die der Verbraucher ausführen kann, um Ergebnisse zur Aktivierung an den Anbieter zu senden.
Verknüpft die samooha_by_snowflake_local_db.library.temp_public_key-Tabelle mit dem Reinraum.

Verbraucher:

Führt die Vorlage des Anbieters aus, um die Ergebnisse an das Snowflake-Konto des Anbieters zu senden.

Anbieter:

Zeigt die Ergebnisse in einer Tabelle in seinem Snowflake-Konto an.

Erstellen einer Vorlage für die Anbieteraktivierung¶

Eine Vorlage zum Aktivieren von Ergebnissen ist ähnlich wie eine Vorlage zum Ausführen einer Analyse. Sie wird zum Beispiel mit dem Befehl provider.add_custom_sql_template wie eine Analysevorlage zum Reinraum hinzugefügt. Eine Aktivierungsvorlage weist jedoch die folgenden wichtigen Unterschiede auf:

Der Name der Aktivierungsvorlage muss mit der Zeichenfolge activation beginnen. Eine Aktivierungsvorlage mit dem Namen activation_my_template erfüllt zum Beispiel die Anforderung.
Die Aktivierungsvorlage muss eine Tabelle mit einem Namen erstellen, der bestimmten Konventionen entspricht und den Tabellennamen explizit zurückgibt.

Definieren der Tabelle in einer Aktivierungsvorlage¶

Um die Aktivierungsergebnisse im Reinraum zu halten, muss jede Aktivierungsvorlage eine Tabelle erstellen. Für diese Tabelle gibt es zwei Anforderungen:

Der Name der Tabelle muss mit der Zeichenfolge cleanroom.activation_data_ beginnen. Eine Tabelle mit dem Namen cleanroom.activation_data_analysis_results erfüllt zum Beispiel die Anforderung.
Der Teil der Vorlagendefinition, der die Tabelle erstellt, muss die Zeichenfolge zurückgeben, die an cleanroom.activation_data_ angehängt wurde, um den Namen der Tabelle zu bilden. Wenn der Tabellenname zum Beispiel cleanroom.activation_data_analysis_results lautet, muss die Zeichenfolge analysis_results zurückgegeben werden.

Im Folgenden finden Sie ein Beispiel dafür, was in der Vorlagendefinition enthalten sein muss, um eine Tabelle zu definieren und zu exportieren:

BEGIN
  CREATE OR REPLACE TABLE cleanroom.activation_data_analysis_results AS
    SELECT * FROM identifier({{ my_table[0] }})
  RETURN 'analysis_results';
END;

Copy

Weitere Informationen über den Aufruf des Befehls provider.add_custom_sql_template, um eine Aktivierungsvorlage zu einem Reinraum hinzuzufügen, finden Sie unter Snowflake Data Clean Rooms: Anbieter-API-Referenzhandbuch.

Verknüpfen der erforderlichen Tabelle¶

Um die Anbieteraktivierung zu ermöglichen, muss der Anbieter die Tabelle samooha_by_snowflake_local_db.library.temp_public_key mit dem Reinraum verknüpfen, bevor er sie für den Verbraucher freigibt. Um zum Beispiel die gewünschte Tabelle mit dem Reinraum my_activation_cleanroom führen Sie Folgendes aus:

CALL samooha_by_snowflake_local_db.provider.link_datasets(
    'my_activation_cleanroom',
    ['samooha_by_snowflake_local_db.library.temp_public_key']);

Copy

Sie können auch einen einzigen Aufruf verwenden, um die gewünschte Tabelle zu verknüpfen, wenn Sie Ihre anderen Tabellen und Ansichten verknüpfen.

Ergebnisse an den Anbieter zurücksenden¶

Der Verbraucher sendet die Ergebnisse an den Anbieter zurück, indem er den Befehl consumer.run_activation aufruft, um die Aktivierungsvorlage auszuführen, was der Ausführung des Befehls consumer.run_analysis ähnelt. Der Unterschied ist das zweite Argument, das eine Zeichenfolge angibt, mit der der Anbieter den Inhalt der Aktivierung identifizieren kann.

Der Verbraucher kann zum Beispiel Folgendes aufrufen:

CALL samooha_by_snowflake_local_db.consumer.run_activation(
  'activation_clean_room',
  'my_activation_segment',
  'activation_custom_template',
  ['consumer_source_table'],
  ['provider_source_table'],
  object_construct(
    'dimensions', ['p.CAMPAIGN'],
    'where_clause', 'p.EMAIL=c.EMAIL'
));

Copy

Weitere Informationen über die Syntax des Befehls consumer.run_activation finden Sie unter Snowflake Data Clean Rooms: Verbraucher-API-Referenzhandbuch.

Aktivierte Ergebnisse als Anbieter anzeigen¶

Nachdem der Verbraucher die Ergebnisse für den Anbieter aktiviert hat, kann der Anbieter diese Ergebnisse in seinem Snowflake-Konto (nicht in der Reinraumumgebung) anzeigen. Beachten Sie, dass sich der Anbieter in seiner Reinraumumgebung anmelden muss, bevor er sich an seinem Snowflake-Konto anmelden kann, um die Ergebnisse zu sehen.

Weitere Informationen finden Sie unter Aktivierte Ergebnisse anzeigen.