デジタル プラットフォーム API - バッチ セグメント サービスのベスト プラクティス

バッチ セグメント サービス (BSS) を使用すると、外部セグメント データのバルク フィードを Xandr に送信できます。 BSSを使用すると、ファースト、セカンド、またはサードパーティのオーディエンスデータを簡単に統合して、高度なユーザーターゲティングとROIの向上のための動的で設定可能なセグメントを作成できます。

ベスト プラクティス

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

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

    Xandr は UID を段階的に期限切れにし、長期間表示されなかったユーザー ID がデータベースから削除され、新しいユーザー ID のスペースが確保されます。 非常に古い UID をアップロードすると、状態レポートに無効なユーザー ID が多く含まれる可能性があります。

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

    データは、大量の非常に小さなファイルよりも、少数の大きなファイルでより迅速にアップロードされます。

  • ファイルを重複除去します。

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

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

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

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

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

  • アップロード URL をすぐに使用してください。

    アップロード URL を要求した後は、5 分以内に必ず使用してください。追加しないと、新しい URL の要求が必要になります。 古い URL を再利用することはできません。

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

    Xandr プラットフォーム上の無効なセグメント、削除されたセグメント、または存在しないセグメントにデータを送信すると、1 日あたりの BSS アップロードの合計制限にカウントされます。 これにより、特定のセグメントが拡張されない理由やセグメントの使用率が低い理由について誤った思い込みが生じる可能性があります。 ファイルのアップロード履歴を表示するときに、[error_log_lines データ] フィールドを見てみましょう。 アップロードで渡されたすべての無効なセグメント ID が一覧表示されます。

  • ピーク時 (米国では午前 10 時から午後 10 時 (EST)、ヨーロッパでは午前 10 時から午後 10 時 (CET) ) にはサイズの大きなファイルをアップロードしないようにします。

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

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

    ステータス レポートを確認すると、エラーを見つけて修正し、より正確なデータをアップロードできます。

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

    データが処理されたら、Cookie ビューアーを使用していくつかのユーザー ID をスポットチェックできます。 1 つの地域にセグメントが表示されない場合は、もう 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 を含めます。

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

注:

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

FAQ

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

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

  • アップロード後、データをターゲティングに使用できるようになるまでどのくらいかかりますか?

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

    注:

    アップロードの処理には最大 24 時間かかります (Xandr SLA による)。

  • セグメントの年齢ターゲティングで、これらのユーザーに "発生" タイムスタンプはありますか?

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

    注:

    時刻は UTC タイム ゾーンです。

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

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

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

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

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

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

    &start_element=101

    &sort=last_modified.desc

    ページネーションの詳細については 、「スロットリング、ページネーション、およびフィルター処理」を参照してください。

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

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

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

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

  • "1 日あたりのバイト アップロード制限を超えようとしています" という通知が表示されました。 データ ファイルのアップロードを続行できますか?

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

  • アップロード ファイルは、API バッチ セグメント サービスを介して送信する前に圧縮する必要がありますか?

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

  • API バッチ セグメント サービスを使用してセグメントにアップロードするたびに、常に完全な対象ユーザーをプッシュする必要がありますか?

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

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

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

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

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

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

  • これはうまくいっていないと思います。 どうすればよいですか?

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

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

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

  • Last updated on