Digital Platform API - AWS S3 を使用したパッシブ セグメントのアップロード
Xandr メンバー アカウントが AWS S3 と統合されている場合は、Batch Segment Service に対して API コマンドをアクティブに実行する代わりに、セグメントデータを AWS S3 バケットにアップロードできます。 この統合を設定するには、アカウント サポートに問い合わせるか、 help.xandr.com で問題を提出してください。 Xandr は、初期セットアップ時にアップロード資格情報を提供します。
メンバーが統合されると、Batch Segment Service は 5 分ごとにディレクトリを /submitted
スキャンして新しいデータを探し、データ ファイル内の情報に従ってユーザーとセグメント間のリンケージを作成します。 の AWS CLI ツール https://aws.amazon.com/cli/を使用してアップロードの成功を追跡するには、次のコマンドを使用してディレクトリの内容を表示します。
AWS_ACCESS_KEY_ID=insert_your_access_key_id_received_from_xandr AWS_SECRET_ACCESS_KEY=insert_your_secret_access_key_id_received_from_xandr aws s3 ls s3://bss-insert_your_member_id-eu-north-1/
完了したジョブでは、データ ファイルが または /failed
サブディレクトリに/done
移動され、-JOB_ID
ファイル名にサフィックスが追加されます。 この情報は、Batch Segment Service API を使用して追跡目的で使用できます。
注:
S3 バケット用に構成されている現在の AWS リージョンは次のとおりです。
- us-east-2
- us-west-2
- eu-north-1
- eu-west-1
クライアント用にバケットを作成する場合は、クライアントで指定されていない限り、既定で us-east-2 の下にバケットを作成します。
要求された場合は、データアップロード用にバケットを構成した対応するリージョンの下にバケットを作成します。
要求された場合は、データアップロード用にバケットを構成した対応するリージョンの下にバケットを作成します。 リージョンごとに 1 つのバケットが許可されます。
FAQ
AWS S3 バケットにアクセスできます。 ディレクトリの /submitted
内容を表示するにはどうすればよいですか?
ディレクトリにアクセスするには、ディレクトリを /submitted
作成する必要があります。 ディレクトリの作成時にスラッシュ (/) とテキスト文字の間にスペースがないことを確認します。
または /failed
サブディレクトリを/done
作成する必要がありますか?
いいえ。 /done
または /failed
サブディレクトリが自動的に作成されます。
AWS S3 ログイン資格情報を受け取りましたが、ログインに問題が発生しています。
セキュリティを維持するために、送信された初期 AWS_ACCESS_KEY_ID
資格情報と AWS_SECRET_ACCESS_KEY
ログイン資格情報に一部の文字が含まれていない可能性があります。 セキュリティ上の目的で、資格情報は 2 つの別個の通信で送信されます。 Xandr 連絡先からログインの完全なテキスト文字列を受け取っていることを確認します。
AWS S3 に頻繁にログインしない場合、資格情報の有効期限は切れますか?
いいえ。 secret access key
と access key id
の AWS S3 の有効期限は切れない。