发送事件信息

用户进行操作后，您可以使用 Adjust SDK 向 Adjust 服务器发送事件信息。Adjust 会记录这些事件并在您的Datascape 报告、服务器回传和云存储上传中显示。

有关在 Adjust 中配置事件的更多信息，请参阅帮助中心的添加事件指南。

工作原理

事件由AdjustEvent2dx实例表示。AdjustEvent2dx类包含多个属性，您可以使用事件信息填充这些属性并发送至 Adjust。AdjustEvent2dx类必须使用 Adjust 事件识别码实例化。您可以按照添加事件指南中的步骤在 AppView 中找到事件识别码。您可以设置每个属性来完整呈现事件。

完成所有需要设置的属性后，请使用Adjust2dx::trackEvent()方法将AdjustEvent2dx实例发送至 Adjust。Adjust 收到此对象后会记录事件信息用于报告。

参考

AdjustEvent2dx类用于保存有关事件的信息。每个事件都由唯一的AdjustEvent2dx实例代表。

构造器

将事件识别码作为参数传递，实例化一个AdjustEvent2dx对象。

eventToken (std::string): 您的 Adjust 事件识别码。请参阅添加事件了解更多信息。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
Adjust2dx::trackEvent(adjustEvent);

设置事件收入

通过调用setRevenue()方法设置与事件关联的任何收入的金额以及货币代码。

revenue (double): 事件产生的收入额。
currency (std::string): 事件币种的ISO 4217 代码。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
adjustEvent.setRevenue(0.25, "EUR");
Adjust2dx::trackEvent(adjustEvent);

添加回传参数

向addCallbackParameter方法传递std::string键值对以添加回传参数。Adjust 收到您的AdjustEvent2dx实例后，所有回传参数都会被发送到您的回传 URL。

key (std::string): 参数的名称 (键)。
value (std::string): 参数值。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
adjustEvent.addCallbackParameter("event_token", "g3mfiw");
adjustEvent.addCallbackParameter("revenue_amount", "0.25");
Adjust2dx::trackEvent(adjustEvent);

添加合作伙伴参数

向addPartnerParameter()方法传递string键值对以添加回传参数。Adjust 收到您的AdjustEvent2dx实例后，所有合作伙伴参数都会被发送至您配置的外部合作伙伴。

key (std::string): 参数的名称 (键)。
value (std::string): 参数值。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
adjustEvent.addPartnerParameter("product_id", "29");
adjustEvent.addPartnerParameter("user_id", "835");
Adjust2dx::trackEvent(adjustEvent)

设置去重 ID

为AdjustEvent2dx实例设置唯一标识符以通过调用setDeduplicationId()方法来去除重复的收入事件。SDK 会存储最近 10 个标识符，带有重复交易 ID 的收入事件会被跳过。

deduplicationId (std::string): 唯一的去重 ID。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
adjustEvent.setDeduplicationId("5e85484b-1ebc-4141-aab7-25b869e54c49");
Adjust2dx::trackEvent(adjustEvent);

设置回传 ID

调用setCallbackId方法为 Adjust 服务器设置唯一标识符，以便在事件回传中进行报告。

callbackId (std::string): 唯一的回传 ID。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
adjustEvent.setCallbackId("f2e728d8-271b-49ab-80ea-27830a215147");
Adjust2dx::trackEvent(adjustEvent);

发送事件

使用您的AdjustEvent2dx实例作为参数调用Adjust2dx::trackEvent方法以将事件发送至 Adjust。

adjustEvent (AdjustEvent2dx): 您的AdjustEvent2dx实例。

AdjustEvent2dx adjustEvent = AdjustEvent2dx("{YOUR_EVENT_TOKEN}");
Adjust2dx::trackEvent(adjustEvent);

教程

本教程演示了如何使用AdjustEvent2dx类向 Adjust 发送事件信息。您可了解到：

如何创建并填充AdjustEvent2dx实例。
如何在应用中使用AdjustEvent2dx类向 Adjust 发送事件信息。

如需向 Adjust 发送事件信息，请按照下列步骤操作：

使用 Adjust 事件识别码实例化并填充AdjustEvent2dx对象。下方示例中设置了以下属性：
- 事件收入设为 0.25 ，货币代码设为 EUR 。
- 事件去重 ID 设置为 5e85484b-1ebc-4141-aab7-25b869e54c49 。
- 事件识别码和收入金额被添加为回传参数。
- 关联产品的 ID 和触发事件的用户 ID 被添加为合作伙伴参数。
- 回传 ID 设置为 f2e728d8-271b-49ab-80ea-27830a215147 。
在函数末尾，使用AdjustEvent2dx实例作为参数调用Adjust2dx::trackEvent()，以此将信息发送至 Adjust。
根据应用中的操作调用函数。在下面的示例中，当Send Event按钮被按下时该函数被调用。

#include "Adjust/Adjust2dx.h"

std::string appToken = "{YOUR_APP_TOKEN}";
std::string environment = AdjustEnvironmentSandbox2dx;

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
Adjust2dx::initSdk(adjustConfig);

AdjustEvent2dx adjustEvent = AdjustEvent2dx("g3mfiw");
adjustEvent.setRevenue(0.25, "EUR");
adjustEvent.setDeduplicationId("5e85484b-1ebc-4141-aab7-25b869e54c49");
adjustEvent.addCallbackParameter("event_token", "g3mfiw");
adjustEvent.addCallbackParameter("revenue_amount", "0.25");
adjustEvent.addPartnerParameter("product_id", "29");
adjustEvent.addPartnerParameter("user_id", "835");
adjustEvent.setCallbackId("f2e728d8-271b-49ab-80ea-27830a215147");
Adjust2dx::trackEvent(adjustEvent);

事件发送至 Adjust 后，您将看到包含AdjustEvent2dx实例详情的日志输出。

Path:      /event
ClientSdk: cocos2dx5.0.0
Parameters:
  android_uuid     781f17d5-5048-4fae-a4e5-77b58bab62b9
  api_level        34
  app_token        {YOUR_APP_TOKEN}
  app_version      1.0
  attribution_deeplink 1
  callback_id      f2e728d8-271b-49ab-80ea-27830a215147
  callback_params  {"event_token": "g3mfiw", "revenue_amount": "0.25"}
  connectivity_type 1
  country          US
  cpu_type         arm64-v8a
  created_at       2024-01-25T14:13:16.151Z+0100
  currency         EUR
  device_manufacturer Google
  device_name      sdk_gphone64_arm64
  device_type      phone
  display_height   2205
  display_width    1080
  environment      sandbox
  event_buffering_enabled 0
  event_count      3
  event_token      {YOUR_EVENT_TOKEN}
  gps_adid         5962dfc1-3a53-4692-850b-22c4bf4311a5
  gps_adid_attempt 2
  gps_adid_src     service
  hardware_name    UE1A.230829.036
  language         en
  mcc              310
  mnc              260
  needs_response_details 1
  os_build         UE1A.230829.036
  os_name          android
  os_version       14
  package_name     com.adjust.examples
  partner_params   {"product_id": "29", "user_id": "835"}
  revenue          0.25
  screen_density   high
  screen_format    long
  screen_size      normal
  session_count    2
  session_length   23
  subsession_count 1
  time_spent       23
  tracking_enabled 1
  deduplication_id 5e85484b-1ebc-4141-aab7-25b869e54c49
  ui_mode          1