ドキュメントTarget デベロッパーガイド

オーディエンスのターゲティング

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

概要

オーディエンスを使用すると、実験およびパーソナライゼーションアクティビティのターゲットを設定できます。 Adobe Target は、すぐに使用できる無数の強力なオーディエンスターゲット設定機能をサポートしています。 オーディエンスターゲティングには、次の属性を使用できます。

Target Library

詳しくは、Target ライブラリを参照してください。
​

  • Bing から
  • Chrome ブラウザー
  • Firefox ブラウザー
  • Google から
  • Internet Explorer
  • Linux オペレーティングシステム
  • Mac OS オペレーティングシステム
  • 新しい訪問者数
  • 再訪問者
  • Safari ブラウザー
  • タブレットデバイス
  • Windows オペレーティングシステム
  • Yahoo から

地域

詳しくは、 地域を参照してください。
​​

  • 国 / 地域
  • 都道府県
  • 市区町村
  • 郵便番号
  • 緯度
  • 経度
  • DMA
  • 携帯電話会社

ネットワーク

詳しくは、「 ネットワーク」を参照してください。

  • ISP
  • ドメイン名
  • 接続速度

モバイル

詳しくは、モバイルを参照してください。

  • デバイスのマーケティング名
  • デバイスモデル
  • デバイスのベンダー
  • モバイルデバイス
  • 携帯電話
  • タブレット
  • OS
  • 画面の高さ（px）
  • 画面の幅 (px)

カスタム

詳しくは、 カスタムパラメーターを参照してください。

  • 任意のキーと値のペア

オペレーティングシステム

詳しくは、 オペレーティングシステムを参照してください。

  • Linux
  • Macintosh
  • Windows

サイトのページ

詳しくは、「 サイトのページ」を参照してください。

  • 現在のページ
  • 前のページ
  • ランディングページ
  • HTTP ヘッダー

ブラウザー

詳しくは、 ブラウザーを参照してください。

  • タイプ
  • 言語
  • バージョン

訪問者プロファイル

詳しくは、 訪問者プロファイルを参照してください。

  • 永続する任意のキーと値のペア

トラフィックソース

詳しくは、 トラフィックソースを参照してください。

  • Baidu から
  • Bing から
  • Google から
  • Yahoo から
  • 参照ランディングページ：URL
  • 参照ランディングページ：ドメイン
  • 参照ランディングページ：クエリ

時間枠

詳しくは、時間枠を参照してください。

  • 開始日 / 終了日

クライアントヒント

ブラウザー、オペレーティングシステム、モバイルオーディエンス属性およびプロファイルスクリプトの特定のインスタンスを正しくセグメント化するには、Adobe Target に Client Hints が必要です。 背景情報について詳しくは、User Agent and Client Hints を参照してください。

Client Hints を Adobe Target に渡す方法

Node.js SDK v2.4.0 および Java SDK v2.3.0 以降では、getOffers() 呼び出しを使用してクライアントヒントを Target に送信できます。 Client Hints は、User Agent と共に request.context オブジェクトに含める必要があります。

Node.js SDK
code language-js line-numbers 
targetClient.getOffers({
    request: {
        context: {
            channel: "mobile"
            userAgent: "Mozilla/5.0 (Linux; Android 12; Pixel 4a) AppleWebKit/537.36 (KHTML, like Gecko) Mobile Safari/537.36",
            clientHints: {
                mobile: "true",
                platform: "Linux",
                platformVersion: "12.1",
                model: "Pixel 4a",
                browserUAWithMajorVersion: "\"Not A;Brand\";v=\"98\", \"Chromium\";v=\"98\", \"Google Chrome\";v=\"98\"",
                browserUAWithFullVersion: "\" Not A;Brand\";v=\"98.0.0.0\", \"Chromium\";v=\"98.0.4844.83\", \"Google Chrome\";v=\"98.0.4758.101\"",
                bitness: "64",
                architecture: "x86"
            }
        },
        execute: {
            mboxes: [{
                name: "home",
                index: 1
            }]
        }
    }
});
Java SDK
code language-javascript line-numbers 
import com.adobe.target.delivery.v1.model.ClientHints;
import com.adobe.target.delivery.v1.model.Context;
import com.adobe.target.delivery.v1.model.ExecuteRequest;
import com.adobe.target.edge.client.model.TargetDeliveryRequest;


ClientHints clientHints = new ClientHints();
clientHints.setMobile(true);
clientHints.setPlatform("macOS");
clientHints.setArchitecture("x86");
clientHints.setPlatformVersion("11.3.1");
clientHints.setBrowserUAWithMajorVersion(
  "\" Not A;Brand\";v=\"99\", \"Chromium\";v=\"99\", \"Google Chrome\";v=\"99\"");
String userAgent =
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Safari/537.36";


TargetDeliveryRequest request = TargetDeliveryRequest.builder()
        .execute(new ExecuteRequest().pageLoad(pageLoad))
        .context(new Context().clientHints(clientHints).userAgent(userAgent))
        .build();

オンデバイス判定

次の表に、オンデバイス判定でサポートされるオーディエンスルールとサポートされないオーディエンスルールを示します。

オーディエンスルール
オンデバイス判定
地域
○
ネットワーク
×
モバイル
×
カスタムパラメーター
○
オペレーティングシステム
○
サイトのページ
○
ブラウザー
○
訪問者プロファイル
×
トラフィックソース
×
時間枠
○
Experience Cloudオーディエンス（Adobe Audience Manager、Adobe AnalyticsおよびAdobe Experience Managerのオーディエンス）
×

オンデバイス判定のためのジオターゲティング

ジオベースのオーディエンスを使用したオンデバイス判定アクティビティの待ち時間をほぼゼロに保つために、Adobeは getOffers の呼び出しでジオバリューを自分で指定することをお勧めします。 これを行うには、リクエストの Context に Geo オブジェクトを設定します。 つまり、サーバーには、各エンドユーザーの場所を判断する方法が必要になります。 例えば、サーバーは、設定したサービスを使用して IP からジオルックアップを実行する場合があります。 Google Cloud など、一部のホスティングプロバイダーは、各 HttpServletRequest ージのカスタムヘッダーを介してこの機能を提供します。

Node.js SDK
code language-js line-numbers 
const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                city: "SAN FRANCISCO",
                countryCode: "US",
                stateCode: "CA",
                latitude: 37.75,
                longitude: -122.4
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})
Java SDK
code language-javascript line-numbers 
public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(ipToGeoLookup(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

    public static Geo ipToGeoLookup(String ip) {
        GeoResult geoResult = geoLookupService.lookup(ip);
        return new Geo()
            .city(geoResult.getCity())
            .stateCode(geoResult.getStateCode())
            .countryCode(geoResult.getCountryCode());
    }
}

ただし、サーバーで IP からジオベースの検索を実行できない場合でも、ジオベースのオーディエンスを含んだ getOffers リクエストに対してオンデバイス判定を実行すると、これもサポートされます。 このアプローチの欠点は、リモートの IP からジオルックアップを使用することで、各 getOffers 呼び出しに待ち時間が追加されることです。 この待ち時間は、サーバーの近くにある CDN にヒットするため、リモート getOffers 呼び出しよりも短くなる必要があります。 SDK がユーザーの IP アドレスの位置情報を取得するには、リクエストの Context に Geo オブジェクトの ipAddress フィールドを のみ 指定する必要があります。 ipAddress 以外のフィールドが指定された場合、Target SDK は解決のために位置情報メタデータを取得しません。

Node.js SDK
code language-js line-numbers 
const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                ipAddress: "127.0.0.1"
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})
Java SDK
code language-javascript line-numbers 
public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(new Geo().ipAddress(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

}

サーバーサイドの決定

次の表に、サーバー側判定でサポートされるオーディエンスルールとサポートされないオーディエンスルールを示します。

オーディエンスルール
サーバー側決定
地域
○
ネットワーク
○
モバイル
○
カスタムパラメーター
○
オペレーティングシステム
○
サイトのページ
○
ブラウザー
○
訪問者プロファイル
○
トラフィックソース
○
時間枠
○
Experience Cloudオーディエンス（Adobe Audience Manager、Adobe AnalyticsおよびAdobe Experience Managerのオーディエンス）
○
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3