TROCCO ACTION for Snowflake - LINE 広告オーディエンス連携マニュアル

Prev Next
This content is currently unavailable in Korean. You are viewing the default (Ja - 日本語) version.

概要

TROCCO ACTION for Snowflakeは、Snowflake上に保存されているユーザー データをLINEやXといった、主要なメディア広告プラットフォームへ自動的に連携するためのソリューションです。このアプリケーションは、データ連携を合理化して、収益化のための取り組みを最適化し、マーケティングの効率を高めるのに役立ちます。
このマニュアルでは、セットアップから進んだ利用方法まで、TROCCO ACTION for Snowflakeの使用に関する詳細な手順を説明します。
TROCCO ACTION for SnowflakeはSnowflake Native Applicationを基礎としたアプリケーションで、次のように設計されています（主な機能）:

image

  • シームレスなデータ統合： Snowflakeに構築済みのユーザーデータを広告プラットフォームに簡単に統合できます。特定のテーブルとフィールドを選択したり、データ全体を連携したりして、キャンペーンのニーズに合わせた正確で効率的なデータ転送を実現できます。
  • 自動およびスケジュールされた同期： 定期的にデータを自動同期できる機能により継続的な手動でのデータ連携を簡素化し、オペレーションなしでデータを最新の状態に保ちます。さらに、必要に応じて1回限りの統合をしたり、スケジュールされたジョブを一時停止または削除したりする柔軟性も提供します。

サポート済みの連携先

現在TROCCO ACTION for Snowflakeがサポートしている連携先については次の通りです。

  • LINE広告オーディエンス： Snowflakeに構築済みのユーザーデータをLINE広告プラットフォームへ連携し、自動的にカスタムオーディエンスを作成する機能
  • LINEオーディエンス： Snowflakeに構築済みのLINEユーザーのデータをLINEプラットフォームへ連携し、自動的にカスタムオーディエンスを作成する機能

LINEオーディエンスを利用するには、本アプリケーションとは別に、LINE Audience Connector - TROCCO ACTION for Snowflakeが必要です。

TROCCO ACTION for Snowflake のインストール

TROCCO ACTION for Snowflakeは、UI、接続、同期管理を提供します。基本的には、マーケットプレイスの手順にしたがって、Snowflakeマーケットプレイスからリストをインストールします。
TROCCO ACTION for Snowflakeを使用する前に、次の要件を満たしていることを確認してください。

要件

APIアクセスキー・APIシークレットキー

本アプリケーションを利用するためには、LINE広告APIを利用できる状態になっている必要があります。LINE広告APIの利用申請を行い、承認後、LINE広告マネージャーでAPIアクセスキーとAPIシークレットキーを取得してください。
まだLINE広告APIを利用できない場合、APIの利用申請を行い、承認後、LINE広告マネージャーでAPIアクセスキーとAPIシークレットキーを取得してください。

データ

  • Snowflakeデータベースには、有効なメールアドレスまたは電話番号フィールドを含むユーザーデータが含まれている必要があります。本アプリケーションでこれらのハッシュ化が可能なため、事前にハッシュ化する必要はありません。
  • IFA(Identifier for Advertisers) も利用可能です。

インストール

  1. マーケットプレイスの手順にしたがって、Snowflakeマーケットプレイスからリストをインストールします。
  2. TROCCO ACTION for Snowflakeを開き、初期手順を完了してアプリをアクティブ化します：

    1. 必要な権限を付与する
      image

    2. 外部アクセス統合を許可する
      image

    3. APIアクセストークンを登録する
      image

      image

  3. 上記のプロセスが完了したらユーザーデータをリファレンスとして入力します
    image
    1. ユーザー データが保存されているテーブルまたはビューを、[権限]タブ＞[オブジェクトへの権限]セクションで設定（追加ボタンをクリック）して、TROCCO ACTION for Snowflakeが参照できるようにします。
    2. TROCCO ACTION for Snowflakeはこれらを参照し、データ連携に使用します。

インストールのチェック

アプリケーションのインストールが完了したら、アプリケーションを実行してログインします。ログイン後に表示される最初のページは、下の画像のようになります。「アクセス可能なテーブル」と「APIトークン」の2つのセクションが表示されます。

image

この画面では、アプリケーションのインストール時に設定した詳細を確認できます。

  • アクセス可能なテーブル： データ連携に使用可能なテーブルのリストであり、このアプリケーションが読み取ることができるデータの一覧です。
  • APIトークン：「Check Connectivity」ボタン（APIとの通信確認を意味します）を押すことで、LINE広告APIなどの広告プラットフォームが提供するAPIへの接続を確認できます。APIへの接続が正しければ、すぐにデータ連携を開始できます。エラーメッセージが表示される場合は、APIトークンが正しいか有効かを確認してください。

これらの設定は、Snowsightのアプリケーションページでのみ変更できます。APIトークンについては、完全に単一のため、複数のタスク スケジュールが作成されても、常にSnowsightのアプリ ページから登録されたトークンが使用されます。

データ連携を実行する

これでアプリケーションがインストールされました。このセクションでは、データ連携する方法を段階的に説明します。

データ連携の大まかな流れは以下の通りです。

  1. 連携したいデータを選択する
  2. データ連携の内容を設定する（名前、スケジュール、更新方法など）
  3. データ連携するフィールドを選択する

LINE広告オーディエンスを新規作成する

  1. 左側のサイドバー メニューの「Configure Action」に移動します。ここでデータ連携を設定・作成します。
    image
  2. 広告プラットフォームに送信するデータベース、スキーマ、テーブル、およびフィールドを選択し、「Preview」をクリックしてデータを確認します。
    image
  3. データ テーブルの上にある[Send]ボタンをクリックすると、データ テーブルにダイアログが表示されます。
    image
  4. 表示されたフォームに次のように入力します。
  • Title（必須）:[0-9-a-zA-Z-_]で構成されるタイトル
  • Schedule（オプション）: cron形式のスケジュール
  • Activate Scheduling?（オプション）: チェックすると、スケジュールに基づいて定期的な同期が有効になります
  • Where would you like to sync?（必須）: Line Ads Audienceを選択します
  • Ad Account ID（必須）: LINE広告のアカウントIDを入力します。LINE広告マネージャーに表示されます。
  • Upload Type（必須）: オーディエンスを作成するのに使用したいものを選択します。たとえば、Emailを使ってオーディエンスを作成したい場合、Emailを選択します。
  • Operation Type（必須）:「create」を選択します
  • Name of the audience（必須）: 120文字以内の好きな名前。これはLINE広告マネージャーのオーディエンス管理画面に表示されます。
  • Get Email and Phone hashed and sync（必須）: オーディエンスを作成するのにメールアドレスまたは電話番号を使用する場合、Trueを選択するとSHA256でこれらの項目をハッシュ化してオーディエンスを作成します（ハッシュ化してAPIへデータ送信する）。Falseを選択した場合はハッシュ化しません。また、Upload TypeでIFAを選択している場合、このオプションは表示されません。
  • Which fields to use for integration（必須）: オーディエンスを作成するのに使用したい項目が、選択したテーブルのどのフィールドかを選択します（オーディエンスを作成するのにどのフィールドを使いたいか選択する）

このフォームの完全な例は次の通りです。

image

  1. 「Submit」ボタンをクリックします。送信後すぐにデータの同期が開始されるので、LINE広告マネージャーやLINE広告APIなどでカスタマイズされたオーディエンスが正常に作成されたことを確認します。

LINE広告オーディエンスにユーザーを追加する

データを選択し、タイトルなどの基本情報を入力するところまでは、オーディエンスを作成するときと同じです。既存のオーディエンスを更新するには、次のようにフォームに入力します。

  • Upload type（必須）: "add" を選択する
  • Select an existing audience（必須）: 更新したいオーディエンス名を選択する
  • Get Email and Phone hashed and sync（必須）: 選択したフィールドをハッシュ化したい場合、Trueを選択します。そうでない場合はFalseを選択します。
  • Submitボタンをクリックします

このフォームの完全な例は次の通りです。

image

異なるタイプのデータで作成されたオーディエンスを、異なるタイプのデータで更新できません。たとえば、メールアドレスで作成されたオーディエンスを電話番号を使って更新できません。

LINE広告オーディエンスのユーザーを入れ替える

データを選択し、タイトルなどの基本情報を入力するところまでは、オーディエンスを作成するときと同じです。既存のオーディエンスのユーザーをすべて削除し、新しく入れ替えるには、次のようにフォームに入力します。

  • Upload type（必須）: "replace" を選択する
  • Select audience group（必須）: 更新したいオーディエンス名を選択する
  • Get Email and Phone hashed and sync（必須）: 選択したフィールドをハッシュ化したい場合、Trueを選択します。そうでない場合はFalseを選択します。
  • Submitボタンをクリックします

このフォームの完全な例は次の通りです。

image

異なるタイプのデータで作成されたオーディエンスを、異なるタイプのデータで更新できません。たとえば、メールアドレスで作成されたオーディエンスを電話番号を使って更新できません。

連携をスケジュールする

同期をスケジュールする場合は、上のフォームでスケジュールを有効にします（Activate scheduling ?チェックボックスをクリックします）。フォームに入力した情報が、Snowflakeタスクとしてスケジュールされます。

現在、スケジュールのエントリーはCron形式をサポートしていますが、タイムゾーンをサポートしていません。UTCでスケジュールを作成してください。（例： 月曜日の午前9:05に連携したい場合は「5 0 * * MON」）

スケジュールを管理する

「Scheduled Action」の画面ではスケジュールされたデータ連携の一覧や現在の状態を確認するだけでなく、それらを停止/再開/削除できるため、変化する要件やメンテナンス期間に柔軟に対応できます。以下のサブセクションでは、作成したスケジュールを編集（停止/再開/削除）する方法について説明します。

スケジュールを停止する

特定のデータ連携スケジュールを一時的に停止したい場合、そのスケジュールを停止できます。

  1. [Scheduled Action]のページへ移動します。設定したデータ連携スケジュールの一覧がリストされます。
  2. 変更する同期を選択し、[Change?]フィールドをダブルクリックします（ドロップダウンが表示されます）。
  3. [Change?]フィールドで、ドロップダウンから[SUSPEND]を選択します。
  4. 選択したタスクの状態を変更するには、[Apply]をクリックします。

以下は、同期を一時停止する方法の完全な例です。上記の手順を完了したら、表の右上にある更新ボタンをクリックして状態を確認できます。

image

複数のデータ連携スケジュールを最大5件まで一括して更新も可能です。

スケジュールを削除する

スケジュールが不要になった場合、そのスケジュールを削除できます。

  1. [Scheduled Action]のページへ移動します。
  2. 変更する同期を選択し、[Change?]フィールドをダブルクリックします（ドロップダウンが表示されます）。
  3. [Change?]フィールドで、ドロップダウンから[DROP]を選択します。
  4. 選択したタスクの状態を変更するには、[Apply]をクリックします。

スケジュールを再開する

Suspend状態のスケジュールを再開できます。

  1. [Scheduled Action]のページへ移動します。
  2. 変更する同期を選択し、[Change?]フィールドをダブルクリックします（ドロップダウンが表示されます）。
  3. [Change?]フィールドで、ドロップダウンから[RESUME]を選択します。
  4. 選択したタスクの状態を変更するには、[Apply]をクリックします。

ベストプラクティス

  • テスト ファースト： 定期的なジョブをスケジュールする前に、アドホック ジョブを使用してマッピングを検証します。
  • データの最小化： 必要なフィールドのみを選択して、データ転送コストと処理時間を削減します。

その他・注意事項など

  • [Create]を選択してデータ連携をスケジューリングした場合、設定したオーディエンス名（およびその他の設定）でオーディエンスが都度新しく作成されます。たとえば[campaign_1]という名前で毎日午前9:00の実行をスケジューリングした場合、毎日9:00すぎに[campaign_1]という名前でオーディエンスが作成され続けます。そのため、定期的な実行をされる場合は、一度スケジュールをせずにワンショットでオーディエンスを作成後、そのオーディエンスを更新し続けるスケジュールを設定してください。
  • このアプリケーションで使用したいテーブルをSnowsightなどで変更した場合、[Configure]ページにて利用可能なテーブルのリストをリフレッシュし、変更した内容が利用可能であることを確認してください。
  • 既存のタイトル名を使って新しくデータ連携を作成する際、既存のスケジュールや設定（オーディエンス名など）は新しいものに上書きされます。そのため、既存の設定内容を変更したい場合は既存のタイトル名を使って新しくデータ連携の設定をしてください。たとえば、すでにline_ads_audience_syncという名前のスケジュールがあり、新しくline_ads_audience_syncという名前でフォームからデータ連携の設定をした場合、スケジュール・オーディエンス名・IFAの設定など既存の設定はすべて新しいものに上書きされます。
  • スケジュールされたデータ連携（タスク）がエラーになった場合に通知をする機能はありません。ログなどを添付し、お問い合わせください。

トラブルシューティング

問題 考えられる原因 解決方法
LINE広告への連携が失敗する APIアクセストークンが間違っている トークンを再作成する、または正しいトークンを取得し設定を反映する
データ連携が正常に完了しない フィールドマッピングに誤りがある マッピングが正しいか確認して修正する
アクセス可能なテーブルが更新されていません アクセス可能なテーブルはキャッシュされUIに使用されます [General] ページに移動し、アクセス可能なテーブルを再読み込み（更新）します
スケジュールされたジョブがスケジュール通り実行されていません ジョブが一時停止されているか、スケジュールの設定が間違っています ジョブを再度有効にして設定を確認します
LINE広告オーディエンスのデータの不一致 メールアドレス、電話番号が見つからないか間違っている テーブルに有効なデータが含まれていることを確認してください
オーディエンスリストがフォームに表示されない APIアクセストークンが間違っている、または広告アカウントIDに誤りがある 接続チェックでOKだった場合、広告アカウントIDが間違いないかどうか確認してください