# Meta Graph

## Kết nối `Meta Graph` trên Bluecore

### **Bước 1**: Truy cập [Quản lý ứng dụng](https://developers.facebook.com/apps) trên Facebook for Developers.

### **Bước 2**: Tạo ứng dụng Facebook. 

{% hint style="info" %}
Bỏ qua bước này nếu bạn đã có ứng dụng Facebook
{% endhint %}

Nhấp vào nút "Create App"

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/XaCV9wIyepPRHxlIRmX8/image.png" alt=""><figcaption></figcaption></figure>

Chọn mục đích sử dụng là "Other", sau đó nhấp nút "Next"

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/Cu01T0sED56JgvZBFOqG/image.png" alt=""><figcaption></figcaption></figure>

Chọn loại ứng dụng là "Bussiness" sau đó nhấp nút "Next"

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/jd0Pe7uYiON0GrbJ67YT/image.png" alt=""><figcaption></figcaption></figure>

Đặt tên ứng dụng và điền email của bạn sau đó nhấp nút "Create app"

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/g7BN02bC49rDuKzAEg02/image.png" alt=""><figcaption></figcaption></figure>

### **Bước 3**: Lấy thông tin ứng dụng

Tại màn hình quản lý ứng dụng, nhấp vào menu "Settings" -> "Basic"

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/GoM9mSHrPrWAyF7xB8pB/image.png" alt=""><figcaption></figcaption></figure>

Nhấp vào nút "Show" để hiển thị thông tin "App secret" *(Facebook có thể yêu cầu nhập lại mật khảu tài khoản Facebook của bạn để xác nhận)*

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/ExqFYaK1FdjfKj9tdHWY/image.png" alt=""><figcaption></figcaption></figure>

Lưu lại 2 giá trị "App ID" và "App secret" để dùng khi kết nối tại Bluecore ở [Bước 5](#buoc-5-tao-ket-noi-meta-graph-tren-bluecore)

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/XRPugQ8x0MOMB4FlPWEt/image.png" alt=""><figcaption></figcaption></figure>

### **Bước 4**: Tạo mã Access Token

Truy cập [Graph API Explorer](https://developers.facebook.com/tools/explorer/). Tại thanh công cụ bên phải, chọn ứng dụng của bạn trong mục "Meta App" và thêm các quyền sau vào mục "Permissions" sau đó nhấp chọn nút "Generate Access Token"

#### Các quyền cần được cấp

* `pages_show_list`
* `pages_read_engagement`
* `pages_messaging`
* `ads_read`
* `read_insights`
* `business_management`
* `instagram_basic`
* `instagram_manage_insights`

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/QWoBzPvO1d3h541LAPTv/image.png" alt=""><figcaption></figcaption></figure>

Cấp quyền cho ứng dụng của bạn

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/2jSID4hkw9q4QY0Uxgtv/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/PEcdIAuKgwVRGDOVpRV4/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/kyncZbFYYtepb5FkD5g0/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/aY1AUGbIw3LLoGOLZRaa/image.png" alt=""><figcaption></figcaption></figure>

Sau khi cấp quyền, Facebook sẽ hiển thị thông tin Access Token, lưu lại giá trị này

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/x5gQ4KBedlg28ZRQwuLN/image.png" alt=""><figcaption></figcaption></figure>

### **Bước 5**: Tạo kết nối Meta Graph trên Bluecore

Truy cập [trang quản trị kết nối](https://admin.bluecore.vn/app/main/connectors) của Bluecore, chọn kết nối `Facebook Graph` và điền các thông tin:

* `App Id` và `App Secret`: Thông tin ứng dụng đã lấy ở [Bước 3](#buoc-3-lay-thong-tin-ung-dung)
* `Access Token`: Mã kết nối đã copy ở [Bước 4](#buoc-4-tao-ma-access-token)

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/dJ23JHl6O3GgMvzZyjoU/image.png" alt=""><figcaption></figcaption></figure>

Chọn các tài khoản/trang bạn muốn đồng bộ dữ liệu sau đó nhấp chọn nút "Connect", bạn có thể chỉnh sửa lại các lựa chọn này sau khi kết nối.

<figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/IiYjBhjCYsqj4rklkByD/image.png" alt=""><figcaption></figcaption></figure>

Sau khi kết nối, hệ thống sẽ bắt đầu đồng bộ dữ liệu cho bạn. Từ giờ bạn có thể phân tích dữ liệu quảng cáo, marketing trên Facebook và Instagram của mình :tada:

## Một số vấn đề thường gặp khi kết nối

<details>

<summary><mark style="color:orange;">The access token does not belong to application xxxx.</mark></summary>

Bạn sẽ gặp thông báo này khi mã `Access Token` được tạo bằng một ứng dụng khác, không phải ứng dụng có mã `App ID` bạn nhập ở màn hình kết nối. Hãy đảm bảo rằng bạn chọn đúng ứng dụng khi tạo mã `Access Token` ở [Bước 4](#buoc-4-tao-ma-access-token)

</details>

<details>

<summary><mark style="color:orange;">Malformed access token</mark></summary>

Đảm bảo bạn sao chép chính xác mã `Access Token`

</details>

<details>

<summary><mark style="color:orange;">Invalid Client ID</mark></summary>

Đảm bảo bạn sao chép chính xác mã ứng dụng `App ID`  và `App secret` tại [Bước 2](#buoc-2-tao-ung-dung-facebook.)

</details>

<details>

<summary><mark style="color:orange;">Access Token has expired, been revoked, or is invalid</mark></summary>

Access Token đã hết hạn hoặc không có quyền truy cập, thử lại bằng cách [tạo mã Access Token mới](#buoc-4-tao-ma-access-token) và đảm bảo rằng bạn đã cấp đủ [các quyền được liệt kê](#cac-quyen-can-duoc-cap)

</details>