Pemirsa Khusus Aplikasi Seluler

Buat pemirsa berdasarkan tindakan pengguna di aplikasi Anda, yang sesuai dengan kriteria Anda. Fitur ini memungkinkan Anda membangun pemirsa yang:

• "Lulus Level 8 dalam 10 hari terakhir"
• "Telah menggunakan aplikasi dalam 8 hari terakhir tetapi belum membeli apa pun"
• "Telah menambahkan ke keranjang tetapi belum membeli"

Solusi ini menggunakan peristiwa bernama yang dicatat melalui Facebook SDK, App Events API, atau melalui Mobile Measurement Partner. Contoh peristiwa untuk dicatat termasuk "Diinstal", "Ditambahkan ke Keranjang", "Dibeli", atau "Mencapai Level".

Batasan

• subtype untuk interaksi pemirsa khusus hanya didukung untuk video.
• Pemirsa Khusus Aplikasi Seluler untuk penargetan penyertaan tidak lagi didukung untuk endpoint POST /{ad-account-id}/adsets bagi kampanye SKADNetwork iOS 14.5.
• Kampanye instalasi aplikasi iOS 14.5 baru tidak dapat lagi menggunakan penargetan koneksi aplikasi.

Buat Pemirsa

Untuk membuat Pemirsa Khusus dari aplikasi seluler Anda, akun iklan harus menerima Ketentuan Layanan untuk Pemirsa Khusus, di Pengelola Iklan. Untuk menandatangani ketentuan:

• Anda harus menjadi Admin, Developer, atau Pengguna Insight untuk akun iklan.
• Akun iklan harus tercantum sebagai Akun iklan di pengaturan aplikasi Anda.

Untuk membuat pemirsa khusus:

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/v19.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',
})

Ini akan mengembalikan id pemirsa jika berhasil. Parameter ini adalah yang paling relevan:

Tiap akun iklan dapat membuat maksimal 200 pemirsa khusus melalui Pemirsa Khusus dari Aplikasi Seluler Anda. Buat permintaan POST untuk:

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

Gunakan kolom ini:

Aturan Pemirsa

Untuk menentukan siapa yang ditambahkan ke Pemirsa Khusus, tentukan aturan berdasarkan peristiwa di aplikasi. Aturan adalah objek JSON dengan pasangan nilai-kunci dan dapat mereferensikan beberapa peristiwa aplikasi. Anda dapat menentukan aturan berdasarkan peristiwa tertentu dan parameternya serta agregasi. Lihat Aturan Pemirsa untuk informasi selengkapnya. Lihat juga:

• Sintaks Aturan Pemirsa
• Sintaks Set Aturan
• Sintaks Aturan Inklusi dan Pengecualian: Di bawah event_sources, atur id ke ID aplikasi Anda dan type ke app.
• Filter
• Aturan Filter:

  • Gunakan 'event' sebagai field, jika filter untuk menentukan peristiwa. Parameter yang cocok dengan Peristiwa aplikasi yang dikirim oleh aplikasi; misalnya, "_appVersion", "_value", dan sebagainya.
  • Jika atribut field diatur menjadi "event", nilai harus diatur menjadi nama peristiwa. Gunakan API Peristiwa Aplikasi untuk melihat peristiwa aplikasi dan parameter yang dilaporkan oleh pixel.
• Fungsi Agregat: Fungsi agregasi berikut tersedia untuk Pemirsa Khusus Aplikasi Seluler: "count","sum", "avg", "min", dan "max".

Contoh Aturan Pemirsa Khusus Aplikasi Seluler

Contoh peristiwa standar

Semua pembeli aplikasi seluler dalam 30 hari terakhir untuk id aplikasi 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"
                        }
                    ]
                }
            }
        ]
    }
}

Peristiwa khusus dengan contoh parameter

Semua pengguna yang mengirimkan kembali peristiwa “timeOnPanel” khusus dalam 30 hari terakhir untuk id aplikasi 55064006:

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

Semua pengguna yang mengirimkan kembali peristiwa “timeOnPanel” khusus dengan nilai peristiwa lebih besar dari 30, warna adalah “red” atau “blue”, dan makanan pencuci mulut favorit berisi “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",
                        }
                    ]
                }
            }
        ]
    }
}

Contoh agregasi

Pembeli 20% teratas berdasarkan pembelian dalam 30 hari terakhir:

{
    "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,
                }
            }
        ]
    }
}

Contoh pengecualian

Contoh berikut mencakup orang yang menambahkan ke keranjang, tetapi tidak membeli:

{
    "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"
                        }
                    ]
                }
            }
        ]
    }
}

App Events API

Jalankan kueri untuk mengetahui peristiwa aplikasi dan parameter mana yang dilaporkan aplikasi ke Facebook. Anda dapat menggunakan peristiwa dan parameter ini secara langsung untuk membuat Pemirsa Khusus. Anda memerlukan token akses yang terkait dengan app_id dengan peran admin, developer, atau pengiklan.

Buat permintaan GET:

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

Tanggapannya berupa JSON yang memuat array data kamus JSON dengan kolom berikut:

Mengelola Pemirsa

• Untuk mendapatkan informasi tentang pemirsa khusus, lihat Pemirsa Khusus, Baca.
• Untuk memperbarui, lihat Pemirsa Khusus, Perbarui.
• Untuk menghapus, lihat Pemirsa Khusus, Hapus.

Sumber Informasi

• Aplikasi iOS, Menargetkan ulang dengan Peristiwa Aplikasi - Melibatkan kembali pengguna di aplikasi iOS Anda.
• Aplikasi Android, Menargetkan ulang dengan Peristiwa Aplikasi - Menargetkan ulang iklan di aplikasi Android Anda.
• Penargetan Pemirsa Khusus
• Penargetan Serupa
• Referensi, Spesifikasi Penargetan
• Referensi, Iklan Aplikasi Seluler untuk Interaksi