doc: 广告配置说明

TODO.md

@@ -1,25 +1,85 @@
-## 腾讯广告MarketingAPI oauth授权功能
+## 创建计划与创意
 
-授权文档地址: https://developers.e.qq.com/v3.0/docs/api/oauth/authorize
+第一种情况：
 
-获取token: https://developers.e.qq.com/v3.0/docs/api/oauth/token
+营销目的：marketing_goal=MARKETING_GOAL_LEAD_RETENTION 线索留资； 
 
-刷新 Refresh Token: http://developers.e.qq.com/v3.0/docs/api/oauth/refresh_token
+营销载体类型：marketing_carrie_type=MARKETING_CARRIER_TYPE_JUMP_PAGE 页面跳转
 
-- 生成授权表结构
-- 获取token
-- 生成定时任务维护token
+广告优化目标：optimization_goal= OPTIMIZATIONGOAL_PAGE_SCAN_CODE 加企业微信客服
 
-参考例子
-福建茂同刘文化传媒有限公司南 66612379 线索企微
-福建茂同刘文化传媒有限公司南 76057781 roi 
 
-测试主体与账号
-苏州凤武传媒有限公司上海第一分公司 69781948
+当推广产品类型是:MARKETING_TARGET_TYPE_WECHAT_WORK时候用marketing_asset_outer_spec
 
-44035150
-// https://developers.e.qq.com/v3.0/docs/api/marketing_target_assets/get
-短剧商品
-ab05e0b9cbcd5e5df224f493835f8df9
-69781948
-MARKETING_TARGET_TYPE_SHORT_DRAMA
+产品 id，marketing_asset_id 与 marketing_asset_outer_spec 不能同时为空，也不能同时使用
+产品外部 id 数据:
+marketing_asset_outer_spec
+    marketing_target_type: MARKETING_TARGET_TYPE_WECHAT_WORK
+    marketing_asset_outer_id: 企业微信主体ID
+创意增强 MAX 开关： auto_derived_creative_enabled=true
+
+投放站点 siteSet=[]
+
+bidMode = BID_MODE_OCPM
+转化ID conversion_id=1L
+
+第二种情况：
+营销目的：marketing_goal=MARKETING_GOAL_USER_GROWTH 用户增长
+营销载体： marketing_carrie_type = MARKETING_CARRIER_TYPE_JUMP_PAGE 页面跳转
+
+优化目标：optimization_goal= OPTIMIZATIONGOAL_APP_REGISTER 注册
+营销资产ID： marketing_asset_id=短剧ID
+投放站点： siteSet=[]
+bidMode = BID_MODE_OCPM
+转化ID conversion_id=1L
+创意增强 MAX 开关： auto_derived_creative_enabled=true
+
+
+定向详细设置 targeting
+    性别 gender = MALE 男性
+    地理位置定向 geo_location regions = []
+    年龄： age=[ageRange]
+    排除人群包ID： excluded_custom_audience=[]
+
+siteSet=
+SITE_SET_MOBILE_UNION 优量汇
+SITE_SET_WECHAT 微信公众号与小程序
+SITE_SET_TENCENT_NEWS 腾讯新闻
+SITE_SET_TENCENT_VIDEO 腾讯视频
+SITE_SET_MOBILE_YYB 应用宝
+SITE_SET_PCQQ 腾讯广告电脑端（PC）
+SITE_SET_KANDIAN QQ 浏览器（原腾讯看点）
+SITE_SET_QQ_MUSIC_GAME QQ、腾讯音乐及游戏
+SITE_SET_MOMENTS 微信朋友圈
+SITE_SET_CHANNELS 微信视频号
+SITE_SET_WECHAT_SEARCH 微信搜一搜（仅支持搜索广告）
+SITE_SET_WECHAT_PLUGIN 微信新闻插件
+SITE_SET_QBSEARCH QQ 浏览器等（仅支持搜索广告）
+SITE_SET_SEARCH_SCENE 搜索场景
+SITE_SET_SEARCH_MOBILE_UNION 搜索优量汇
+SITE_SET_SMART 自动版位（仅供智能投放报表展示）
+
+
+
+创意：
+
+情况一：
+
+投放模式 delivery_mode=DELIVERY_MODE_COMPONENT 组件化创意
+创意组建： creative_components = {
+    title: [],
+    description: [],
+    image: [{image_id: "121212"}],
+    video: [],
+    品牌形象 brand: {brand_name: "1212", brand_image_id: "121212"}
+    main_jump_info: [{
+        page_type: PAGE_TYPE_OFFICIAL,
+        page_spec: {
+            official_spec : { //蹊径落地页数据 
+                page_id
+            }
+        }
+    }],
+    action_button: [{
+        value: {button_text: "2222"}
+    }]

src/test/java/com/moka/gdtauto/service/TencentAdsAdgroupCreateTest.java

@@ -101,6 +101,7 @@ class TencentAdsAdgroupCreateTest {
         //营销资产外部规格 : 企业微信
         MarketingAssetOuterSpec outerSpec = new MarketingAssetOuterSpec();
         outerSpec.setMarketingTargetType(MarketingTargetType.WECHAT_WORK);
+        
         // 产品外部 id 数据 : 企业微信ID 
         outerSpec.setMarketingAssetOuterId("wp7eXwDAAAC2oIBdHTa0-QV8KNGDd3mA");
         request.setMarketingAssetOuterSpec(outerSpec);
@@ -129,6 +130,8 @@ class TencentAdsAdgroupCreateTest {
         
         // 出价金额（单位：分）
         request.setBidAmount(100L);
+        // 出价场景 常规投放-稳定投放
+        request.setBidScene(BidScene.NORMAL_AVERAGE);
         
         // 日预算（单位：分）
         request.setDailyBudget(10000L);
@@ -184,16 +187,23 @@ class TencentAdsAdgroupCreateTest {
         age.add(ageRange);
         targeting.setAge(age);
 
-        // 排除转化用户
+
+        //排除已转化用户：同集团（自定义转化行为：指定页面曝光,加企业微信客服）（转化时间区间：1个月）
+        // 排除已转化人群行为定向，排除已转化用户定向范围
         ExcludedConvertedAudience excludedConverted = new ExcludedConvertedAudience();
+        // 排除已转化人群行为定向 EXCLUDED_DIMENSION_GROUP 集团
         excludedConverted.setExcludedDimension(ExcludedDimension.EXCLUDED_DIMENSION_GROUP);
         
+        //转化行为
         List<String> conversionBehaviorList = new ArrayList<>();
-        conversionBehaviorList.add("OPTIMIZATIONGOAL_BRAND_CONVERSION");
-        conversionBehaviorList.add("OPTIMIZATIONGOAL_PAGE_SCAN_CODE");
+        conversionBehaviorList.add("OPTIMIZATIONGOAL_BRAND_CONVERSION"); //品牌转化
+        conversionBehaviorList.add("OPTIMIZATIONGOAL_PAGE_SCAN_CODE"); //加企业微信客服
         excludedConverted.setConversionBehaviorList(conversionBehaviorList);
         
+        // 转化时间区间：1个月
+        //排除天数 EXCLUDED_DAY_ONE_MONTH 1 个月
         excludedConverted.setExcludedDay(ExcludedDay.ONE_MONTH);
+        // 排除已转化人群行为定向，排除已转化用户定向范围
         targeting.setExcludedConvertedAudience(excludedConverted);
 
         // 排除自定义人群

src/test/java/com/moka/gdtauto/service/TencentAdsAdgroupROICreateTest.java

@@ -98,6 +98,7 @@ class TencentAdsAdgroupROICreateTest {
         request.setAccountId(accountId);
         request.setMarketingGoal(MarketingGoal.USER_GROWTH);
         request.setMarketingCarrierType(MarketingCarrierType.JUMP_PAGE);
+        // 营销资产ID
         request.setMarketingAssetId(421635930L);
 
         
@@ -140,9 +141,6 @@ class TencentAdsAdgroupROICreateTest {
         // 转化 id
         request.setConversionId(72627668L);
         
-        // 自动衍生创意
-        request.setAutoDerivedCreativeEnabled(false);
-        
         // 出价场景
         request.setBidScene(BidScene.UNKNOWN);
         
@@ -414,13 +412,15 @@ class TencentAdsAdgroupROICreateTest {
         actionButtonValue2.setButtonText("查看详情");
         actionButton2.setValue(actionButtonValue2);
         actionButtons.add(actionButton2);
-        components.setActionButton(actionButtons);
         // 点击查看
         ActionButtonComponent actionButton3 = new ActionButtonComponent();
         ActionButtonStruct actionButtonValue3 = new ActionButtonStruct();
         actionButtonValue3.setButtonText("查看详情");
         actionButton3.setValue(actionButtonValue3);
         actionButtons.add(actionButton3);
+
+        
+        components.setActionButton(actionButtons);
     
                 
         return components;

广告计划配置.md

@@ -0,0 +1,26 @@
+{
+    accountIds: [long] 多个账号可叉乘
+    marketingGoal: "MARKETING_GOAL_LEAD_RETENTION | MARKETING_GOAL_USER_GROWTH",
+    marketingCarrieType: "MARKETING_CARRIER_TYPE_JUMP_PAGE"
+    optimizationGoal: "OPTIMIZATIONGOAL_PAGE_SCAN_CODE |  OPTIMIZATIONGOAL_APP_REGISTER"
+    marketingAssetOuterId: [ "string"] 企业微信主体ID 多条可叉乘
+    marketingAssetId: [long] 短剧ID 多条可叉乘
+    sites: [["string"], ["string"]]  关键叉乘位置，输入【N】组这样的组数 必选小程序封面广告，小程序原生广告，小程序插屏广告这三个位置，其他位置均可随机组合
+    conversionId: long
+    regions: [long] 固定2组，叉乘
+    gender: "MALE",
+    ageRange: [{
+        min: 45,
+        max: 64
+    }],
+    bidAmount:long 出价 （分）
+    bidScene: "BID_SCENE_NORMAL_AVERAGE" 常规投放-稳定投放
+    dailyBudget: 0 日预算 设置为 0 表示不设预算（即不限）； （分）
+    deepConversionWorthRate:float 期望ROI
+    excludedCustomAudience: [long]
+    imageIds: [string],
+    titles: [string],
+    descriptions: [string],
+    pageIds: [long]
+    buttonTexts: [string]
+}