Batch Segment Config サービス
注:
このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。
警告
メンバーのバッチ セグメント構成のまたはbyte制限を変更するnum_line必要がある場合は、ページの情報セクションの指示に従って、EPIC: DMP-376 の下にチケットを提出してください。 変更を続行するには、Ewa Maciukiewicz から承認を受ける必要があります。
Batch Segment Config Service は、 Batch Segment Service の使用に関連するクライアントごとの設定を追加および変更するために使用される、管理者専用の内部 API です。 クライアントの優先ファイル形式と、その形式に対するエラー チェックの厳格さを構成できます。 使用制限を設定し、クライアントがアクセスできる他のメンバーのセグメント データを定義することもできます。
注:
ファイル形式の詳細については、「 初期 BSS アカウントのセットアップ」を参照してください。
他のメンバーのデータへのクライアント アクセス
別のメンバーのデータへのアクセスを希望するクライアントは、 カスタマー サポート ポータルを介してサポートリクエストを提出するようそのメンバーに依頼する必要があります。 たとえば、クライアント A がクライアント B のデータにアクセスする必要がある場合、クライアント B はクライアント A のアクセスを承認するサポート要求で送信する必要があります。
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
created_on |
string | このオブジェクトが作成された時刻。 フィルター: はい 並べ替え方法: はい |
daily_byte_limit |
int | クライアントがアップロードする可能性がある 1 日あたりの最大バイト数。 一般的なガイド: 10G (詳細形式で約 280M 行) 注: これを上げたいクライアントは、データ制限を適切に使用していることを確認する必要があります。つまり、毎日完全なデータベース ダンプではなく、diff ファイルを送信しています。 データをスマートに使用しないクライアントは、データ送信を最小限に抑えるためにアップロード プロセスをリファクタリングする必要があります。 必須: POST フィルター: はい 並べ替え方法: はい |
daily_num_lines_limit |
int | クライアントがアップロードする 1 日あたりの最大行数。 必須: POST フィルター: はい 並べ替え方法: はい |
default_domain |
string | ユーザー ID を追加する内部データベース ドメイン。 既定値は 'userdata' に設定されています。 ほとんどのクライアントは現時点では 1 つのドメインに存在するため、通常は使用されません。 必須: POST フィルター: はい 並べ替え方法: はい |
default_expiration |
int | このクライアントがセグメントの有効期限を切ることを望む時間 (分単位)。 これは、セグメント データ ファイル内の有効期限設定によってオーバーライドされます。 の 0 値は、セグメントの有効期限が切 -1 れないことを示します。このユーザーがこのセグメントから削除されることを示します。 注: 何らかの理由で、 POST 要求が有効な入力として 0 を拒否し、0 以外の値を持ち、 POST 値として 0 を PUT 持つ同じファイルをもう一度拒否する必要があります。 必須: POST フィルター: はい 並べ替え方法: はい |
external_member_uid |
int | "use_external_uids" が の場合は true、クライアントが使用するユーザー ID を持つメンバー ID を指定します。 の null 値は、クライアント独自 member_idの を使用することを意味します。 mapUID ユーザー同期を使用するメンバーに対してのみ有効です (HINT: これを使用するクライアントはごくわずかです)。 必須: POST フィルター: はい 並べ替え方法: はい |
hourly_byte_limit |
int | クライアントがアップロードする 1 時間あたりの最大バイト数。 必須: POST フィルター: はい 並べ替え方法: はい |
hourly_num_lines_limit |
int | クライアントがアップロードする 1 時間あたりの最大行数。 必須: POST フィルター: はい 並べ替え方法: はい |
id |
int | このオブジェクトの一意識別子。 フィルター: はい 並べ替え方法: はい |
last_modified |
string | このオブジェクトが最後に変更された時刻。 フィルター: はい 並べ替え方法: はい |
max_concurrent_uploads |
int | クライアントが一度に実行するアップロードの最大数。 一般的なガイド: 1 必須: POST フィルター: はい 並べ替え方法: はい |
member_id |
int | 構成を編集しているクライアントのメンバー ID。 必須: PUT 、POST フィルター: はい 並べ替え方法: はい |
member_segment_access |
オブジェクトの配列 | クライアントがアクセスできるセグメントを持つメンバー ID。 (ユーザーを他のユーザーの代わりにセグメントに追加する場合は、これを使用します)。 詳細については、以下の 「メンバー セグメント アクセスアレイ 」セクションを参照してください。 必須: POST フィルター: いいえ 並べ替え方法: いいえ |
num_error_log_lines |
int | エラー ログに表示される行数。 一般的なガイド: 200 未満 必須: POST フィルター: はい 並べ替え方法: はい |
num_invalid_before_error |
int | エラーを通知する前に受け入れる無効な行の数。 この制限に達すると、ジョブは強制終了されますが、最初のエラーが発生する前に追加されたすべてが実行されます。 一般的なガイド: クライアントのファイルの 50%。 不明な場合は、これを非常に高く設定します。 必須: POST フィルター: はい 並べ替え方法: はい |
segment_fields |
配列 | ファイル形式のブロックに SEG 関連付けられたセグメントの一覧。 詳細については、「 Batch Segment Service」を参照してください。 必須: POST フィルター: はい 並べ替え方法: はい |
separator_1 |
string | Batch Segment Service によって区切り記号として使用される文字または文字列。 必須: POST フィルター: はい 並べ替え方法: はい |
separator_2 |
string | Batch Segment Service によって区切り記号として使用される文字または文字列。 |
separator_3 |
string | Batch Segment Service によって区切り記号として使用される文字または文字列。 必須: POST フィルター: はい 並べ替え方法: はい |
separator_4 |
string | Batch Segment Service によって区切り記号として使用される文字または文字列。 必須: POST フィルター: はい 並べ替え方法: はい |
separator_5 |
string | Batch Segment Service によって区切り記号として使用される文字または文字列。 必須: POST フィルター: はい 並べ替え方法: はい |
use_external_uids |
bool | クライアントが、ある名前から別の名前へのマッピングに外部ユーザー ID を使用するかどうか。 を使用するには、このフィールドを に設定しますtrueexternal_member_uid。 必須: POST フィルター: はい 並べ替え方法: はい |
use_specific_geo |
string | 既定では を に NULL 設定します。 このフィールドは、2013 年に Batch Segment の機能強化を行う必要がなくなりました。 システムはすべての geo をチェックします。 ユーザーが複数の geo に存在する場合は、存在する各 geo 内の適切なセグメントに追加されます。 必須: POST フィルター: はい 並べ替え方法: はい |
メンバー セグメント アクセス配列
| フィールド | 種類 | 説明 |
|---|---|---|
segment_owner_member_id |
int | セグメント所有者のメンバー ID。 フィルター: いいえ 並べ替え方法: いいえ |
例
特定のメンバーの構成を参照してください
$ curl -b cookies "https://api.appnexus.com/batch-segment-config?member_id=1226"
{
"response": {
"status": "OK",
"count": null,
"start_element": 0,
"num_elements": 100,
"batch_segment_upload_config": {
"member_id": 1226,
"id": 2,
"hourly_byte_limit": 3500000000,
"daily_byte_limit": 3500000000,
"max_concurrent_uploads": 1,
"num_error_log_lines": 50,
"num_invalid_before_error": 1000000000,
"separator_1": ";",
"separator_2": ",",
"separator_3": ":",
"separator_4": "\t",
"separator_5": "^",
"default_domain": "userdata",
"use_specific_geo": null,
"segment_fields": "[SEG_ID,EXPIRATION,VALUE]",
"last_modified": "2012-06-01 15:10:20",
"created_on": "0000-00-00 00:00:00",
"default_expiration": 0,
"use_external_uids": false,
"external_member_uid": null,
"member_segment_access": [
{
"segment_owner_member_id": 23
}
]
}
}
}