の設定 Openflow Connector for Amazon Ads

注釈

コネクタには、 コネクタ利用規約 が適用されます。

このトピックでは、 Openflow Connector for Amazon Ads を設定する手順について説明します。

前提条件

  1. Openflow Connector for Amazon Ads について を確認してください。

  2. Openflowを設定した ことを確認します。

認証情報を取得する

Amazon Ads管理者として、以下のアクションを実行します。

  1. Amazon Adsアカウント にアクセスできることを確認します。

  2. Amazon Ads API へのアクセスを取得し、 オンボーディングプロセスを完了します。

  3. クライアント ID とクライアントシークレットを取得します

  4. 認証付与を作成し、 さらに 更新トークンを取得します

  5. 利用可能なリージョン を確認し、広告を掲載するリージョンに基づいたリクエストに使用するベース URL を取得します。

  6. レポート構成用の プロファイル IDs をフェッチします。

Snowflakeアカウントを設定する

Snowflakeアカウント管理者として、以下のタスクを実行します。

  1. 新しいロールを作成するか、既存のロールを使用して データベース権限 を付与します。

  2. タイプを SERVICE として、新しいSnowflakeサービスユーザーを作成します。

  3. Snowflakeサービスユーザーに、前の手順で作成したロールを付与します。

  4. ステップ2のSnowflake SERVICE ユーザーを key-pair auth で構成します。

  5. Snowflakeではこの手順を強く推奨します。Openflowがサポートするシークレットマネージャ(AWS、Azure、Hashicorpなど)を構成し、公開キーと秘密キーを秘密ストアに格納します。

    注釈

    何らかの理由でシークレットマネージャを使用したくない場合は、組織のセキュリティポリシーに従って、キーペア認証に使用する公開キーと秘密キーファイルを保護する責任があります。

    1. シークレットマネージャを構成したら、その認証方法を決定します。AWS 上では、Openflowに関連付けられた EC2 インスタンスロールが推奨されます。こうすることで、他の秘密を永続化する必要がなくなるからです。

    2. Openflowで、右上のハンバーガーメニューから、このシークレットマネージャに関連付けられたParameter Providerを構成します。Controller Settings » Parameter Provider に移動し、パラメーターの値をフェッチします。

    3. この時点で、すべての認証情報を関連するパラメーターパスで参照することができるため、機密性の高い値をOpenflow内で永続化する必要はありません。

  6. 他のSnowflakeユーザーが、コネクタによって取り込まれた生の取り込みドキュメントやとテーブルへのアクセスを必要とする場合は(Snowflakeでのカスタム処理のためなど)、それらのユーザーにステップ1で作成したロールを付与します。

  7. コネクタが使用するウェアハウスを指定します。まずは最小のウェアハウスサイズから始め、複製するテーブルの数や転送するデータ量に応じて異なるサイズを試してみてください。テーブル数が大きい場合は、通常、ウェアハウスのサイズを大きくするよりも、 マルチクラスターウェアハウス を使用した方がスケーリングが向上します。

コネクタを設定する

データエンジニアとして、以下のタスクを実行してコネクタをインストールおよび構成します。

コネクタをインストールする

  1. Openflowの概要ページに移動します。Featured connectors セクションで、 View more connectors を選択します。

  2. Openflowのコネクタページでコネクタを探し、 Add to runtime を選択します。

  3. Select runtime ダイアログで、 Available runtimes ドロップダウンリストからランタイムを選択します。

  4. Add を選択します。

    注釈

    コネクタをインストールする前に、コネクタが取り込んだデータを格納するためのデータベースとスキーマをSnowflakeで作成したことを確認します。

  5. Snowflakeアカウント認証情報でデプロイメントを認証し、Snowflakeアカウントへのランタイムアプリケーションのアクセスを許可するよう求められたられたら、 Allow を選択します。コネクタのインストールプロセスは数分で完了します。

  6. Snowflakeアカウント認証情報でランタイムを認証します。

コネクタプロセスグループが追加されたOpenflowキャンバスが表示されます。

コネクタを構成する

  1. インポートしたプロセスグループを右クリックし、 Parameters を選択します。

  2. フローパラメーター の説明に従って、必要なパラメーター値を入力します。

フローパラメーター

このセクションでは、以下のパラメーターコンテキストに基づいて構成できるフローパラメーターについて説明します。

Amazon Adsソースパラメーター

パラメーター

説明

クライアント ID

Amazon Advertisingアカウントのクライアント ID

クライアントシークレット

Amazon Advertisingアカウントのクライアントのシークレット

OAuth ベース URL

アクセストークンを発行する認証サーバーの URL

可能な値:

更新トークン

Amazon Ads API 用の更新トークン

リージョン

広告データのダウンロード元の環境

可能な値:
  • NA

  • EU

  • FE

Amazon Ads宛先パラメーター

パラメーター

説明

宛先データベース

データが永続化されるデータベース。既にSnowflakeに存在している必要があります

宛先スキーマ

データが永続化されるスキーマ。既にSnowflakeに存在している必要があります

Snowflakeアカウント識別子

データが永続化されるSnowflakeアカウント名(形式: [organization-name]- [account-name])。

Snowflake認証ストラテジー

Snowflakeへの認証のストラテジー。可能な値: SPCS 上でフローを実行している場合は SNOWFLAKE_SESSION_TOKEN、 秘密キーを使ったアクセスを設定したい場合は KEY_PAIR

Snowflake秘密キー

認証に使用される RSA 秘密キー。RSA キーは、 PKCS8 標準に従って書式設定され、標準的な PEM ヘッダーとフッターを持つ必要があります。Snowflake秘密キーファイルまたはSnowflake秘密キーのどちらかが定義されている必要があります。

Snowflake秘密キーファイル

を含むファイル RSA Snowflakeへの認証に使用される秘密キー。に従ってフォーマット PKCS8 標準と標準を持つ PEM ヘッダーとフッター。ヘッダー行は で始まります -----BEGIN PRIVATE.選択する Reference asset 秘密キーファイルをアップロードするチェックボックス。

Snowflake秘密キーパスワード

Snowflake秘密キーファイルに関連付けられたパスワード

Snowflakeロール

クエリ実行時に使用されるSnowflakeロール

Snowflakeのユーザー名

Snowflakeインスタンスへの接続に使用するユーザー名

Snowflakeウェアハウス

クエリの実行に使用されるSnowflakeウェアハウス

Amazon Ads取り込みパラメーター

パラメーター

説明

レポート名

宛先テーブル名として使用するレポート名。この名前は宛先スキーマ内で一意でなければなりません。

広告製品のレポート

報告される広告製品のタイプ

可能な値:
  • SPONSORED_PRODUCTS

  • SPONSORED_BRANDS

  • SPONSORED_DISPLAY

  • SPONSORED_TELEVISION

  • DEMAND_SIDE_PLATFORM

レポート列

終了レポートに表示される列のセット。使用可能な列のリストはレポートタイプによって異なり、Amazon 広告 API ドキュメント で確認できます。たとえば、 spCampaigns レポートタイプの場合、使用可能な列のリストは スポンサードプロダクトドキュメント に記載されています。

レポートフィルター

返されたデータをトリミングするために使用されるフィルターのセット。使用可能なフィルターのリストは、レポートタイプによって異なり、 Amazon 広告 API ドキュメント で確認できます。たとえば、 spCampaigns レポートタイプの場合、使用可能なフィルターのリストは スポンサードプロダクトドキュメント に記載されています。フィルターは columnName=filterValue の形式である必要があり、値はコンマで区切る必要があります(,)。例: campaignStatus=ENABLED,PAUSED

によるレポートグループ

粒度のレベルと、レポート内のデータをどのように集計して表示するかを決定します。列ごとの使用可能なグループのリストは、レポートタイプによって異なり、 Amazon 広告 API ドキュメント で見つけることができます。たとえば、spCampaigns レポートタイプの場合、列ごとのグループ化のリストは スポンサードプロダクトドキュメント に記載されています。

レポートインジェスチョン ストラテジー

データをフェッチするモード、スナップショットまたは増分

可能な値:
  • SNAPSHOT

  • INCREMENTAL

レポート提出ウィンドウ

増分インジェスチョン中にデータをダウンロードする日数を指定します。たとえば、30日間のレポートインジェスチョンウィンドウでは、この計算日が全体的な開始日より前にない限り、増分ロードは最後に成功したインジェスチョン日の30日前からインジェスチョンを開始します。SNAPSHOT インジェスチョン戦略が使用される場合 、開始日から現在までのすべての利用可能なデータがダウンロードされるため、レポートインジェスチョンウィンドウを使用する必要はありません。

レポート プロファイル ID

特定のMarketplaceの広告アカウントに関連付けられている `プロファイル ID<https://advertising.amazon.com/API/docs/en-us/guides/get-started/retrieve-profiles>`_

レポート時間単位

日付の集計

可能な値:
  • DAILY: 各日が1行で表される

  • SUMMARY: 取り込みの期間全体が1行で表される

レポートタイプ

Amazon 広告 API は複数の レポートタイプ をサポートします。 例: sbAds および spキャンペーン。ドキュメントから reportTypeId の値をコピー し、パラメーター値に貼り付けます。

レポート開始日

インジェスチョン 開始日。日付形式は YYYY-MM-DD です。

レポートスケジュール

レポートを作成するプロセッサーのスケジュール時間。例: 8 h または 1 dh は時間、 d は日を表します。

注釈

Amazon 広告でのデータ保持 API は、レポートの種類に応じて、60日から365日の範囲の特定の時間枠です。この期間は、過去の広告パフォーマンスデータが保存され、取得のためにアクセスできます。この期間を過ぎると、古いデータは利用できなくなる可能性があります。

フローを実行する

  1. プレーンを右クリックし、 Enable all Controller Services を選択します。

  2. インポートされたプロセスグループを右クリックし、:ui:`Start`を選択します。

    コネクタがデータの取り込みを開始します。