Skicka meddelanden (Python)

Senast uppdaterad: 5 maj 2025

Skapat för:

  • Utvecklare

Beskrivning

send_notifications() används för att skicka visnings- eller klickmeddelanden till Adobe Target för mätning och rapportering.

OBSERVERA
När ett execute-objekt med obligatoriska parametrar finns i själva begäran, ökas intrycket automatiskt för kvalificerande aktiviteter.

SDK-metoder som automatiskt ökar ett intryck är:

  • get_offers()
  • get_attributes()

När ett prefetch-objekt skickas i begäran ökas inte intrycket automatiskt för aktiviteter med rutor i prefetch-objektet. Send_notifications() måste användas för förhämtade upplevelser för att öka antalet visningar och konverteringar.

Metod

send_notifications

target_client.send_notifications(options)

Parametrar

options har följande struktur:

NamnTypObligatorisktStandardBeskrivning
förfråganDeliveryRequestJaIngenFöljer begäran Target Delivery API
target_cookiestrnoIngenTarget-cookie
target_location_hintstrnoIngenPlatstips för Target
Consumer_idstrnoIngenOlika konsument-ID bör anges när flera samtal sammanfogas
customer_idslist[CustomerId]noIngenEn lista med kund-ID:n i VisitorId-kompatibelt format
session_idstrnoIngenAnvänds för att länka flera begäranden
callbackanropbarnoIngenOm begäran hanteras asynkront anropas återanropet när svaret är klart
err_callbackanropbarnoIngenOm begäran hanteras asynkront, anropas felåteranrop när undantaget utlöses

Returnerar

Returns a TargetDeliveryResponse om det anropas synkront (standard), eller en AsyncResult om den anropas med ett återanrop. TargetDeliveryResponse har följande struktur:

NamnTypBeskrivning
svarLeveranssvarFöljer svaret på Target Delivery API
target_cookiedictTarget-cookie
target_location_hint_cookiedictWebbplatstipscookie för Target
analytics_detailslist[AnalyticsResponse]Analytics nyttolast, om Analytics används på klientsidan
tracelist[dict]
response_tokenslist[dict]En lista med ​ svarstoken
metadictYtterligare metadata för beslutsfattande som kan användas med enhetsspecifik beslutsfattande

Exempel

Först skapar vi Target Delivery API-begäran om förhämtning av innehåll för mrutorna home och product1.

Python

mboxes = [MboxRequest(name="home"),
          MboxRequest(name="product1")]
prefetch = PrefetchRequest(mboxes=mboxes)
delivery_request = DeliveryRequest(prefetch=prefetch)

# Next, we fetch the offers via Target Python SDK getOffers() API
response = target_client.get_offers({ "request": delivery_request })

Ett godkänt svar kommer att innehålla ett Target Delivery API-svarsobjekt, som innehåller förhämtat innehåll för de begärda rutorna. Ett exempel på ett target_response["response"]-objekt (formaterat som en ordlista) kan se ut så här:

Python

{
  "status": 200,
  "requestId": "e8ac2dbf5f7d4a9f9280f6071f24a01e",
  "id": {
    "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "client": "adobetargetmobile",
  "edgeHost": "mboxedge21.tt.omtrdc.net",
  "prefetch": {
    "mboxes": [
      {
        "index": 0,
        "name": "home",
        "options": [
          {
            "type": "html",
            "content": "HOME OFFER",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      },
      {
        "index": 1,
        "name": "product1",
        "options": [
          {
            "type": "html",
            "content": "TEST OFFER 1",
            "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
            "responseTokens": {
              "profile.memberlevel": "0",
              "geo.city": "dublin",
              "activity.id": "302740",
              "experience.name": "Experience B",
              "geo.country": "ireland"
            }
          }
        ],
        "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
      }
    ]
  }
}

Observera fälten mbox name, state och eventToken i alla alternativ för målinnehåll. Dessa bör anges i send_notifications()-begäran så snart varje innehållsalternativ visas. Låt oss anta att mbox product1 har visats på en annan enhet än webbläsaren. Begäran om meddelanden visas enligt följande: