オファーを取得（Python）

最終更新日： 2025年5月5日

トピック：
APIs/SDKs

作成対象：

開発者

説明

get_offers() を使用して、決定を実行し、Adobe Target からエクスペリエンスを取得します。

メソッド

getOffers

target_client_instance.get_offers(options)

パラメーター

options dict の構造は次のとおりです。

名前	タイプ	必須	デフォルト	説明
request	DeliveryRequest	○	None	Target Delivery API リクエストに準拠しています
target_cookie	str	いいえ	None	Target cookie
target_location_hint	str	いいえ	None	Target location hint
consumer_id	str	いいえ	None	複数の呼び出しをステッチする場合、異なる消費者 ID を指定する必要があります
customer_ids	list[CustomerId]	いいえ	None	VisitorId 互換の形式の顧客 ID のリスト
session_id	str	いいえ	None	複数のリクエストのリンクに使用
callback	呼び出し	いいえ	None	リクエストを非同期で処理する場合、応答の準備が整うとコールバックが呼び出されます
err_callback	呼び出し	いいえ	None	リクエストを非同期で処理する場合、例外が発生するとエラーコールバックが呼び出されます

Returns

同期的に呼び出される場合は TargetDeliveryResponse を返し（デフォルト）、コールバックで呼び出される場合は AsyncResult を返します。 TargetDeliveryResponse の構造は以下のとおりです。

名前	タイプ	説明
response	DeliveryResponse	Target Delivery API 応答に準拠しています
target_cookie	dict	Target cookie
target_location_hint_cookie	dict	Target location hint cookie
analytics_details	list[AnalyticsResponse]	Analytics ペイロード（クライアントサイド Analytics を使用する場合）
trace	list[dict]	すべてのリクエスト mbox/ビューの集計トレースデータ
response_tokens	list[dict]	応答トークンリスト
meta	dict	オンデバイス判定で使用する追加の判定メタデータ

データをブラウザーに戻すために使用される target_cookie および target_location_hint_cookie オブジェクトは、次の構造を持っています。

名前	タイプ	説明
name	str	cookie 名
value	any	Cookie の値。値は文字列に変換されます
max_age	int	`max_age option` は、現在の時刻（秒）を基準に有効期限を設定する場合に便利です

ターゲット応答のステータスを示すために使用される meta オブジェクトは、次の構造を持ちます。

名前	タイプ	説明
decisioning_method	str	使用された判定方法：オンデバイスまたはサーバーサイド
remote_mbox	リスト `[str]`	Decisioning メソッドが `on-device` の場合、オンデバイスで完全に決定できなかった mbox 名の配列が提供されます。つまり、Target Delivery API リクエストが必要です。
remote_views	リスト `[str]`	判定方法がオンデバイスの場合、オンデバイスで完全に決定できなかったビュー名の配列が与えられます。つまり、Target Delivery API リクエストが必要です。

例

Python

def client_ready_callback():
    context = Context(channel=ChannelType.WEB)
    mboxes = [MboxRequest(name="a1-serverside-ab", index=1)]
    execute = ExecuteRequest(mboxes=mboxes)
    delivery_request = DeliveryRequest(context=context, execute=execute)

    get_offers_options = {
      "request": delivery_request
    }

    target_delivery_response = target_client.get_offers(get_offers_options)


client_options = {
    "client": "acmeclient",
    "organization_id": "1234567890@AdobeOrg",
    "events": {
        "client_ready": client_ready_callback
    }
}
target_client = TargetClient.create(client_options)

recommendation-more-help