# AlexGromoreCSJMixDemo_Android

**Repository Path**: xihoffy/alex-gromore-csj-mix-android

## Basic Information

- **Project Name**: AlexGromoreCSJMixDemo_Android
- **Description**: 一个自定义的广告平台
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2024-04-25
- **Last Updated**: 2025-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 集成

## 一. 接入TopOn SDK

请参考[TopOn SDK集成文档](https://docs.toponad.com/#/zh-cn/android/android_doc/android_sdk_config_access)接入TopOn SDK，建议接入**TopOn v6.2.60及以上版本**

**注意**：

1.融合版本的穿山甲和非融合版本的穿山甲只能选择其中一个集成，如果项目有非融合版的穿山甲，则需要提前移除。

2.如果需要通过TopOn同时集成融合版本Gromore和融合版本穿山甲，则还需要额外引入**anythink_network_csj_mix.aar**包到项目中



## 二. 引入Gromore SDK & Alex Adapter

### Android

#### 1. 引入Gromore SDK

在build.gradle中添加以下代码，引入Gromore SDK（以下为Gromore v5.9.2.8的引入代码）

```java
repositories {
    //GroMore SDK依赖
    maven {
        url "https://artifact.bytedance.com/repository/pangle"
    }
}

dependencies {
    //GroMore_sdk
    implementation "com.pangle.cn:mediation-sdk:5.9.2.8"
}
```



#### 2. 引入Alex Adapter 

以下方式任选其一即可：

2.1 **aar**：将alex_adapter_gromore_mix_*.aar放到项目module的libs文件夹下（如果没有libs文件夹，则需要创建），然后在build.gradle中进行引入

```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
}
```

**注意**：如果需要通过TopOn来集成融合版本穿山甲，则还需要将anythink_network_csj_mix.aar包放到项目module的libs文件夹下



2.2 **源码**：

*将AlexLib目录下的代码复制拷贝到项目module下的src/main/java中，可根据需要修改各个Adapter的包名或者类名。

*在项目的proguard-rules.pro中添加以下混淆规则（如果有修改类名，keep的类名需改为修改后的类名）

```java
-keep class com.alex.** { *;}
-keepclassmembers public class com.alex.** {
   public *;
}
```

**注意**：如果需要通过TopOn来集成融合版本穿山甲，则还需要将anythink_network_csj_mix.aar包放到项目module的libs文件夹下



#### 3. AndroidManifest配置

在项目AndroidManifest.xml的\<application\>下，添加以下provider配置：

```xml
<provider
	android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
    android:authorities="${applicationId}.TTFileProvider"
    android:exported="false"
    android:grantUriPermissions="true"
    tools:replace="android:authorities">
    <meta-data
    	android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/alex_tt_file_path" />
</provider>
```

**注意**：必须将res/xml/alex_tt_file_path.xml文件，放到项目中的res/xml目录下



### Unity

#### 1. 引入Gromore SDK

在 Assets/AnyThinkAds/Plugins/Android/China/mediation目录下 创建`Gromore/Editor`目录（**注意**：这里是Gromore目录下的Editor目录），然后在创建的`Gromore/Editor`目录下添加文件`Dependencies.xml`，内容如下：

```xml
<?xml version="1.0" encoding="utf-8"?>
<dependencies>
    <androidPackages>
        <repositories>
            <repository>https://artifact.bytedance.com/repository/pangle</repository>
        </repositories>

        <androidPackage spec="com.pangle.cn:mediation-sdk:5.9.2.8"/>
        
    </androidPackages>
</dependencies>
```



#### 2. 引入Alex Adapter

从gitee上下载alex_adapter_gromore_mix_*.aar包，然后将alex_adapter_gromore_mix_*.aar放到项目Assets/AnyThinkAds/Plugins/Android/China/mediation文件夹下

**注意**：如果需要通过TopOn来集成融合版本穿山甲，则还需要将anythink_network_csj_mix.aar包放到项目Assets/AnyThinkAds/Plugins/Android/China/mediation文件夹下



#### 3. LauncherManifest配置

3.1 生成LauncherManifest，如下图：

![](img/unity_androidmanifest_2019.png)

3.2 在生成的LauncherManifest的\<application\>下面，添加provider配置，如下：

```xml
<?xml version="1.0" encoding="utf-8"?>
<!-- GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN-->
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.unity3d.player"
    xmlns:tools="http://schemas.android.com/tools"
    android:installLocation="preferExternal">
  
	
    <application android:label="@string/app_name"
                 android:icon="@mipmap/app_icon">
		
		<!--添加的配置开始>
		<provider
            android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
            android:authorities="${applicationId}.TTFileProvider"
            android:exported="false"
            android:grantUriPermissions="true"
            tools:replace="android:authorities">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/alex_tt_file_path" />
        </provider>
		<!--添加的配置结束>
		
		
    </application>
</manifest>
```

3.3 添加res资源文件，请根据您的Unity Editor版本进行资源的添加

**3.3.1 Unity 2021.2及以上版本**

下载gitee上的res/xml/alex_tt_file_path.xml文件，将res/xml/alex_tt_file_path.xml文件放置在**Assets/Plugins/Android/gromoreRes.androidlib/res/xml**目录下

**注意**：上面的**gromoreRes.androidlib**为文件夹目录的名字（必须包含“**.androidlib**”后缀）

在**Assets/Plugins/Android/gromoreRes.androidlib**目录下创建**AndroidManifest.xml**文件，内容如下：

```
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.alex.gromore.res">

</manifest>
```

**3.3.2 Unity 2021.2以下版本**

下载gitee上的res/xml/alex_tt_file_path.xml文件，将res/xml/alex_tt_file_path.xml文件放置在**Assets/Plugins/Android/res/xml**目录下



## 三. Gromore接入其他广告平台

以接入腾讯优量汇为例：

1、先到 [TopOn后台](https://docs.toponad.com/#/zh-cn/android/download/package)，查看接入的TopOn版本兼容的穿山甲版本是多少？（TopOn v6.2.60版本兼容的腾讯优量汇版本为v4.540.1410）

2、然后到 [Gromore后台-接入中心-GroMore-查看接入文档-SDK接入](https://www.csjplatform.com/union/media/union/download/detail?id=142&docId=27562&osType=android)，根据接入的Gromore SDK版本（v5.9.2.8）和腾讯优量汇版本（v4.540.1410），查找对应的Adapter版本（即v4.540.1410.1）

**注意：**

（1）需确保TopOn和Gromore都兼容腾讯优量汇SDK

![img](img/image5.png)

3、引入Gradle依赖：

```java
dependencies {
    implementation "com.pangle.cn:mediation-gdt-adapter:4.540.1410.2"
}
```





## 四. TopOn 后台配置

1、按照SDK对接文档接入同时，需要在后台添加自定义广告平台

![img](img/image1.png)

2、选择【自定义广告平台】，填写广告平台名称、账号名称，按照SDK的对接文档填写Adapter

*广告平台名称需要写上Gromore，便于区分广告平台，建议名称格式：Gromore_XXXXX

![img](img/image2.png)

**注意**：如果是使用aar方式或者直接使用源码方式（没有修改类名），请配置以下类名。如果修改了类名，请配置修改后的类名

```
激励视频：com.alex.AlexGromoreRewardedVideoAdapter
插屏：com.alex.AlexGromoreInterstitialAdapter
横幅：com.alex.AlexGromoreBannerAdapter
原生：com.alex.AlexGromoreNativeAdapter
开屏：com.alex.AlexGromoreSplashAdapter
```

![img](img/image3.png)

3、记录广告平台ID

![img](img/image4.png)

以上配置都完成之后，可以添加广告源配置



#### Adapter中使用的Key说明

```
"app_id": 广告平台的应用ID
"slot_id": 广告平台的广告位ID

"size": banner的尺寸，包括：320x50、320x100、300x250、468x60、728x90、custom
"s_c_btn": banner是否展示关闭按钮，0：不展示，1：展示
```

后台添加广告源时的JSON配置示例如下：（xxx需要替换为Gromore实际的SDK key以及广告位ID，非横幅广告位不需要配置"size"、"s_c_btn"）

```json
{
    "app_id":"xxx",
    "slot_id":"xxx",
    "slot_info":"{\"common\":{\"s_c_btn\":\"1\",\"size\":\"320x50\"}}"
    
}
```



## 五. Gromore 后台配置

### Step1. 创建Gromore账号

登录[穿山甲官网](https://www.csjplatform.com/)申请开通账号



### Step2. 创建Gromore的应用和广告位

1、在 **Gromore --> 聚合管理--> 添加应用** 中创建应用

![](img/gromore_1.png)

选择已有的穿山甲应用，点击添加

![](img/gromore_2.png)



2、进入已创建的应用， 点击**创建广告位**

![](img/gromore_3.png)

选择需要创建的广告位类型，可选择是否勾选创建穿山甲代码位。

创建广告位的时候注意把一键创建竞价和兜底代码位的按钮置灰，即不开启。

![](img/gromore_4.png)



### Step3. 在Gromore完成配置代码位

1、请按照Gromore的[操作指南](https://www.csjplatform.com/supportcenter/5841)完成广告网络和瀑布流配置

2、一个Gromore广告位对应一个TopOn后台广告源（也就是一层bidding或一层瀑布流底价配置）

![](img/gromore_5.png)

- 如果需要创建Gromore bidding广告源，需要在一个Gromore广告位里面，配置一层穿山甲bidding

![](img/gromore_6.png)

- 如果需要创建Gromore 底价广告源，需要在一个Gromore广告位里面，配置一层穿山甲有底价的代码位。如果需要在TopOn后台设置多个Gromore底价广告源，需要创建多个Gromore广告位

![](img/gromore_7.png)



### Step4. Gromore广告位说明

Gromore的广告位类型跟TopOn的广告类型对应关系如下：

| **Gromore-广告位类型** | **TopOn-广告类型** |
| ---------------------- | ------------------ |
| 信息流                 | 原生               |
| Banner                 | Banner             |
| 开屏                   | 开屏               |
| 插全屏                 | 插屏               |
| 激励视频               | 激励视频           |



### Step5. 在后台配置Gromore广告位

#### 5.1 配置Gromore的广告源

5.1.1 在**Gromore --> 聚合管理 --> 应用**中查看**应用ID和**广告位ID

![](img/gromore_8.png)



5.1.2 将Gromore的参数配置在TopOn后台

添加广告源，登录TopOn后台→聚合管理→添加广告源→选择Gromore广告平台→填写上述应用ID和广告位ID

![](img/gromore_9.png)



## 六、测试Gromore广告

请确保已经按照上方说明，已经在Gromore后台创建好应用和广告位，并将其配置到TopOn后台的广告位下

### 1. 打开TopOn SDK的日志

```
ATSDK.setNetworkLogDebug(true);//SDK日志功能，集成测试阶段建议开启，上线前必须关闭
```

> 打开后，可在Logcat中过滤此TAG查看相关日志：`anythink|TTMediation`

可调用以下代码获取设备ID

```java
//注意：必须在初始化TopOn SDK之后调用
ATSDK.testModeDeviceInfo(context, new DeviceInfoCallback() {
    @Override
    public void deviceInfo(String deviceInfo) {
        Log.i(TAG, "deviceInfo: " + deviceInfo);
    }
});

```

### 2. 添加穿山甲测试信息

进入[测试工具](https://www.csjplatform.com/union/media/union/adcheck)页面，点击`+新建测试信息`按钮，在设备ID的输入框中填入上面获取到的OAID或者IMEI，然后选择需要测试的穿山甲广告类型，点击`新建`进行保存。

![](img/test_info.png)



### 3. 加载&展示广告

在Gromore后台添加测试信息后，请等待15分钟，待配置生效后，调用TopOn SDK的相关方法进行TopOn广告位的加载&展示，验证Gromore广告的集成是否正常