Bidders - レガシ BSS ファイル形式
Batch Segment Service では、さまざまな形式でセグメント データ ファイルをアップロードできます。 詳細については、以下の 例を 参照してください。
注:
BSS Avro ファイル形式で説明されている Avro 形式は、さまざまなユーザー識別子をサポートします。
このトピックで説明するメソッドは、以前は標準形式でしたが、ユーザー識別が Cookie ではなく EID (拡張 ID) とパブリッシャーファーストパーティ識別子にますます依存するため、今後非推奨になると予想されます。
ヒント
特定のファイル形式を受け入れるようにシステムを構成する方法については、アカウント担当者にお問い合わせください。
書式の概要
ファイルの各行には、1 つ UID 以上のブロック (ユーザー ID) の最小値が SEG 指定されます。 区切り記号は構成可能です。
次の表は、各行を構成するブロックと区切り記号の順序を示しています。
| Uid | | SEPARATOR1ワンセグ | | SEPARATOR2ワンセグ | | SEPARATOR4ワンセグ | | SEPARATOR2ワンセグ | | SEPARATOR5ドメイン |
UID
| 名前 | 型 | 説明 | 例 |
|---|---|---|---|
UID |
int | セグメントに追加または削除される Xandr ユーザー ID。 | 5727816213491965430 |
SEG ブロック
ブロックは SEG 、ユーザーが追加または削除されるセグメントを記述し、セグメント ID やユーザー定義セグメント コードなどのデータが含まれます。
次のようにブロックを SEG 構築します。
| | SEG_FIELD | SEPARATOR3SEG_FIELD |
SEG_FIELD ブロック
次の表に、ブロックに含まれる可能性のある値を SEG_FIELD 示します。 既定値が存在する場合は、特に指定がない限り適用されます。 各 SEG ブロックは規則的である必要があります。つまり、含めるために選択したすべてのフィールドが必要です。 たとえば、フィールドを含めていても特定の VALUE ユーザーの値がない場合は、値として 0 を使用する必要があります。
| 名前 | 型 | 説明 | 既定値 | 例 |
|---|---|---|---|---|
SEG_ID |
int | Xandr セグメント ID。 | これは、セグメントの作成時にシステムによって生成されます。 | 1234567890 |
SEG_CODE |
string | セグメントのユーザー定義名。 両方を含めるかSEG_ID含めず、両方を含SEG_CODEめないようにすることもできます。 |
"18-35_autobuy" |
|
EXPIRATION |
int | の値から始まるセグメントの TIMESTAMP有効期間。 分単位で指定します。 の 0 値は、許可される最大 180 日後にユーザーがセグメント内で期限切れになることを意味します -1 。これは、ユーザーがこのセグメントから削除されることを意味します。 |
既定値は、セグメントの作成時にセグメント レベルで指定されます。 存在しない場合は、Batch Segment API 構成設定が使用されます。 このフィールドを使用すると、既定値がオーバーライドされます。 | 1440 |
TIMESTAMP |
int | セグメントを有効にする時刻。 UNIX タイムスタンプ 。2 番目のタイムスタンプまで。 タイムスタンプがより詳細に送信された場合 (たとえば、ミリ秒まで)、ユーザーはアップロード時にセグメントに適切に書き込まれません。 | 現在の時刻。 | 1278250469 |
VALUE |
int | セグメントに割り当てる数値。 | 310メモ： 許容される最大値は2147483647。 (この値を超える値が含まれている場合は、ピクセル火災が処理されないなど、予測できない動作が発生する可能性があります。したがって、ユーザーはセグメントに追加されません。それ以外の場合は処理されますが、値セットは渡されたものよりもはるかに小さくなります)。 |
|
MEMBER_ID |
int | このフィールドは、 を使用 SEG_CODE し、自分のメンバーに加えて他のメンバーのデータをアップロードする場合にのみ必要です。 |
。member_id |
958 |
DOMAIN
| 名前 | 型 | 説明 |
|---|---|---|
DOMAIN |
string | 必要に応じて、このユーザー ID に関連付けるドメインを指定できます。 |
区切り記号
各区切り記号の種類の定義については、 を参照してください。 と SEPARATOR3を除きSEPARATOR1、各区切り記号は異なる必要があります。ただし、同一である可能性があります (SEPARATOR2およびSEPARATOR4、 は同一にすることはできません)。 各区切り文字の長さは 1 文字にする必要があります。
警告
使用できない文字
次の文字は区切り文字として使用 できません 。 [ ] ( ) { } $ \ / | ? * + -
SEPARATOR1
ユーザー ID をセグメント リスト (または SEG ブロック) から分離します。 1 行に 1 つだけ存在する場合があります。 必須です。
SEPARATOR2
セグメント リスト内のセグメントを区切ります。 複数のセグメントを 1 つの に関連付けることができるため、1 UID行に多数ある場合があります。 複数のセグメントがある場合は必須です。
SEPARATOR3
各 SEG ブロック内のフィールドを区切ります。 設定する場合は、ファイルの行ごとに同じままにする必要があります (後 SEPARATOR4を除く)。 内に複数のフィールドがある場合は SEG必須です。
SEPARATOR4
この区切り記号の後に表示されるすべてのセグメントからユーザーが削除されます。 オプション。
SEPARATOR5
ユーザーは、 に DOMAIN 追加されるか、この区切り記号の直後に指定されたセットで検索されます。 オプション。
注:
モバイル デバイス ID データ フィールド
モバイル デバイスからデバイス ID を渡すには、行の末尾に SEPARATOR5 、次の表に示す番号の 1 つを渡します。 各番号は、異なるモバイル デバイス識別スキームに対応します。 このテーブルでは、 ^ が として SEPARATOR5使用されていることを前提としています。
| 区切り記号と数値 | 値 |
|---|---|
| ^3 | idfa |
| ^4 | sha1udid |
| ^5 | md5udid |
| ^7 | openudid |
| ^8 | aaid |
| ^9 | windowsadid |
| ^10 | ライダー |
| ^11 | ティファ |
| ^12 | Vida |
| ^13 | lgudid |
^6 sha1mac は 2019 年 5 月 7 日の時点で非推奨となりました。 使用しないでください。
例
次の例は、実際のユース ケースから派生したシナリオを示しています。
注:
次の例は、最初のバッチ セグメント構成で設定されたものとは異なる可能性がある区切り記号の値を示しています。 構成設定を更新する場合は、サービス チームにお問い合わせください。
例 1
クライアントは、ユーザー 12345678900987654321 をセグメント 10000 に追加し、 10001 有効期限 1440 (1 日) を指定します。 クライアントは、セグメントと からユーザー12345678900987654321を削除しています10002。10003
| フィールド | 値 |
|---|---|
UID |
Xandr ユーザー ID。 |
SEPARATOR1 |
"," |
SEPARATOR2 |
";" |
SEPARATOR3 |
":" |
SEG_FIELD |
[SEG_ID, EXPIRATION] |
12345678900987654321,10000:1440;10001:1440;10002:-1;10003:-1
例 2
クライアントは、コード"auto_intender"と"nike_shopper"既定の有効期限を持つセグメントにユーザー12345678900987654321を追加しています。 また、クライアントは、コード"bicycle_intender"と を持つセグメントからユーザー12345678900987654321を削除 (使用SEPARATOR4) しています"newbalance_shopper"。
| フィールド | 値 |
|---|---|
UID |
Xandr ユーザー ID。 |
SEPARATOR1 |
"," |
SEPARATOR2 |
";" |
SEPARATOR4 |
"\t" |
SEG_FIELD |
[SEG_CODE] |
注:
\t は、水平タブ文字を指します。 カーソルをタブ幅に移動します。 次の例では、 を使用 \t して、スペースが表示される場所を示しています。
12345678900987654321,auto_intender;nike_shopper\tbicycle_intender;newbalance_shopper
例 3
次の例では、クライアントはユーザー 12345678900987654321 をセグメント 10000 に追加し 10001 、有効期限なしで (つまり、ユーザーは許可された最大 180 日後にセグメントで期限切れになります)、ユーザーをセグメント 10002から削除しています。
| フィールド | 値 |
|---|---|
UID |
Xandr ユーザー ID。 |
SEPARATOR1 |
"\t" |
SEPARATOR3 |
"\t" |
SEG_FIELD |
[TIMESTAMP, SEG_ID, VALUE, EXPIRATION] |
注:
\t は、水平タブ文字を指します。 カーソルをタブ幅に移動します。 次の例では、 を使用 \t して、スペースが表示される場所を示しています。
12345678900987654321\t1320689131\t10000\t0\t0
12345678900987654321\t1320689131\t10001\t0\t0
12345678900987654321\t1320689131\t10002\t0\t-1
例 4
クライアントは、ユーザー "abcdefg" をセグメント 10000 に追加し、 10001 有効期限 1440 (1 日) を指定します。 クライアントは、クロスセグメントと にユーザー"abcdefg"を追加しています10002。10003
ヒント
このクライアントはメンバーとして XSEG 設定されます。
| フィールド | 値 |
|---|---|
UID |
Xandr ユーザー ID。 |
SEPARATOR1 |
"," |
SEPARATOR2 |
";" |
SEPARATOR3 |
":" |
SEG_FIELD |
[SEG_ID, EXPIRATION] |
uses_external_uids |
true |
abcdefg,10000:1440;10001:1440
abcdefg,10002:1440;10003:1440
例 5
クライアントは、コード"car_like"と"bike_like"既定の有効期限を持つセグメントにユーザー12345678900987654321を追加しています。
ヒント
このクライアントは、異なるメンバー名でを使用 SEG_CODE してアップロードします。
| フィールド | 値 |
|---|---|
UID |
Xandr ユーザー ID。 |
SEPARATOR1 |
"," |
SEPARATOR2 |
";" |
SEPARATOR3 |
":" |
SEPARATOR4 |
"\t" |
SEG_FIELD |
[MEMBER_ID, SEG_CODE] |
注:
\t は、水平タブ文字を指します。 カーソルをタブ幅に移動します。
12345678900987654321,400:car_like;500:bike_like
例 6
クライアントは、バッチ セグメント サービスを介して、モバイル ユーザー IDFA (広告主向け ID) AEBE52E7-03EE-455A-B3C4-E57283966239をセグメント 10000、10001、10002、10003 に追加しています。 この方法は、多くの場合、ID がサービスに正常に送信されたとしても、デバイス ID が実際にプラットフォームで確認されたことを意味しないため、プラットフォームでの一致率が低くなります。
注:
モバイル識別子の使用を指定する区切り記号 5 が追加されました。 値 "3" は、Apple の IDFA 値を指定します。その他の値は、上記のモバイル デバイス ID データ フィールド テーブルにあります。
| フィールド | 値 |
|---|---|
IDFA |
広告主向けの Apple ID。 |
SEPARATOR1 |
"," |
SEPARATOR2 |
";" |
SEPARATOR3 |
":" |
SEPARATOR4 |
"\t" |
SEPARATOR5 |
"^" |
SEG_FIELD |
[SEG_ID, EXPIRATION] |
注:
\t は、水平タブ文字を指します。 カーソルをタブ幅に移動します。
AEBE52E7-03EE-455A-B3C4-E57283966239,10000:1440;10001:1440;10002:-1;10003:-1^3