오퍼 가져오기(Python)

마지막 업데이트: 2025년 5월 5일

주제:
APIs/SDKs

작성 대상:

개발자

설명

get_offers()은(는) 결정을 실행하고 Adobe Target에서 경험을 검색하는 데 사용됩니다.

방법

getOffers

target_client_instance.get_offers(options)

매개 변수

options dict의 구조는 다음과 같습니다.

이름	유형	필수	기본값	설명
요청	DeliveryRequest	예	없음	Target Delivery API 요청 준수
target_cookie	str	no	없음	Target 쿠키
target_location_hint	str	no	없음	Target 위치 힌트
consumer_id	str	no	없음	여러 호출을 결합할 때 서로 다른 소비자 ID가 제공되어야 합니다
customer_ids	list[CustomerId]	no	없음	VisitorId 호환 형식의 고객 ID 목록
session_id	str	no	없음	여러 요청을 연결하는 데 사용됨
callback	호출 가능	no	없음	요청을 비동기식으로 처리하는 경우 응답이 준비되면 콜백이 호출됩니다
err_callback	호출 가능	no	없음	요청을 비동기적으로 처리하는 경우 예외가 발생하면 오류 콜백이 호출됩니다

반환

동기적으로 호출된 경우 TargetDeliveryResponse을(를) 반환하고, 콜백으로 호출된 경우 AsyncResult을(를) 반환합니다. TargetDeliveryResponse의 구조는 다음과 같습니다.

이름	유형	설명
응답	DeliveryResponse	Target Delivery API 응답 준수
target_cookie	dict	Target 쿠키
target_location_hint_cookie	dict	Target 위치 힌트 쿠키
analytics_details	list[AnalyticsResponse]	클라이언트측 Analytics 사용의 경우 Analytics 페이로드
추적	list[dict]	모든 요청 mbox/보기에 대해 집계된 추적 데이터
response_tokens	list[dict]	응답 토큰 목록
meta	dict	온디바이스 의사 결정에 사용하기 위한 추가 의사 결정 메타데이터

데이터를 다시 브라우저로 전달하는 데 사용되는 target_cookie 및 target_location_hint_cookie 개체의 구조는 다음과 같습니다.

이름	유형	설명
이름	str	쿠키 이름
value	any	쿠키 값, 값이 문자열로 변환됩니다.
max_age	int	`max_age option`은(는) 현재 시간(초)을 기준으로 하여 편리하게 만료되도록 설정할 수 있습니다.

대상 응답의 상태를 나타내는 데 사용되는 meta 개체의 구조는 다음과 같습니다.

이름	유형	설명
decisioning_method	str	사용된 의사 결정 방법: 온디바이스 또는 서버측
remote_mboxes	목록`[str]`	Decisioning 메서드가 `on-device`인 경우 온디바이스에서 완전히 결정할 수 없는 mbox 이름 배열이 제공됩니다. 즉, Target Delivery API 요청이 필요합니다.
원격 보기 수	목록`[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