Katalog dan Kualitas Sinyal

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

Pixel yang Cocok dan Tidak Cocok dan Peristiwa Aplikasi yang tertaut ke katalog Anda
Pixel dan Aplikasi yang tertaut ke katalog 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/v21.0/<PRODUCT_CATALOG_ID>/event_stats

Open In Graph API Explorer


'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);

Open In Graph API Explorer


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);

Open In Graph API Explorer


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,
)

Open In Graph API Explorer


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();

  }
}

Open In Graph API Explorer


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

Open In Graph API Explorer

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