Documentation Target Guide du développeur de Target

Obtention d’offres (Python)

Dernière mise à jour : 5 mai 2025

Rubriques :
APIs/SDKs

Créé pour :

Développeur

Description

get_offers() est utilisé pour exécuter une décision et récupérer une expérience de Adobe Target.

Méthode

getOffers

target_client_instance.get_offers(options)

Paramètres

Le dict options a la structure suivante :

Nom	Type	Requis	Par défaut	Description
events	DeliveryRequest	Oui	None	Se conforme à la requête Target Delivery API
target_cookie	str	non	None	cookie Target
target_location_hint	str	non	None	Target indicateur d’emplacement
consumer_id	str	non	None	Lors de la combinaison de plusieurs appels, différents identifiants de consommateur doivent être fournis.
customer_ids	list[CustomerId]	non	None	Liste des ID de client au format compatible avec VisitorId
session_id	str	non	None	Utilisé pour lier plusieurs requêtes
callback	callable	non	None	Si vous gérez la requête de manière asynchrone, le rappel est appelé lorsque la réponse est prête.
err_callback	callable	non	None	Si vous gérez la requête de manière asynchrone, le rappel d’erreur est appelé lorsque l’exception est levée.

Retours

Renvoie un TargetDeliveryResponse appelé de manière synchrone (par défaut) ou AsyncResult appelé avec un rappel. TargetDeliveryResponse a la structure suivante :

Nom	Type	Description
response	DeliveryResponse	Se conforme à la réponse Target Delivery API
target_cookie	dict	cookie Target
target_location_hint_cookie	dict	cookie d’indicateur d’emplacement Target
analytics_details	list[AnalyticsResponse]	Charge utile Analytics, en cas d’utilisation d’Analytics côté client
trace	list[dict]	Données de suivi agrégées pour toutes les mbox/vues de requête
response_tokens	list[dict]	Liste des jetons de réponse
meta	dict	Métadonnées de prise de décision supplémentaires à utiliser avec la prise de décision sur appareil

Les objets target_cookie et target_location_hint_cookie utilisés pour renvoyer les données au navigateur ont la structure suivante :

Nom	Type	Description
name	str	Nom du cookie
value	any	Valeur du cookie, la valeur sera convertie en chaîne
max_age	int	Le `max_age option` est pratique pour définir les expirations par rapport à l’heure actuelle en secondes.

L’objet meta utilisé pour indiquer l’état de la réponse cible possède la structure suivante :

Nom	Type	Description
decisioning_method	str	Quelle méthode de prise de décision a été utilisée : sur appareil ou côté serveur ?
remote_mboxes	list`[str]`	Lorsque la méthode de prise de décision est `on-device`, un tableau de noms de mbox qui n’ont pas pu être entièrement décidés sur l’appareil est donné. En d’autres termes, une requête Target Delivery API est nécessaire.
remote_views	list`[str]`	Lorsque la méthode de prise de décision est sur l’appareil, un tableau de noms d’affichage qui n’ont pas pu être entièrement décidés sur l’appareil est fourni. En d’autres termes, une requête Target Delivery API est nécessaire.

Exemple

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