Katalog dan Kualitas Sinyal

Kami menawarkan dua opsi untuk mendapatkan masukan mengenai kualitas dan kinerja dari berbagai aset iklan katalog Advantage+ Anda:

Masukan pada Peristiwa Pixel dan Aplikasi untuk Katalog

Untuk mengidentifikasi masalah dengan instalasi aplikasi atau pixel, Anda dapat memeriksa statistik agregat mengenai peristiwa yang cocok dan tidak cocok yang diterima dari berbagai pixel, aplikasi, dan perangkat.

Kuerikan Events API untuk mendapatkan statistik mengenai peristiwa yang berasal dari sumber peristiwa yang tertaut ke katalog Anda. Lihat Events API, Referensi untuk mengetahui detailnya.

Statistik Peristiwa

Anda bisa mendapatkan informasi ini di tingkat katalog:

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: { }, })

Tindakan ini mengembalikan array elemen, satu per jenis peristiwa, sumber, dan tanggal dalam bulan lalu:

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

Kolom yang dikembalikan untuk tiap jenis peristiwa, sumber, dan tanggal adalah:

Jumlah Deskripsi

total_matched_content_ids

Total jumlah id konten dari peristiwa diterima, yang cocok dengan barang dalam katalog. Jumlah ini tidak dideduplikasi pada id konten.

total_content_ids_matched_other_catalogs

Total jumlah id konten dari peristiwa diterima, yang cocok dengan barang dalam katalog lain, yang terkait dengan pixel atau aplikasi tertentu. Jumlah ini tidak dideduplikasi pada id konten.

total_unmatched_content_ids

Total jumlah id konten dari peristiwa diterima, yang tidak cocok dengan barang dalam katalog. Jumlah ini tidak dideduplikasi pada id konten.

unique_matched_content_ids

Jumlah id konten unik dari peristiwa diterima, yang cocok dengan barang dalam katalog.

unique_content_ids_matched_other_catalogs

Jumlah id konten unik dari peristiwa diterima, yang cocok dengan barang dalam katalog lain, yang terkait dengan pixel atau aplikasi tertentu yang mengaktifkan peristiwa.

unique_unmatched_content_ids

Jumlah id konten unik dari peristiwa diterima, yang tidak cocok dengan barang dalam katalog.

Perincian Jenis Perangkat

Perinci hasil dengan meneruskan 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

Tindakan ini mengembalikan hasil yang dikelompokkan berdasarkan perangkat. Contoh: desktop, mobile_iphone, mobile_android_phone, dan seterusnya:

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

Masukan pada Peristiwa Pixel dan Aplikasi

Contoh—Gunakan pemeriksaan agar Anda dapat memverifikasi apakah ada masalah pada peristiwa yang dikirimkan oleh pixel.

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

Contoh—Tanggapan

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

Anda dapat menggunakan pemeriksaan berikut:

Periksa Deskripsi

pixel_missing_dpa_event

Memeriksa apakah ada peristiwa yang hilang untuk pixel ini, seperti yang ditentukan dalam Iklan Katalog Advantage+.

pixel_missing_param_in_events

Memeriksa apakah ada peristiwa dengan parameter wajib yang hilang, seperti yang ditentukan di Iklan Dinamis.

pixel_decline

Memeriksa apakah terjadi penurunan jumlah peristiwa yang diterima untuk piksel tersebut dalam 24 jam terakhir.

Untuk detailnya, lihat Pemeriksaan Iklan Dinamis Pixel, Referensi.

Nilai yang mungkin untuk kolom result:

Status Deskripsi

lulus

Pixel Anda lulus pemeriksaan ini.

gagal

Pixel Anda tidak lulus pemeriksaan ini.

tidak tersedia

Pemeriksaan ini sedang tidak tersedia untuk pixel ini. Silakan coba lagi nanti.

Kami mengembalikan semua pemeriksaan secara default, namun Anda dapat menentukan pemeriksaan yang ingin Anda jalankan sebagai berikut:

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

Untuk Peristiwa Aplikasi

Anda dapat memverifikasi apakah ada masalah dengan peristiwa yang dikirim aplikasi Anda:

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

Contoh tanggapan:

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

app_missing_dpa_event

Memeriksa apakah ada peristiwa yang hilang untuk aplikasi ini, seperti yang ditentukan di Iklan Dinamis.

app_missing_param_in_events

Memeriksa apakah ada peristiwa dengan parameter wajib yang hilang, seperti yang ditentukan di Iklan Dinamis.

Untuk detail selengkapnya, lihat Pemeriksaan Iklan Dinamis Aplikasi, Referensi.

Kemungkinan nilai yang ditampilkan untuk result:

Status Deskripsi

passed

Aplikasi Anda lulus pemeriksaan ini.

failed

Aplikasi Anda tidak lulus pemeriksaan ini.

tidak tersedia

Pemeriksaan ini sedang tidak tersedia untuk aplikasi ini. Silakan coba lagi nanti.

Anda dapat meminta nilai untuk pemeriksaan spesifik. Kami mengembalikan semua ke default, tapi Anda dapat menentukan pemeriksaan yang ingin Anda jalankan dengan meneruskannya di permintaan:

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