game-sdk/simplewind/vendor/tencent-ad/marketing-api-php-sdk/examples/WechatAds/AddWechatMomentAdsWithLinkPage.php

<?php
require_once __DIR__ . '/../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;

/*****
 * 本文件提供了一个创建一个微信推广Android App的朋友圈双落地页单图广告的示例
 */
class AddWechatMomentAdsWithLinkPage
{
    public static $tads;
    public static $ACCESS_TOKEN           = 'YOUR ACCESS TOKEN';
    public static $ACCOUNT_ID             = 'YOUR ACCOUNT ID';
    public static $ANDROID_APP_ID         = 'YOUR APP ID'; // 这里放被推广的Android App的ID，即应用宝ID
    public static $ADCREATIVE_TEMPLATE_ID = 310; // 单图规格
    public static $PROMOTED_OBJECT_TYPE   = 'PROMOTED_OBJECT_TYPE_APP_ANDROID'; // 推广Android App
    public static $IMAGE_PATH             = 'YOUR AD IMAGE PATH'; // 广告主图文件路径，310规格要求：640x800, <300K, png/jpg
    public static $IMAGE_ID               = ''; // 如果已经有图片的，可提供Image ID
    public static $IMAGE_PROFILE_PATH     = 'YOUR AD IMAGE PATH'; // 如果未创建Profile的，提供Profile图片文件路径，200x200, <300K, png/jpg
    public static $PROFILE_ID             = ''; // 如果已经创建Profile的，可提供Profile ID
    public static $WECHAT_PAGE_ID         = 'YOUR WECHAT PAGE ID'; // 原生页ID
    public static $AD_TITLE               = 'YOUR AD TEXT'; // 广告文案，310规格要求：字数：1~40
    public static $PAGE_TYPE              = 'PAGE_TYPE_CANVAS_WECHAT'; // 外层落地页：原生页
    public static $LINK_PAGE_TYPE         = 'LINK_PAGE_TYPE_CANVAS_WECHAT'; // 行动按钮跳转落地页：原生页
    public static $LINK_NAME_TYPE         = 'DOWNLOAD_APP'; // 行动按钮：下载应用

    public function init()
    {
        $tads = TencentAds::init([
            'access_token' => static::$ACCESS_TOKEN,
            'is_debug'     => true,
        ]);
        $tads->useSandbox(); // 默认访问沙箱环境，如访问正式环境，请切换为$tads->useProduction()
        static::$tads = $tads;

        return $tads;
    }

    public function main()
    {
        try {
            /* @var TencentAds $tads */
            $tads = static::$tads;

            // 第一步，创建推广计划
            $campaignType = 'CAMPAIGN_TYPE_NORMAL';
            $promotedObjectType = static::$PROMOTED_OBJECT_TYPE;
            $campaignId = $this->AddCampaign($tads, $campaignType, $promotedObjectType);
            // echo 'Campaign ID: ' . $campaignId . PHP_EOL;

            // 第二步，创建推广目标
            $promotedObjectId = $this->AddPromotedObject($tads, $promotedObjectType, static::$ANDROID_APP_ID);
            // echo 'Promoted object ID: ' . $promotedObjectId . PHP_EOL;

            // 第三步，创建广告组，不允许使用定向包，因此在广告组里创建定向
            $siteSet = ['SITE_SET_MOMENTS']; // 投放朋友圈流量
            $adgroupId = $this->AddAdgroup($tads, $campaignId, $promotedObjectType, $promotedObjectId, $siteSet);
            // echo 'Adgroup ID: ' . $adgroupId . PHP_EOL;

            // 第四步，上传素材
            if (empty(static::$IMAGE_ID)) {
                $imageId = $this->AddImage($tads, static::$IMAGE_PATH);
                // echo 'Image ID: ' . $imageId . PHP_EOL;
            } else {
                $imageId = static::$IMAGE_ID;
            }

            if (empty(static::$PROFILE_ID)) {
                $imageIdLeads = $this->AddImage($tads, static::$IMAGE_PROFILE_PATH);
                // echo 'Image ID: ' . $imageIdLeads . PHP_EOL;
                $profileId = $this->AddProfile($tads, $promotedObjectType, $imageIdLeads);
                // echo 'Profile ID: ' . $profileId . PHP_EOL;
            } else {
                $profileId = static::$PROFILE_ID;
            }

            // 第五步，创建创意
            $adcreativeId = $this->AddAdcreative($tads, static::$ADCREATIVE_TEMPLATE_ID, $campaignId,
                $promotedObjectType, $promotedObjectId, $siteSet, $imageId, static::$AD_TITLE, $profileId,
                static::$WECHAT_PAGE_ID);
            // echo 'Adcreative ID: ' . $adcreativeId . PHP_EOL;

            // 第六步，创建广告
            $adId = $this->AddAd($tads, $adgroupId, $adcreativeId);

            // echo 'Ad ID: ' . $adId . PHP_EOL;

            return $adId;
        } catch (TencentAdsResponseException $e) {
            // When Api returns an error
            echo 'Tencent ads returned an error: ' . $e->getMessage() . PHP_EOL;
            throw $e;
        } catch (TencentAdsSDKException $e) {
            // When validation fails or other local issues
            echo 'Tencent ads SDK returned an error: ' . $e->getMessage() . PHP_EOL;
            throw $e;
        } catch (Exception $e) {
            echo 'Other exception: ' . $e->getMessage() . PHP_EOL;
            throw $e;
        }
    }

    // 创建朋友圈推广计划
    private function AddCampaign(TencentAds $tads, $campaignType, $promotedObjectType)
    {
        $campaignName = 'SDK计划' . uniqid();
        $campaignDailyBudget = 0;  // 不限日预算

        $campaign = $tads->campaigns()
                         ->add([
                             'account_id'           => static::$ACCOUNT_ID,
                             'campaign_name'        => $campaignName,
                             'campaign_type'        => $campaignType,
                             'promoted_object_type' => $promotedObjectType,
                             'daily_budget'         => $campaignDailyBudget,
                         ]);
        $campaignId = $campaign->getCampaignId();

        return $campaignId;
    }

    // 创建Android App推广目标
    private function AddPromotedObject(TencentAds $tads, $promotedObjectType, $promotedObjectId)
    {
        $promotedObjects = $tads->promotedObjects()
                                ->get([
                                    'account_id' => static::$ACCOUNT_ID,
                                    'filtering'  => [
                                        [
                                            'field'    => 'promoted_object_id',
                                            'operator' => 'EQUALS',
                                            'values'   => [$promotedObjectId],
                                        ],
                                    ],
                                ]);
        if (count($promotedObjects->getList()) > 0) {
            // 从App Store更新推广目标的信息
            $promotedObjects = $tads->promotedObjects()
                                    ->update([
                                        'account_id'           => static::$ACCOUNT_ID,
                                        'promoted_object_type' => $promotedObjectType,
                                        'promoted_object_id'   => $promotedObjectId,
                                    ]);
        } else {
            // 创建推广目标
            $promotedObjects = $tads->promotedObjects()
                                    ->add([
                                        'account_id'           => static::$ACCOUNT_ID,
                                        'promoted_object_type' => $promotedObjectType,
                                        'promoted_object_id'   => $promotedObjectId,
                                    ]);
        }

        return $promotedObjectId;
    }

    // 创建广告组
    private function AddAdgroup(
        TencentAds $tads,
        $campaignId,
        $promotedObjectType,
        $promotedObjectId,
        $siteSet
    ) {
        $adgroupName = 'SDK sample adgroup ' . uniqid();
        $beginDate = date('Y-m-d', strtotime('+1 day')); // 开始投放日期
        $endDate = date('Y-m-d', strtotime('+10 day')); // 结束投放日期
        $bidMode = 'BID_MODE_OCPM'; // CPM
        $bidStrategy = 'BID_STRATEGY_AVERAGE_COST'; // 稳定拿量
        $bidAmount = 20000; // 200元（单位为分）
        $optimizationGoal = 'OPTIMIZATIONGOAL_APP_ACTIVATE'; // 优化目标APP激活
        $timeSeries = str_repeat('1', 48 * 7); // 全天投放
        $adgroupDailyBudget = 1000000; // 日预算10000元（单位为分）
        $expandEnabled = true; // 开启自动扩量
        $expandTargeting = ['age', 'geo_location', 'gender']; // 自动扩量定向范围

        $regionIds = ['310000', '110000']; // 上海，北京，朋友圈广告地域只能位于同一级别
        $targeting = [
            'age'          => [
                [ // 年龄定向，23~45岁
                  'min' => 23,
                  'max' => 45,
                ],
            ],
            'gender'       => ['MALE'], // 性别定向，男性
            'geo_location' => [ // 地域定向
                                'location_types' => ['LIVE_IN'],
                                'regions'        => $regionIds,
            ],
            'user_os'      => ['ANDROID'], // 操作系统定向
        ];

        $adgroup = $tads->adgroups()
                        ->add([
                            'account_id'           => static::$ACCOUNT_ID,
                            'campaign_id'          => $campaignId,
                            'adgroup_name'         => $adgroupName,
                            'promoted_object_type' => $promotedObjectType,
                            'begin_date'           => $beginDate,
                            'end_date'             => $endDate,
                            'bid_mode'             => $bidMode,
                            'bid_strategy'         => $bidStrategy,
                            'bid_amount'           => $bidAmount,
                            'optimization_goal'    => $optimizationGoal,
                            'time_series'          => $timeSeries,
                            'site_set'             => $siteSet,
                            'daily_budget'         => $adgroupDailyBudget,
                            'promoted_object_id'   => $promotedObjectId,
                            'targeting'            => $targeting,
                            'expand_enabled'       => $expandEnabled,
                            'expand_targeting'     => $expandTargeting,
                        ]);
        $adgroupId = $adgroup->getAdgroupId();

        return $adgroupId;
    }

    // 上传素材
    private function AddImage(TencentAds $tads, $imageFile)
    {
        $imageSignature = md5_file($imageFile);
        $uploadType = 'UPLOAD_TYPE_FILE';
        $image = $tads->images()
                      ->add([
                          'account_id'  => static::$ACCOUNT_ID,
                          'upload_type' => $uploadType,
                          'file'        => $imageFile,
                          'signature'   => $imageSignature,
                      ]);
        $imageId = $image->getImageId();

        return $imageId;
    }

    // 创建profile
    protected function AddProfile(TencentAds $tads, $promotedObjectType, $imageId)
    {
        $profile = $tads->profiles()
                        ->add([
                            'account_id'           => static::$ACCOUNT_ID,
                            'profile_name'         => 'SDK用例' . uniqid(),
                            'profile_type'         => 'PROFILE_TYPE_DEFINITION',
                            'promoted_object_type' => $promotedObjectType,
                            'head_image_id'        => $imageId,
                            'description'          => 'SDK sample',
                        ]);

        return $profile->getProfileId();
    }

    // 创建创意
    private function AddAdcreative(
        TencentAds $tads,
        $adcreativeTemplateId,
        $campaignId,
        $promotedObjectType,
        $promotedObjectId,
        $siteSet,
        $imageId,
        $adTitle,
        $profileId,
        $wechatPageId
    ) {
        $adcreativeName = 'SDK sample adcreative ' . uniqid();
        $adcreativeElements = [
            'image_list' => [$imageId],
            'title'      => $adTitle,
        ];
        $shareContentSpec = [
            'share_title'       => '分享',
            'share_description' => '分享详情',
        ];
        $pageSpec = [
            'page_id'                     => $wechatPageId,
            'override_canvas_head_option' => 'OPTION_CANVAS_OVERRIDE_CREATIVE',
        ];
        $linkPageSpec = [
            'page_id' => $wechatPageId,
        ];

        $adcreative = $tads->adcreatives()
                           ->add([
                               'account_id'             => static::$ACCOUNT_ID,
                               'campaign_id'            => $campaignId,
                               'adcreative_name'        => $adcreativeName,
                               'adcreative_template_id' => $adcreativeTemplateId,
                               'adcreative_elements'    => $adcreativeElements,
                               'promoted_object_type'   => $promotedObjectType,
                               'page_type'              => static::$PAGE_TYPE,
                               'page_spec'              => $pageSpec,
                               'site_set'               => $siteSet,
                               'promoted_object_id'     => $promotedObjectId,
                               'link_page_type'         => static::$LINK_PAGE_TYPE,
                               'link_name_type'         => static::$LINK_NAME_TYPE,
                               'link_page_spec'         => $linkPageSpec,
                               'profile_id'             => $profileId,
                               'share_content_spec'     => $shareContentSpec,
                           ]);
        $adcreativeId = $adcreative->getAdcreativeId();

        return $adcreativeId;
    }

    // 创建广告
    private function AddAd(TencentAds $tads, $adgroupId, $adcreativeId)
    {
        $adName = 'SDK sample ad ' . uniqid();

        $ad = $tads->ads()
                   ->add([
                       'account_id'    => static::$ACCOUNT_ID,
                       'adgroup_id'    => $adgroupId,
                       'adcreative_id' => $adcreativeId,
                       'ad_name'       => $adName,
                   ]);
        $adId = $ad->getAdId();

        return $adId;
    }
}

if (basename($_SERVER['PHP_SELF']) == basename(__FILE__)) {
    try {
        $example = new AddWechatMomentAdsWithLinkPage();
        $example->init();
        $example->main();
    } catch (\Exception $e) {
        exit(-1);
    }
}