Digital Platform API - Batch Segment Service のベスト プラクティス

Batch Segment Service (BSS) を使用すると、外部セグメント データの一括フィードを Xandr に送信できます。 BSS を使用すると、最初、2 番目、またはサード パーティの対象ユーザー データを簡単に統合して、高度なユーザー ターゲットと ROI の向上のための動的で構成可能なセグメントを作成できます。

ベスト プラクティス

• 以下の FAQ をお 読みください。 あなたの質問がそこで答えられる可能性があります。

• 可能な限り頻繁に UID を収集することで、Cookie マッピングを最新の状態に保ち、ユーザーの一致率を高く保ちます。

  Xandr は、最も長い期間表示されていないユーザー ID がデータベースから削除され、新しいユーザー ID の余地が生じるように、UID の有効期限がローリング ベースで期限切れになります。 非常に古い UID をアップロードすると、ステータス レポートに無効なユーザー ID の割合が高くなる可能性があります。

• 可能な限りファイルをバッチ処理します (100 ~ 300 MB)。

  データは、大量の非常に小さなファイルではなく、いくつかの大きなファイルにすばやくアップロードされます。

• ファイルを削除します。

  ファイルから重複するユーザー/セグメントの組み合わせを削除することで、サイズと処理時間を削減できます。

• ファイルを圧縮します。

  Gzip は、このサービスでサポートされている唯一の圧縮方法です。 ファイルを圧縮することで、より多くのデータをより迅速にアップロードできるようになります。

• すべてのファイルに完全なセグメント メンバーシップを送信しないようにします。

  代わりに、最後のアップロード以降にセグメント メンバーシップ (差分) の変更のみを送信する必要があります。 これにより、ファイルのサイズが大幅に縮小され、アップロード プロセスが高速化されます。

• アップロード URL をすぐに使用します。

  アップロード URL を要求したら、必ず 5 分以内に使用するか、新しい URL を要求する必要があります。 古い URL は再利用できません。

• 毎日の BSS アップロード制限を最適化するには、Xandr プラットフォーム上に存在するセグメントまたは作成されたセグメントにユーザー データを送信していることを確認します。

  Xandr プラットフォームで無効、削除、または存在しないセグメントにデータを送信すると、1 日の BSS アップロードの合計制限にカウントされます。 これにより、特定のセグメントがスケーリングされない理由と、セグメントの使用率が低い理由に関する誤った仮定が発生する可能性があります。 ファイルのアップロード履歴を error_log_lines 表示するときに、データ フィールド を確認します。 アップロードで渡されたすべての無効なセグメント ID が一覧表示されます。

• ピーク時 (米国では午前 10 時から午後 10 時、ヨーロッパでは午前 10 時から午後 10 時 CET) に最大のファイルをアップロードしないでください。

  ピーク時には、より多くのファイルがキューに入り、ファイルの処理に時間がかかる場合があります。 可能であれば、アップロードを一晩で行うスケジュールを設定します。 SLA では、アップロードには最大 24 時間かかることがあります。

• 状態レポートを確認します。

  状態レポートを確認すると、エラーをキャッチして修正し、より正確なデータをアップロードできます。

• 動作したことを確認します。

  データが処理された後、Cookie ビューアーを使用して、いくつかのユーザー ID をスポットチェックできます。 1 つの地域にセグメントが表示されない場合は、もう一方の地域チェックします。ユーザーが別の地域にいる可能性があります。

  • 私たち： https://ib.nym1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID
  • Eu： https://ib.ams1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID
  • アジア： https://ib.sin1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID

• サポート要求にジョブ ID を含めます。

  技術的な問題が発生している場合は、 カスタマー サポート ポータルで要求を送信するときに、関連するすべてのジョブ ID を必ず含めておいてください。

注:

新しく作成されたセグメントにユーザーを追加する前に、約 20 分待ってください (これらのセグメントをすべてのサーバーに伝達できるようにします)。 ベスト プラクティスとして、新しいセグメントの作成を最小限に抑えたり、可能な限り既存のセグメントを再利用したり、セグメントを使用して既存のセグメント "values" 内のユーザーをさらに細分化したりしてください。 これらのプラクティスにより、ユーザーがセグメントに正常にアップロードされるようになります。 セグメントの作成の詳細については、「セグメント"values"のターゲット設定」を参照してください。

FAQ

• アップロード ジョブを完了しました。 しかし、エラーがあることがわかります。

  エラーが発生した場合は、 BSS トラブルシューティング ドキュメントを 参照して、考えられる原因を診断できます。

• データがターゲット設定に使用できるようになるまで、アップロード後どのくらいの時間がかかりますか?

  セグメント データは、ジョブがフェーズに達するとすぐにターゲット設定に 'validating' 使用できるようになります。 ジョブが に達 'completed'すると、データは完全に取り込み、ターゲット設定の準備が整います。 ジョブがヒット 'completed' するまでの時間は、ファイルのサイズとキュー内の他のファイルの数によって異なります。

  注:

  アップロードの処理には最大 24 時間 (Xandr SLA ごとに) 許可します。

• セグメント年齢のターゲット設定に対して、これらのユーザーに "発生" タイムスタンプが表示されますか?

  ファイルに TIMESTAMP フィールドを含める場合は、ユーザーとセグメントの組み合わせごとにタイムスタンプを指定します。 TIMESTAMP を含まない場合、タイムスタンプは、データがサーバー側の Cookie ストアに書き込まれた時刻になります。これは通常、状態レポートに表示される "完了時間" の前後です。

  注:

  時刻は UTC タイム ゾーンにあります。

• 米国とヨーロッパのユーザーがいる場合はどうすればよいですか?

  Xandr は、米国、ヨーロッパ、アジアに 3 つの個別の Cookie ストアを保持しています。 ただし、地域ごとに個別のファイルをアップロードする必要はありません。 Batch Segment システムは、ユーザーがどの geo に属するかを自動的に決定し、その Cookie ストア データベースにデータを送信します。 ユーザーが複数の地域に存在する場合、ユーザーが存在する各地域にデータが送信されます。

• エラー行が 999 行に制限されるのはなぜですか?

  提供される 999 エラー行は、すべてのエラーの包括的な一覧を示すものではありません。 代わりに、ファイルの問題を診断し、修正するための診断ツールとして使用する必要があります。

• ジョブ履歴全体を表示すると、一部のジョブが見つからないのはなぜですか?

  ファイルの完全なアップロード履歴を表示すると、アップロードしたすべてのファイルが含まれます。 ただし、API では、改ページを使用して応答を 100 個のオブジェクトに制限します。 API 呼び出しに次のいずれかを追加することで、追加のオブジェクトを表示できます。

  &start_element=101

  &sort=last_modified.desc

  ページ分割の詳細については 、「調整、改ページ調整、およびフィルター処理」を参照してください。

• フィールドを VALUE 含める場合、ユーザーとセグメントの組み合わせごとに値を一覧表示する必要がありますか?

  はい、あります。 ただし、値を割り当てない場合は、値としてを入力 0 できます。

• バッチ セグメントのアップロードをプッシュできる頻度はどのくらいですか?

  当社のシステムでは、1 分あたり (メンバーあたり) 最大 1 回のアップロードを処理できます。 アップロード間隔が 1 分を超える場合は、正常に動作します。

• "1 日あたりのバイト アップロード制限を超えようとしています" という通知を受け取った。 引き続きデータ ファイルをアップロードできますか?

  毎日の BSS の制限サイズに注意してください。 システムからエラー メッセージが表示された場合は、ファイルのアップロード ジョブを直ちに停止します。 エラー メッセージを繰り返してファイルのアップロードを続行すると、システムの遅延が発生する可能性があります。 1 時間待ってから、ファイルのアップロードをもう一度試してください。

• API Batch Segment Service を介して送信する前にアップロード ファイルを圧縮する必要がありますか?

  はい。 ベスト プラクティスとして、バッチ セグメント サービスを介してファイルをプッシュする前に、アップロード ファイルを常に圧縮する必要があります。 gzip 圧縮標準がサポートされています。

• API Batch Segment Service を介してセグメントにアップロードするたびに、完全な対象ユーザーを常にプッシュする必要がありますか?

  ベスト プラクティスとして、初めて対象ユーザーをアップロードする場合、または対象ユーザーがそれぞれのセグメントから期限切れになった場合にのみ、API Batch Segment Service を通じて完全な対象ユーザーをアップロードする必要があります。 これらの 2 つのケースに加えて、既存の対象ユーザーに変更 (差分) を常にアップロードする必要があります。 バッチ セグメントのアップロードでは、Xandr Cookie ストア内の Cookie の有効期間は更新されません (Cookie が特定のセグメント セットに関連付けられている時間のみを更新できます)。

• バッチ セグメントアップロード ファイルの UID を並べ替える必要がありますか?

  ユーザー ID でファイルを並べ替えることで、システムがファイルをより迅速に処理するのに役立ちます。

• ジョブのユーザー一致率を確認するにはどうすればよいですか?

  ジョブのユーザー一致率は、システムが以前に見た ID の割合を、アップロードされた識別子の合計量で割った値です。 これは、アップロードされたデータの品質を示すメトリックとして役立ちます。 Xandr の内部チームも、このメトリックを使用して、アップロードされたデータの品質を評価します。 一致率を計算する数式は次のとおりです。

  ユーザー一致率 = num_valid_user / ( + num_valid_usernum_invalid_user)

• 私はこれが機能していないと思います。 あなたは助けることができますか?

  もちろん！ カスタマー サポート ポータルからケースを送信します。 ジョブの状態レポートは 30 日間のジョブ履歴で保持されますが、データの実際のファイルは 3 日間だけ保存されることに注意してください。 アップロードしたデータを確認できるように、アップロード後はできるだけ早くケースを送信してください。

• BSS 経由でアップロードされなかった ID が LLD に表示されるのはなぜですか?

  アップロードされた ID をターゲットに設定すると、同じユーザーにリンクされている関連 ID もターゲットになります。 その結果、LLD にアップロードされなかった ID が表示されることがあります。 この場合、ID は、関連するデバイス ID を介してアップロードされた ID と同じユーザーにリンクされました。

関連項目

• バッチ Server-Side セグメント化
• BSS アカウントの初期セットアップ
• BSS アップロードのトラブルシューティング