行動應用程式自訂廣告受眾

根據應用程式中符合條件的用戶動作建立廣告受眾。這項功能允許您建立廣告受眾，例如，廣告受眾可能符合以下條件：

• 「在過去 10 天成功通過第 8 關」
• 「在過去 8 天使用過應用程式，但沒有購買任何產品」
• 「將產品新增至購物車但尚未購買」

此解決方案會透過我們的 Facebook SDK、應用程式事件 API 或 Mobile Measurement Partners 使用已記錄的具名事件。要記錄的事件範例包括「已安裝」、「已加到購物車」、「已購買」或「破關」。

限制

• 自訂廣告受眾互動 subtype 只支援影片功能。
• iOS 14.5 SKAdNetwork 行銷活動的 POST /{ad-account-id}/adsets 端點不再支援用於包含目標設定的行動應用程式自訂廣告受眾。
• 新的 iOS 14.5 應用程式安裝行銷活動將無法再使用應用程式連線目標設定。

建立廣告受眾

若要使用行動應用程式建立自訂廣告受眾，廣告帳號必須先在廣告管理員中接受自訂廣告受眾的服務條款。簽署使用條款：

• 您必須是廣告帳號的管理員、開發人員或洞察報告用戶。
• 在您的應用程式設定中，您的廣告帳號應列為廣告帳號。

建立廣告受眾：

curl -X POST \
  -F 'name="My Test Website Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<APP_ID>",
                 "type": "app"
               }
             ],
             "retention_seconds": 8400,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "fb_mobile_purchase"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const CustomAudience = bizSdk.CustomAudience;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Test Website Custom Audience',
  'rule' : {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
  'prefill' : '1',
};
const customaudiences = (new AdAccount(id)).createCustomAudience(
  fields,
  params
);
logApiCallResult('customaudiences api call complete.', customaudiences);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\CustomAudience;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Test Website Custom Audience',
  'rule' => array('inclusions' => array('operator' => 'or','rules' => array(array('event_sources' => array(array('id' => '<appID>','type' => 'app')),'retention_seconds' => 8400,'filter' => array('operator' => 'and','filters' => array(array('field' => 'event','operator' => 'eq','value' => 'fb_mobile_purchase'))))))),
  'prefill' => '1',
);
echo json_encode((new AdAccount($id))->createCustomAudience(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.customaudience import CustomAudience
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Test Website Custom Audience',
  'rule': {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
  'prefill': '1',
}
print AdAccount(id).create_custom_audience(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createCustomAudience()
      .setName(\"My Test Website Custom Audience\")
      .setRule(\"{\\"inclusions\\":{\\"operator\\":\\"or\\",\\"rules\\":[{\\"event_sources\\":[{\\"id\\":\\"<appID>\\",\\"type\\":\\"app\\"}],\\"retention_seconds\\":8400,\\"filter\\":{\\"operator\\":\\"and\\",\\"filters\\":[{\\"field\\":\\"event\\",\\"operator\\":\\"eq\\",\\"value\\":\\"fb_mobile_purchase\\"}]}}]}}\")
      .setPrefill(true)
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
customaudiences = ad_account.customaudiences.create({
    name: 'My Test Website Custom Audience',
    rule: {'inclusions':{'operator':'or','rules':[{'event_sources':[{'id':'<appID>','type':'app'}],'retention_seconds':8400,'filter':{'operator':'and','filters':[{'field':'event','operator':'eq','value':'fb_mobile_purchase'}]}}]}},
    prefill: '1',
})

完成後即會傳回廣告受眾的 id。這些參數與下列項目最為相關：

每個廣告帳號皆可透過「行動應用程式自訂廣告受眾」建立最多 200 個自訂廣告受眾。向下列目的地發出 POST 要求：

https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/customaudiences

使用下列欄位：

廣告受眾規則

若要決定將哪些用戶加入「自訂廣告受眾」，請根據您應用程式中的事件來定義規則。規則是包含索引鍵值組的 JSON 物件，可參考多個應用程式事件。您可以根據特定的事件來定義規則，其參數也可彙總。如需詳細資訊，請參閱廣告受眾規則。另請參閱：

• 廣告受眾規則語法
• 規則集語法
• 包含和排除規則語法：在 event_sources 之下，將 id 設為應用程式的編號，將 type 設為 app。
• 篩選條件
• 篩選條件規則：

  • 若要以篩選條件指定事件，請使用 'event' 做為 field。符合應用程式所傳送應用程式事件的參數，例如「_appVersion」和「_value」等。
  • 如果 field 屬性設為 "event"，則必須將值設為事件名稱。使用應用程式事件 API 來查看像素所回報的應用程式事件與參數。
• 彙總函式：行動應用程式自訂廣告受眾可使用以下彙總函式："count"、"sum"、"avg"、"min" 和 "max"。

行動應用程式自訂廣告受眾規則範例

標準事件範例

在過去 30 天購買行動應用程式（應用程式編號 55064006）的所有用戶：

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
            }
        ]
    }
}

包含參數的自訂事件範例

在過去 30 天內針對應用程式編號 55064006 傳回自訂 “timeOnPanel” 事件的所有用戶：

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "timeOnPanel"
                        }
                    ]
                }
            }
        ]
    }
}

傳回自訂 “timeOnPanel” 事件的所有用戶，這些事件的事件值大於 30、顏色為 “red” 或 “blue”，而且最愛的甜點包含 “banana”：

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app",
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "timeOnPanel",
                        },
                        {
                            "field": "_value",
                            "operator": ">",
                            "value": 30,
                        },
                        {
                            "field": "color",
                            "operator": "is_any",
                            "value": ["red", "blue"],
                        },
                        {
                            "field": "favoriteDessert",
                            "operator": "contains",
                            "value": "banana",
                        }
                    ]
                }
            }
        ]
    }
}

彙總範例

根據過去 30 天內的購買記錄，前 20% 的購買者：

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
                "aggregation": {
                    "type": "count",
                    "method": "percentile",
                    "operator": "in_range",
                    "from": 75,  
                    "to": 100,
                }
            }
        ]
    }
}

排除範例

以下範例包含將產品新增至購物車但尚未購買的用戶：

{
    "inclusions: {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "add_to_cart"
                        }
                    ]
                }
            }
        ]
    },
    "exclusions": {
        "operator": "or",
        "rules": [    
            {
                "event_sources": [
                    {
                        "id": 55064006, 
                        "type": "app"
                    }
                ],
                "retention_seconds: 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "=",
                            "value": "fb_mobile_purchase"
                        }
                    ]
                }
            }
        ]
    }
}

應用程式事件 API

查詢應用程式向 Facebook 報告哪些應用程式事件及參數。您可將這些事件及參數直接用於建立自訂廣告受眾。您需提供與 app_id 相關，且擁有管理員、開發人員或廣告客戶角色的存取權杖。

發出 GET 要求：

https://graph.facebook.com/<API_VERSION>/<APP_ID>/app_event_types

回應為包含 JSON 字典 data 陣列的 JSON，並含有以下欄位：

管理廣告受眾

• 若要瞭解更多有關廣告受眾的資訊，請參閱自訂廣告受眾，讀取。
• 若要更新，請參閱自訂廣告受眾，更新。
• 若要刪除，請參閱自訂廣告受眾，刪除。

資源

• iOS 應用程式，使用應用程式事件重定目標 - 使用您的 iOS 應用程式與用戶再次互動。
• Android 應用程式，使用應用程式事件再次鎖定目標 - 使用您的 Android 應用程式再次鎖定廣告。
• 自訂廣告受眾目標設定
• 類似廣告受眾目標設定
• 參考資料，目標設定規格
• 參考資料，互動行動應用程式廣告