Chất lượng danh mục và tín hiệu

Bạn có thể lấy phản hồi về chất lượng và hiệu quả của các tài sản quảng cáo danh mục Advantage+ khác nhau theo 2 tùy chọn sau đây:

Các sự kiện trong ứng dụng và sự kiện pixel khớp và không khớp được liên kết với danh mục của bạn
Pixel và Ứng dụng được liên kết với danh mục của bạn

Phản hồi về sự kiện pixel và sự kiện trong ứng dụng dành cho danh mục

Để xác định sự cố xảy ra với quá trình cài đặt pixel hoặc ứng dụng, bạn có thể xem số liệu thống kê tổng hợp về những sự kiện khớp và không khớp nhận được từ các pixel, ứng dụng và thiết bị khác nhau.

Truy vấn API Sự kiện để tải số liệu thống kê về các sự kiện xuất phát từ những nguồn sự kiện được liên kết với danh mục của bạn. Hãy xem Tài liệu tham khảo về API Sự kiện để biết thêm chi tiết.

Số liệu thống kê về sự kiện

Bạn có thể tải thông tin này ở cấp độ danh mục như bên dưới:


curl -X GET \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PRODUCT_CATALOG_ID>/event_stats


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

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<PRODUCT_CATALOG_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 = {
};
const event_statss = (new ProductCatalog(id)).getEventStats(
  fields,
  params
);
logApiCallResult('event_statss api call complete.', event_statss);


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

use FacebookAds\Object\ProductCatalog;
use FacebookAds\Object\ProductEventStat;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

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

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

$fields = array(
);
$params = array(
);
echo json_encode((new ProductCatalog($id))->getEventStats(
  $fields,
  $params
)->getResponse()->getContent(), JSON_PRETTY_PRINT);


from facebook_business.adobjects.productcatalog import ProductCatalog
from facebook_business.adobjects.producteventstat import ProductEventStat
from facebook_business.api import FacebookAdsApi

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

fields = [
]
params = {
}
print ProductCatalog(id).get_event_stats(
  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 = \"<PRODUCT_CATALOG_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new ProductCatalog(id, context).getEventStats()
      .execute();

  }
}


require 'facebook_ads'

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

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

product_catalog = FacebookAds::ProductCatalog.get(id)
event_statss = product_catalog.event_stats({
    fields: {  },
})

Lệnh này trả về một mảng thành phần, mỗi thành phần cho một loại sự kiện, nguồn và ngày trong tháng vừa qua:

{
  "data": [
    {
      "date_start": "2017-03-16",
      "date_stop": "2017-03-16",
      "event": "AddToCart",
      "event_source": {
        "id": "<PIXEL_ID>",
        "source_type": "PIXEL"
      },
      "total_matched_content_ids": 1086,
      "total_content_ids_matched_other_catalogs": 10024,
      "total_unmatched_content_ids": 13024,
      "unique_matched_content_ids": 285,
      "unique_content_ids_matched_other_catalogs": 102,
      "unique_unmatched_content_ids": 2132
    },
    {
      "date_start": "2017-03-16",
      "date_stop": "2017-03-16",
      "event": "ViewContent",
      "event_source": {
        "id": "<APP_ID>",
        "source_type": "APP"
      },
      "total_matched_content_ids": 1007,
      "total_content_ids_matched_other_catalogs": 504,
      "total_unmatched_content_ids": 20206,
      "unique_matched_content_ids": 507,
      "unique_content_ids_matched_other_catalogs": 402,
      "unique_unmatched_content_ids": 8037
    },
    ...
  ]
}

Các trường được trả về cho từng loại sự kiện, nguồn và ngày là:

Số lượng	Mô tả
`total_matched_content_ids`	Tổng số ID nội dung từ các sự kiện nhận được khớp với một mặt hàng trong danh mục. Số lượng này tính cả các ID nội dung trùng lặp.
`total_content_ids_matched_other_catalogs`	Tổng số ID nội dung từ các sự kiện nhận được khớp với một mặt hàng trong một danh mục khác được liên kết với pixel hoặc ứng dụng cụ thể. Số lượng này tính cả các ID nội dung trùng lặp.
`total_unmatched_content_ids`	Tổng số ID nội dung từ các sự kiện nhận được không khớp với mặt hàng trong danh mục. Số lượng này tính cả các ID nội dung trùng lặp.
`unique_matched_content_ids`	Số ID nội dung duy nhất từ các sự kiện nhận được khớp với một mặt hàng trong danh mục.
`unique_content_ids_matched_other_catalogs`	Số ID nội dung duy nhất từ các sự kiện nhận được khớp với một mặt hàng trong một danh mục khác được liên kết với pixel hoặc ứng dụng cụ thể đã kích hoạt sự kiện đó.
`unique_unmatched_content_ids`	Số ID nội dung duy nhất từ các sự kiện nhận được không khớp với mặt hàng trong danh mục.

Phân tích loại thiết bị

Chia nhỏ kết quả bằng cách chuyển device_type:

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <CATALOG_ID> . '/event_stats',
  RequestInterface::METHOD_GET,
  array(
    'breakdowns' => array('device_type'),
  ))->getContent();

curl -G \
  -d 'breakdowns=["device_type"]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<CATALOG_ID>/event_stats

Lệnh này trả về kết quả được nhóm theo thiết bị có các kết quả đó. Ví dụ: desktop, mobile_iphone, mobile_android_phone, v.v.:

{
  "data": [
    {
      "date_start": "2017-03-10",
      "date_stop": "2017-03-10",
      "event": "AddToCart",
      "event_source": {
        "id": "<PIXEL_ID>",
        "source_type": "PIXEL"
      },
      "device_type": "desktop",
      "total_matched_content_ids": 282,
      "total_content_ids_matched_other_catalogs": 524,
      "total_unmatched_content_ids": 4965,
      "unique_matched_content_ids": 102,
      "unique_content_ids_matched_other_catalogs": 402,
      "unique_unmatched_content_ids": 1427
    },
    ...
  ]
}

Phản hồi về sự kiện pixel và sự kiện trong ứng dụng

Ví dụ - Bạn có thể tiến hành kiểm tra để xác minh xem các sự kiện do pixel của mình gửi có xảy ra sự cố hay không.

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <PIXEL_ID> . '/da_checks',
  RequestInterface::METHOD_GET)->getContent();

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PIXEL_ID>/da_checks

Ví dụ - Phản hồi

{
  "data": [
    {
      "description": "Pixel hasn't sent some or any events for Advantage+ catalog ads (ex: ViewContent, AddToCart, Purchase) at least once in the last 24 hours.",
      "key": "pixel_missing_dpa_event",
      "result": "failed",
      "title": "Pixel is not sending DPA events"
    },
    {
      "description": "Pixel events might be missing parameters some or all of the time.",
      "key": "pixel_missing_param_in_events",
      "result": "passed",
      "title": "Pixel missing parameter in DPA events"
    },
    {
      "action_uri": "https://www.facebook.com/ads/manage/pixels/?pixel_id=<PIXEL_ID>&amp;m2w=1",
      "description": "The number of pixel events has dropped to less than half of the weekly average.",
      "key": "pixel_decline",
      "result": "passed",
      "title": "Decline in number of pixel events"
    }
  ]
}

Bạn có thể sử dụng các lệnh kiểm tra sau đây:

Kiểm tra	Mô tả
`pixel_missing_dpa_event`	Kiểm tra xem pixel này có bị thiếu sự kiện nào không, như xác định trong phần Quảng cáo danh mục Advantage+.
`pixel_missing_param_in_events`	Kiểm tra xem có sự kiện nào thiếu các thông số bắt buộc hay không, như xác định trong phần Quảng cáo động.
`pixel_decline`	Kiểm tra xem số sự kiện nhận được cho pixel đó có bị giảm trong 24 giờ qua hay không.

Để biết chi tiết, hãy xem phần Kiểm tra quảng cáo động qua pixel, Tài liệu tham khảo.

Các giá trị có thể của trường result:

Trạng thái	Mô tả
passed	Pixel của bạn đã vượt qua kiểm tra này.
failed	Pixel của bạn không vượt qua kiểm tra này.
unavailable	Kiểm tra này hiện không sử dụng được cho pixel này. Vui lòng thử lại sau.

Theo mặc định, chúng tôi trả về tất cả các kiểm tra, nhưng bạn có thể chỉ định những hoạt động kiểm tra mà mình muốn chạy, như sau:

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <PIXEL_ID> . '/da_checks',
  RequestInterface::METHOD_GET,
  array(
    'checks' => array(
      'pixel_decline',
      'pixel_missing_dpa_event',
      'pixel_missing_param_in_events',
      ),
  ))->getContent();

curl -G \
  --data-urlencode 'checks=[ 
    "pixel_decline", 
    "pixel_missing_dpa_event", 
    "pixel_missing_param_in_events" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PIXEL_ID>/da_checks

Đối với sự kiện trong ứng dụng

Bạn có thể xác minh xem có bất kỳ sự cố nào với sự kiện do ứng dụng của bạn gửi đi hay không:

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <APP_ID> . '/da_checks',
  RequestInterface::METHOD_GET)->getContent();

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<APP_ID>/da_checks

Phản hồi mẫu:

{
  "data": [
    {
      "description": "App hasn't sent some or any events for dynamic ads (ex: ViewContent, AddToCart, Purchase)...",
      "key": "app_missing_dpa_event",
      "result": "failed",
      "title": "App is not sending DPA events"
    },
    {
      "description": "App events might be missing parameters some or all of the time.",
      "key": "app_missing_param_in_events",
      "result": "passed",
      "title": "App missing parameter in DPA events"
    }
  ]
}

Kiểm tra	Mô tả
`app_missing_dpa_event`	Kiểm tra xem ứng dụng có bị thiếu sự kiện hay không, như xác định trong phần Quảng cáo động.
`app_missing_param_in_events`	Kiểm tra xem có sự kiện nào thiếu các thông số bắt buộc hay không, như xác định trong phần Quảng cáo động.

Để biết thêm chi tiết, hãy xem phần Kiểm tra DA trên ứng dụng, Tài liệu tham khảo.

Các giá trị có thể được trả về cho result:

Trạng thái	Mô tả
passed	Ứng dụng của bạn đã vượt qua kiểm tra này.
failed	Ứng dụng của bạn không vượt qua được kiểm tra này.
unavailable	Kiểm tra này hiện không sử dụng được cho ứng dụng này. Vui lòng thử lại sau.

Bạn có thể yêu cầu giá trị cho các hoạt động kiểm tra cụ thể. Theo mặc định, chúng tôi trả về tất cả các kiểm tra, nhưng bạn có thể chỉ định những hoạt động kiểm tra mà mình muốn chạy bằng cách chuyển chúng vào yêu cầu sau:

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$data = Api::instance()->call(
  '/' . <APP_ID> . '/da_checks',
  RequestInterface::METHOD_GET,
  array(
    'checks' => array('app_missing_dpa_event', 'app_missing_param_in_events'),
  ))->getContent();

curl -G \
  -d 'checks=["app_missing_dpa_event","app_missing_param_in_events"]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<APP_ID>/da_checks