草庐IT

如何获取广告服务流量变现数据,助力广告效果分析?

HMS Core 2023-03-28 原文

广告服务(Ads Kit)提供流量变现服务,通过该服务开发者可以在自己的App中向用户展示Banner、原生、激励广告等多种形式的广告内容。而对于应用中已上线的广告位来说,因为涉及到收入,所以日常的数据监控显得尤为重要。

为此广告服务也提供了流量变现服务报表API(Publisher Service Reporting API),通过接入该API,开发者可以获取应用内广告变现相关数据,包括广告请求量、返回量、展示率、点击率等,让开发者可以依据数据对广告效果进行分析,从而及时调整投放策略。

开发者可根据返回的数据实现自己的报表展示效果

那么如何获取流量变现数据呢?以下是具体的集成步骤。

一.获取客户端ID和密钥

在获取变现数据前,我们要先有OAuth 2.0 客户端ID和密钥,用于生成调用报表API时传入的access_token,需要注意的是此处的客户端ID和密钥并不是指APPGallery Connect中应用的ClientID,而是通过在华为开发者联盟->凭证中创建的服务器应用的客户端ID。

  1. 注册成为开发者,完成实名认证。登录华为开发者联盟,点击右上角“管理中心”进入主页面。

  1. 进入“凭证”页面,创建项目,如果已有项目请跳过【步骤a】。

a. 选择“凭证”,根据下图标记顺序填入“项目名称”和“项目别名”新建项目。

b. 选中创建的项目,点击“确定”。

  1. 选择“OAuth 2.0 客户端 ID”创建客户端ID。

说明:

如果项目下已经存在“OAuth 2.0 客户端 ID”凭证,需要检查产品类型是否为服务器应用,如果是服务器应用可以跳过【步骤4】。

检查方式:点击操作一栏下的“编辑”按钮,查看“产品类型”。

如果不是“服务器应用”类型,需要重新创建“OAuth 2.0 客户端 ID”:

  1. 选择“服务器应用”,输入“产品名称”,选择“应用类型”和“默认语言”,点击“创建”;提示“客户端ID”和“密钥”,点击“确定”。

  1. 进入“我的API”页面,确认选中的项目,点击“申请新的HMS API服务”。

  1. 下拉找到“App Services”,点击“流量变现服务报表API”。

  1. 点击“启用”,开启流量变现服务报表API,之后就可以调用流量变现报表API了

在“停用”后,再次“启用”时,由于页面缓存等原因,生效时间是非实时生效的,需要等待大概6~10分钟。如果10分钟后没有生效,请重新进行尝试。

二.调用流量变现报表API

  1. 在调用流量变现报表API前需要先获取access_token鉴权信息。

调用接口:

POSThttps://oauth-login.cloud.huawei.com/oauth2/v3/token

请求示例:

POST /oauth2/v3/token HTTP/1.1
Host: oauth-login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&
        client_id=<客户端ID >&
        client_secret=<客户端密钥>

请求示例截图:

需要注意的是,客户端ID和密钥,是在开发者联盟界面获取的服务器应用的客户端ID和密钥,而不是在APPGallery Connect中创建的移动应用的客户端ID和密钥。

2.拿到access_token鉴权信息后,调用报表API。

调用接口:

POST https://ads.cloud.huawei.com/openapi/monetization/reports/v1/publisher

俄罗斯站点需要调用以下接口:

POST https://ads-drru.cloud.huawei.ru/openapi/monetization/reports/v1/publisher

请求示例:

POST /openapi/monetization/reports/v1/publisher HTTP/1.1
Content-Type: application/json
Authorization: Bearer ***
        Accept: application/json
Content-Length: 233

{
    "start_date": "2022-06-01",
    "end_date": "2022-06-28",
    "filtering": {
        "currency": "CNY"
    },
    "time_granularity": "STAT_TIME_GRANULARITY_DAILY",
    "page": 1,
    "page_size": 10
}

请求示例截图:

从截图中可以看到,数据已成功返回。具体请求参数,和响应参数可以参考文档链接

调用API获取变现报表数据后,开发者可以根据自己的需求去实现数据的展现形式。

三.接入流量变现报表时的常见问题

调用流量变现服务报表API时返回access forbidden?

原因分析:

1. 在开发者联盟界面“API”栏目中没有开启对应项目的流量变现报表API开关。

2. 流量报表API开关“启用”后,还没有等到权限生效,就调用报表API接口。

3. 获取access_token鉴权信息时,传入的客户端ID和密钥,不是开发者联盟界面“凭证”中服务器应用的ID和密钥。

解决方法:

  1. 开启流量报表API开关,在开发者联盟界面->我的API->选择对应的项目->点击“申请新的HMS API服务”,找到“流量变现服务报表API” 权限,点击“启用”。

  2. 流量报表API开关“停用”后,再次“启用”时,并非实时生效,需要等待大概6~10分钟。

  3. 检查获取access_token鉴权信息时,传入的客户端ID是否是服务器应用的。在开发者联盟界面->凭证->找到对应的项目->点击项目下应用的编辑按钮,即可在产品类型一行看到应用类型。如果不是服务器应用,请更换服务器应用的客户端ID和密钥后重试。

了解更多详情>>

访问广告服务官网

访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址:GitHubGitee

关注我们,第一时间了解 HMS Core 最新技术资讯~

有关如何获取广告服务流量变现数据,助力广告效果分析?的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri,根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 如何从 ruby​​ 中的字符串运行任意对象方法? - 2

    总的来说,我对ruby​​还比较陌生,我正在为我正在创建的对象编写一些rspec测试用例。许多测试用例都非常基础,我只是想确保正确填充和返回值。我想知道是否有办法使用循环结构来执行此操作。不必为我要测试的每个方法都设置一个assertEquals。例如:describeitem,"TestingtheItem"doit"willhaveanullvaluetostart"doitem=Item.new#HereIcoulddotheitem.name.shouldbe_nil#thenIcoulddoitem.category.shouldbe_nilendend但我想要一些方法来使用

  3. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封,在我看来soap请求没有正确的命名空间。任何人都可以建议我

  4. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声? - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点?我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等),但我确实想创建一个输出文件。

  5. ruby-on-rails - 如何验证 update_all 是否实际在 Rails 中更新 - 2

    给定这段代码defcreate@upgrades=User.update_all(["role=?","upgraded"],:id=>params[:upgrade])redirect_toadmin_upgrades_path,:notice=>"Successfullyupgradeduser."end我如何在该操作中实际验证它们是否已保存或未重定向到适当的页面和消息? 最佳答案 在Rails3中,update_all不返回任何有意义的信息,除了已更新的记录数(这可能取决于您的DBMS是否返回该信息)。http://ar.ru

  6. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗?当我运行compasswatch时,它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行?文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们?我自己编译的.sass文件编译成compiled/t

  7. ruby - 具有身份验证的私有(private) Ruby Gem 服务器 - 2

    我想安装一个带有一些身份验证的私有(private)Rubygem服务器。我希望能够使用公共(public)Ubuntu服务器托管内部gem。我读到了http://docs.rubygems.org/read/chapter/18.但是那个没有身份验证-如我所见。然后我读到了https://github.com/cwninja/geminabox.但是当我使用基本身份验证(他们在他们的Wiki中有)时,它会提示从我的服务器获取源。所以。如何制作带有身份验证的私有(private)Rubygem服务器?这是不可能的吗?谢谢。编辑:Geminabox问题。我尝试“捆绑”以安装新的gem..

  8. ruby - 如何将脚本文件的末尾读取为数据文件(Perl 或任何其他语言) - 2

    我正在寻找执行以下操作的正确语法(在Perl、Shell或Ruby中):#variabletoaccessthedatalinesappendedasafileEND_OF_SCRIPT_MARKERrawdatastartshereanditcontinues. 最佳答案 Perl用__DATA__做这个:#!/usr/bin/perlusestrict;usewarnings;while(){print;}__DATA__Texttoprintgoeshere 关于ruby-如何将脚

  9. ruby - 解析 RDFa、微数据等的最佳方式是什么,使用统一的模式/词汇(例如 schema.org)存储和显示信息 - 2

    我主要使用Ruby来执行此操作,但到目前为止我的攻击计划如下:使用gemsrdf、rdf-rdfa和rdf-microdata或mida来解析给定任何URI的数据。我认为最好映射到像schema.org这样的统一模式,例如使用这个yaml文件,它试图描述数据词汇表和opengraph到schema.org之间的转换:#SchemaXtoschema.orgconversion#data-vocabularyDV:name:namestreet-address:streetAddressregion:addressRegionlocality:addressLocalityphoto:i

  10. ruby - 如何指定 Rack 处理程序 - 2

    Rackup通过Rack的默认处理程序成功运行任何Rack应用程序。例如:classRackAppdefcall(environment)['200',{'Content-Type'=>'text/html'},["Helloworld"]]endendrunRackApp.new但是当最后一行更改为使用Rack的内置CGI处理程序时,rackup给出“NoMethodErrorat/undefinedmethod`call'fornil:NilClass”:Rack::Handler::CGI.runRackApp.newRack的其他内置处理程序也提出了同样的反对意见。例如Rack

随机推荐