伽瑪狗数据广告开放平台接入文档

ゝ一世哀愁。 2022-04-24 14:22 221阅读 0赞

# 1. 广告展示与统计接口 #

## 1.1 接口功能： ##

*  方便广告主动态的更改广告素材图片和跳转的目标地址；
 *  实时的统计广告的展示流量；
 *  监控流量源的真伪；
 *  重复流量的精准投放；

## 1.2 效果图： ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoZ2hfMjAwNA_size_16_color_FFFFFF_t_70][]

## 1.3 接口： ##

### 1.3.1 接口描述 ###

接口地址：[https://open.gamagou.cn/material/\{pid\}][https_open.gamagou.cn_material_pid]

其中pid是广告位的ID ， 接入的时候直接用真实的广告位替换即可。

渠道商可以在伽玛狗的后台（admin.gamagou.cn）创建渠道的广告位。

Ps：如果没有后台登录账号，可以向伽马狗管理员申请，也可以让伽玛狗客服帮忙添加广告位。

### 1.3.2 示例 ###

**示例1****：已经开通**

[https://open.gamagou.cn/material/476481d77d6a445eb179b98a1403cbcd][https_open.gamagou.cn_material_476481d77d6a445eb179b98a1403cbcd]

{
        "statusCode":8200,
        "message":null,
        "data":{
            "img":"http://image.gamagou.cn/ADVERTISER/12vkmpOXowo2aNDPpQ.png",
            "target":"https://blog.csdn.net/shgh_2004/article/details/89559254"
        }
    }

状态码：8200；

返回素材地址：**[http://image.gamagou.cn/ADVERTISER/12vkmpOXowo2aNDPpQ.png][http_image.gamagou.cn_ADVERTISER_12vkmpOXowo2aNDPpQ.png]**

目标跳转地址：**[https://blog.csdn.net/shgh\_2004/article/details/89559254][https_blog.csdn.net_shgh_2004_article_details_89559254]**

**示例2****：未开通。**

{
        "statusCode":5001,
        "message":"广告位未投放",
        "data":null
    }

状态码：**5001**；

### 1.3.3 客户端缓存 ###

为了保持高可用性，客户端需要缓存接口返回的数据（此接口需要缓存的字段：img，target）。 当接口异常不稳定的情况下，可以正常的显示信息，给予用户更好的体验

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoZ2hfMjAwNA_size_16_color_FFFFFF_t_70]: /images/20220214/93cdc560f4fd4922b766fa6044e40593.png
[https_open.gamagou.cn_material_pid]: https://open.gamagou.cn/material/%7Bpid%7D
[https_open.gamagou.cn_material_476481d77d6a445eb179b98a1403cbcd]: https://open.gamagou.cn/material/476481d77d6a445eb179b98a1403cbcd
[http_image.gamagou.cn_ADVERTISER_12vkmpOXowo2aNDPpQ.png]: http://image.gamagou.cn/ADVERTISER/12vkmpOXowo2aNDPpQ.png
[https_blog.csdn.net_shgh_2004_article_details_89559254]: https://blog.csdn.net/shgh_2004/article/details/89559254