如何检索我所有活跃的Facebook广告?

时间:2017-04-05 17:02:35

标签: php facebook-php-sdk facebook-ads-api facebook-insights facebook-marketing-api

我正在为自己创建一个仪表板,帮助我跟踪我正在运行的Facebook广告。

我无法弄清楚的是:

如何在我没有采取进一步行动后立即为所有活跃的广告检索一系列广告ID?

换句话说,我希望我已设置为“有效”的所有广告以及活跃的广告和广告系列中存在的广告(因此这些广告现在正在播放)... plus 所有来自我的视角的广告都是有效的,但Facebook已设置为其他状态,例如待审核(并很快会重新启用)。

我下面有一些代码,但问题是它意外地包含待定广告 - 一旦经过Facebook审核和批准 - 将处于非活动状态而非活动状态(因为我'我们这样设置他们)。我不希望此类广告包含在我的报告中。

我的报告只能告诉我,一旦FB批准,我就会积极地花钱或有可能花钱。

我想我理解configured_statuseffective_statusAbstractArchivableCrudObjectFields之间的区别,但我不知道它足以帮助我,因为我有很多广告设置为“有效”,这些广告位于非活动状态的广告集中,我不想查看报告中列出的广告。

有什么建议吗?

public function getActiveAdIds() {
    $key = 'activeAdIds';
    $adIdsJson = Cache::get($key);
    if ($adIdsJson) {
        $adIds = json_decode($adIdsJson);
    } else {
        $adsResponse = $this->getAdsByStatus([ArchivableCrudObjectEffectiveStatuses::ACTIVE, ArchivableCrudObjectEffectiveStatuses::PENDING_REVIEW]);
        $ads = $adsResponse->data;
        $adIds = [];
        foreach ($ads as $ad) {
            $adIds[] = $ad->id;
        }
        $adIdsJson = json_encode($adIds);
        Cache::put($key, $adIdsJson, 1);
    }
    return $adIds;
}

public function getAdsByStatus($statuses) {
    $params = [\FacebookAds\Object\Fields\AbstractArchivableCrudObjectFields::EFFECTIVE_STATUS => $statuses];
    $adAccount = new AdAccount(self::ACT_PREPEND . $this->fbConfig['account_id']);
    $cursor = $adAccount->getAds([], $params);
    $response = $cursor->getResponse();
    $jsonString = $response->getBody();
    return json_decode($jsonString);
}

2 个答案:

答案 0 :(得分:1)

我根据活动广告系列的资产获取统计信息。我有119个广告帐户。这是我用于此目的的PHP代码(任何改进它的建议将不胜感激):

    $fields = array(AdsInsightsFields::ACCOUNT_NAME,AdsInsightsFields::CAMPAIGN_ID,
                    AdsInsightsFields::CAMPAIGN_NAME, AdsInsightsFields::ADSET_ID,
                    AdsInsightsFields::ADSET_NAME,AdsInsightsFields::DATE_START,
                    AdsInsightsFields::DATE_STOP,AdsInsightsFields::REACH,
                    AdsInsightsFields::SPEND, AdsInsightsFields::IMPRESSIONS,
                    AdsInsightsFields::CLICKS, AdsInsightsFields::WEBSITE_CLICKS,
                    AdsInsightsFields::CALL_TO_ACTION_CLICKS,AdsInsightsFields::ACTIONS,
                    AdsInsightsFields::TOTAL_ACTIONS,AdsInsightsFields::CPC,
                    AdsInsightsFields::CPM,AdsInsightsFields::CPP,
                    AdsInsightsFields::CTR,AdsInsightsFields::OBJECTIVE,);
    $params_c['date_preset'] = AdDatePresetValues::YESTERDAY;
    $params_c['time_increment'] = 1;
    $params_c['action_attribution_windows'] = array('1d_view', '28d_click');
    $params_c['effective_status'] = AdStatusValues::ACTIVE;
    $params_c['level'] = AdsInsightsLevelValues::ADSET;
    $params_c['filtering'] = [array("field"=>"campaign.delivery_info", 
                                   "operator"=>"IN",
                                    "value"=>array("active"))];
    $params_c['fields']= $fields;     
    try{
         // Initialize a new Session and instanciate an Api object
        Api::init(self::api_key, self::secret_token, self::extended_token)->getHttpClient()->setCaBundlePath( $this->path_cert);

        // The Api object is now available trough singleton
        $api = Api::instance();
        $user = new \FacebookAds\Object\Business($business_id);
        $user->read(array(BusinessFields::ID));

        //get all ad_account from Business
        $accounts = $user->getAssignedAdAccounts(
                      array(
                    AdAccountFields::ID,
                 ),
                  array('limit'=>1000,)
                );                                    

    } catch (FacebookAds\Exception\Exception $ex) {
        return $ex->getMessage();
    }   

    if(isset($accounts) && ($accounts->count() > 0)):           
        do{

            $ad_account = $accounts->current();            
            $adset_insights = $ad_account->getInsights($fields,$params_c); 

            do {
                $adset_insights->fetchAfter();
            } while ($adset_insights->getNext());

            $adsets = $adset_insights->getArrayCopy(true); 
    }
    while ($accounts->current());    
    endif;

答案 1 :(得分:0)

如果您在广告查询中包含adset{end_time}字段,则可以假定如果end_time是过去的时间,则该广告实际上并未在投放。这是我们获取要查询的广告基本列表的方式。

我们采取的下一步(不幸的是,可能无法帮助您,但可能会帮助其他人)正在构建一批简单的请求(每个广告一个),以查看当天是否有任何见解数据。如果响应为空的“数据”数组,我们可以从广告列表中删除该ID。

通过上述两个步骤减小了广告列表的大小之后,我们可以请求运行所有细分报告。这种方法几乎将我们的API请求减少了一半。

我还没有找到一种方法来一步执行“给我所有肯定可以投放的广告”查询。

编辑: 我只是找到了一种更好的方法来做到这一点...:

curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
-d 'level=campaign' \
-d 'filtering=[{field:"ad.impressions",operator:"GREATER_THAN",value:0}]' \
'https://graph.facebook.com/v2.7/act_<ACCOUNT_ID>/insights'