adjust-icon

设置统一回传和合作伙伴参数

通过适用于 Adobe Experience SDK 的 Adjust Android Extension，您可以向 Adjust 发送额外信息，并由 Adjust 将这些信息转发给您的回传 URL 和渠道合作伙伴。全局参数是字符串键值对，可用来传送设备或用户相关的更多信息。

全局回传参数

如果您在 Adjust 控制面板中注册回传 URL，那么当 SDK 发送会话数据时，Adjust 会向您的回传 URL 发送一个 GET 请求。要向此回传请求附加参数，请在代码中设置全局参数。

参考

Adjust 类方法可管理全统一回传参数。您可以添加或移除单个参数，也可以一次性重置所有参数。

添加全局回传参数

要添加全局回传参数，请使用下列参数调用 Adjust.addGlobalCallbackParameter方法：

key: String

参数键。

value: String

参数值。

多次调用 Adjust.addGlobalCallbackParameter 方法可添加多个参数。

Adjust.addGlobalCallbackParameter("key", "value");
Adjust.addGlobalCallbackParameter("user_id", "855");

移除全局回传参数

要移除全局回传参数，请使用下列参数调用 Adjust.removeGlobalCallbackParameter方法：

key: String

要移除的参数键。

Adjust.removeGlobalCallbackParameter("key");

移除所有全局回传参数

如需一次性移除所有全局回传参数，请调用 Adjust.removeGlobalCallbackParameters 方法。

此方法会移除所有活跃的全局回传参数，也就是说，您不会通过 Adjust 的回传收到任何参数。

Adjust.removeGlobalCallbackParameters();

全局合作伙伴参数

您可以添加合作伙伴参数，向渠道合作伙伴发送额外的信息。通过与外部合作伙伴分享额外参数，您可以开展更精细的数据分析，优化再营销。

针对 Adobe Experience SDK 的 Adjust Android Extension 发送会话数据时，Adjust 服务器会向您配置的合作伙伴发送全局合作伙伴参数。

请参阅选择数据分享选项，了解如何配置要与外部合作伙伴分享的数据。

参考

Adjust 类方法可管理全局合作伙伴参数。您可以添加或移除单个参数，也可以一次性重置所有参数。

添加全局合作伙伴参数

要添加全局合作伙伴参数，请使用下列参数调用 Adjust.addGlobalPartnerParameter方法：

key: String

参数键。

value: String

参数值。

多次调用 Adjust.addGlobalPartnerParameter 方法可添加多个参数。

Adjust.addGlobalPartnerParameter("key", "value");
Adjust.addGlobalPartnerParameter("user_id", "855");

移除全局合作伙伴参数

要移除全局合作伙伴参数，请使用下列参数调用 Adjust.removeGlobalPartnerParameter方法：

key: String

要移除的参数键。

Adjust.removeGlobalPartnerParameter("key");

移除所有全局合作伙伴参数

如需一次性移除所有全局合作伙伴参数，请调用 Adjust.removeGlobalPartnerParameters 方法。

该方法会移除所有已激活的全局合作伙伴参数，也就是说，不会有任何参数被发送给渠道合作伙伴。

Adjust.removeGlobalPartnerParameters();

教程：添加和删除全局参数

您可以随时调用本页中描述的方法，来更改您的统一回传和合作伙伴参数。如果您已按照集成指南进行操作，那么您的 MainActivity.java 文件应如下所示：

MainActivity.java
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;


import androidx.appcompat.app.AppCompatActivity;


import com.adjust.sdk.Adjust;
import com.adjust.sdk.AdjustDeeplink;


public class MainActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);


      Intent intent = getIntent();
      Uri data = intent.getData();
      AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
      Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
   }
}

添加新函数以更新全局参数：

  • addAdjustGlobalCallback: 该函数会添加新的统一回传。
  • removeAdjustGlobalCallback: 该函数会移除 addAdjustGlobalCallback 添加的统一回传。
  • removeAllAdjustGlobalCallbacks: 该函数会移除所有统一回传。
  • addAdjustGlobalPartnerParam: 该函数会添加一个新的全局合作伙伴参数。
  • removeAdjustGlobalPartnerParam: 该函数会移除 addAdjustGlobalPartnerParam 添加的全局合作伙伴参数。
  • removeAllAdjustGlobalPartnerParams: 该函数会移除所有全局合作伙伴参数。

该函数接受 View 为参数，并返回 void。要处理更新，请在每个函数正文中调用相关的 Adjust 类方法。

更新后的 MainActivity.java 文件如下：

MainActivity.java
public class MainActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);


      Intent intent = getIntent();
      Uri data = intent.getData();
      AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
      Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
   }


   public void addAdjustGlobalCallback(View view) {
      Adjust.addGlobalCallbackParameter("user_id", "855");
   }


   public void removeAdjustGlobalCallback(View view) {
      Adjust.removeGlobalCallbackParameter("user_id");
   }


   public void removeAllAdjustGlobalCallbacks(View view) {
      Adjust.removeGlobalPartnerParameters();
   }


   public void addAdjustGlobalPartnerParam(View view) {
      Adjust.addGlobalPartnerParameter("user_id", "855");
   }


   public void removeAdjustGlobalPartnerParam(View view) {
      Adjust.removeGlobalPartnerParameter("user_id");
   }


   public void removeAllAdjustGlobalPartnerParams(View view) {
      Adjust.removeGlobalPartnerParameters();
   }
}