Tham chiếu cài đặt của Meta

Tài liệu này hướng dẫn bạn cách sử dụng tính năng tham chiếu cài đặt của Meta trong ứng dụng Android của mình để lấy siêu dữ liệu về các chiến dịch quảng cáo trên Facebook, Instagram và Audience Network có mục tiêu là lượt cài đặt ứng dụng. Trong khi Tham chiếu cài đặt của Google Play (GPIR) chỉ cung cấp thông tin về lượt cài đặt do click chuột trong cùng một phiên, tham chiếu cài đặt của Meta có cả dữ liệu về:

• lượt cài đặt do xem (VT)
• lượt cài đặt do click chuột (CT)
• lượt cài đặt do click chuột trong nhiều phiên

Có 2 cách để thiết lập tính năng tham chiếu cài đặt của Meta cho chiến dịch trên ứng dụng Android của bạn: tiện ích tích hợp trực tiếp hoặc tiện ích tích hợp được hỗ trợ qua đối tác đo lường di động (MMP).

Cách 1: Tiện ích tích hợp trực tiếp

Trước khi bạn bắt đầu

Trước khi bắt đầu, bạn cần:

• Thiết lập khóa giải mã cho Tham chiếu cài đặt của Google Play (GPIR)

Bước 1. Thêm ứng dụng trên Meta

Thêm thành phần queries cho ứng dụng Facebook, Instagram và Facebook Lite vào file AndroidManifest.xml để ứng dụng của bạn có thể lấy dữ liệu phân bổ tham chiếu từ những ứng dụng này trên Meta.

<queries>
  <package android:name="com.facebook.katana" />
</queries>

<queries>
  <package android:name="com.instagram.android" />
</queries>

<queries>
  <package android:name="com.facebook.lite" />
</queries>

Bước 2. Triển khai API ContentProvider

Thêm mã ContentProvider để lấy dữ liệu phân bổ tham chiếu từ ứng dụng Facebook và Instagram. Bạn nên lấy dữ liệu này khi khởi chạy ứng dụng lần đầu tiên.

Cursor c = null;
try {
    String [] projection = { "install_referrer", "is_ct", "actual_timestamp", };
    Uri providerUri = null;
    
    // This IF statement queries the facebook app first.
    // To query from the instagram app first, change the sequence of the IF statement

    if (context.getPackageManager().resolveContentProvider(
           "com.facebook.katana.provider.InstallReferrerProvider", 0) != null) {
       providerUri = Uri.parse(
           "content://com.facebook.katana.provider.InstallReferrerProvider/" + FB_APP_ID);
    } else if (context.getPackageManager().resolveContentProvider(
           "com.instagram.contentprovider.InstallReferrerProvider", 0) != null) {
       providerUri = Uri.parse(
           "content://com.instagram.contentprovider.InstallReferrerProvider/" + FB_APP_ID);
    } else if (context.getPackageManager().resolveContentProvider(
           "com.facebook.lite.provider.InstallReferrerProvider", 0) != null) {
       providerUri = Uri.parse("content://com.facebook.lite.provider.InstallReferrerProvider/" + FB_APP_ID);
    } else {
       return null;
    }

    c = context.getContentResolver().query(providerUri, projection, null, null, null);
    if (c == null || !c.moveToFirst()) {
       return null;
    }

    int installReferrerIndex = c.getColumnIndex("install_referrer");
    int timestampIndex = c.getColumnIndex("actual_timestamp");
    int isCTIndex = c.getColumnIndex("is_ct");
    String installReferrer = c.getString(installReferrerIndex); // serialized and encrypted attribution details

    // TODO: 
    // 1. deserialize installReferrer (convert String to JSON)
    // 2. decrypt attribution details in install_referrer.utm_content.source.data using 
    // key: GPIR decryption key 
    // nonce: retrieve from installReferrer.utm_content.source.nonce
    // data: retrieve from installReferrer.utm_content.source.data
    // decrypt data 

    long actualTimestamp = c.getLong(timestampIndex); // timestamp in seconds for click/impression
     int isCT = c.getInt(isCTIndex); // VT or CT, 0 = VT, 1 = CT
           
} catch (Exception e) {
    return null;
} finally {
    if (c != null) {
        c.close();
    }
}

Các bước giải tuần tự và giải mã dữ liệu sẽ tương tự như các bước có trong hướng dẫn về Tham chiếu cài đặt.

Phản hồi cấu trúc dữ liệu nhận được từ install_referrer sau khi giải tuần tự cho mỗi ứng dụng trên Meta sẽ bao gồm:

• actual_timestamp - giá trị là nhãn thời gian tính bằng giây khi có lượt click hoặc lượt hiển thị
• is_ct - giá trị có thể là 1 (biểu thị lượt click) hoặc 0 (biểu thị lượt hiển thị)
• install_referrer - giá trị là dữ liệu phân bổ GPIR được mã hóa

Phản hồi JSON mẫu

{
  is_ct=1,
  actual_timestamp=123,
  install_referrer={
    utm_campaign = fb4a,
    utm_content: {
      source: {
        data: “7fb9bd76…”, // encrypted attribution information
        nonce: “1234” // nonce from encryption
      },
      a: <app_id>,
      t: <timestamp>
    }
    utm_source : “apps.facebook.com” //OR “apps.instagram.com”
  }
}

Dữ liệu mẫu sau khi giải mã install_referrer.utm_content.source

{ 
  "ad_id":"6110809314024", 
  "adgroup_id":"6110808725024", 
  "adgroup_name":"RTG_Storie_", 
  "campaign_id":"6110808710224", 
  "campaign_name":"Mobex_Conversiones_Storie_Android_21 a 31 de Diciembre_OP39895",
  "campaign_group_id":"6110808710624", 
  "campaign_group_name":"Mobex_Instagram Storie_ Conversiones_ Diciembre OP 43918",
  "account_id":"485495091598353",
  "ad_objective_name":"CONVERSIONS", 
  // data included for Instagram ads
  "is_instagram":true,
  "publisher_platform":"instagram",                
  "platform_position":"instagram_stories"          
}

Bước 3. Bỏ trùng lặp dữ liệu

Nếu có siêu dữ liệu chiến dịch quảng cáo GPIR, bạn cần tuân theo quy trình bỏ trùng lặp GPIR hiện có.

Bỏ trùng lặp bằng cách sử dụng tham chiếu cài đặt

Bạn có thể loại bỏ dữ liệu trùng lặp bằng cách sử dụng dữ liệu được trả về trong install_referrer. Lý do là vì các giá trị của một lượt cài đặt hoặc chiến dịch có mục tiêu là CT trên tham chiếu cài đặt của Meta và GPIR đều giống nhau.

Đối với VT và CT trong nhiều phiên, hãy sử dụng dữ liệu tham chiếu cài đặt của Meta vì GPIR không hỗ trợ lượt cài đặt đó.

Nếu không có dữ liệu về siêu dữ liệu chiến dịch quảng cáo GPIR, bạn sẽ bỏ trùng lặp dữ liệu dựa trên việc bạn có làm việc với đối tác đo lường di động (MMP) hay không.

Bỏ trùng lặp thông qua MMP

Đối tác đo lường di động (MMP) có quyền truy cập vào dữ liệu phân bổ ở cấp độ hàng đối với những lượt cài đặt không có mạng quảng cáo chiến thắng, do được phân bổ cho Meta hoặc do là lượt cài đặt tự nhiên. Bạn có thể kiểm tra xem có tham chiếu cài đặt nào được cung cấp qua tham chiếu cài đặt của Meta hay không. Nếu có, bạn có thể xem lượt cài đặt là do Meta thúc đẩy, còn dữ liệu tham chiếu cài đặt được cung cấp là siêu dữ liệu chiến dịch quảng cáo của lượt cài đặt đó.

Bỏ trùng lặp không thông qua MMP

Tham chiếu cài đặt của Meta cung cấp thông tin về lần chạm gần đây nhất cho lượt cài đặt, bao gồm cả siêu dữ liệu chiến dịch quảng cáo, nhãn thời gian thực tế và loại hành động của lần chạm gần đây nhất (lượt hiển thị hoặc lượt click). Bạn có thể so sánh loại hành động và nhãn thời gian của lần chạm gần đây nhất với dữ liệu phân bổ mà bạn lấy từ các mạng quảng cáo khác, từ đó quyết định mạng quảng cáo chiến thắng.

Xác minh cách thiết lập

Trước hết, hãy đảm bảo bạn đang sử dụng phiên bản ứng dụng hỗ trợ giải pháp này. Phiên bản tối thiểu:

• Facebook: v428
• Instagram: v296
• Facebook Lite: v411

Bạn có thể xác minh cách thiết lập theo các bước dưới đây:

1. Chèn chiến dịch thử nghiệm bằng cách sử dụng Bản xem trước trong Trình quản lý quảng cáo
2. Tìm quảng cáo trên Facebook hoặc Instagram rồi nhấp vào quảng cáo đó
3. Thêm điểm ngắt hoặc nhật ký vào mã của bạn ở Bước 2

Ứng dụng của bạn sẽ nhận được phản hồi và giải mã phản hồi đó để xem dữ liệu chiến dịch.

Cách 2: Tiện ích tích hợp được hỗ trợ qua MMP

Bước 1: Cập nhật SDK đối tác đo lường di động (MMP) của bạn

Cập nhật SDK MMP của bạn lên phiên bản đã tích hợp tham chiếu cài đặt của Meta:

• AppsFlyer SDK: AppsFlyer SDK v6.14.2 trở lên
• Adjust SDK: Adjust SDK v4.36.0 trở lên (Flutter 4.36.0 trở lên, Unity 4.37.0 trở lên)
• Singular SDK hoặc API S2S: Singular SDK v12.3.0 trở lên (Unity 4.2.0 trở lên, React Native 3.3.0 trở lên, Unreal 2.2.0 trở lên)
• Kochava SDK: Kochava Android SDK v5.1.0 trở lên
• Airbridge SDK: Airbridge Android SDK v2.22.3 trở lên
• Branch SDK: Branch SDK v5.10.1 trở lên

Bước 2: Đảm bảo rằng ID ứng dụng trên Facebook được liên kết với SDK MMP của bạn

Xem hướng dẫn qua liên kết bên dưới.

• Hướng dẫn dành cho Adjust
• Hướng dẫn dành cho Singular
• Hướng dẫn dành cho Kochava (Chuyển đến phần Meta/Facebook)
• Hướng dẫn dành cho Airbridge
• AppsFlyer tự động thực hiện bước này
• Hướng dẫn dành cho Branch

Bước 3: Tùy thuộc vào MMP, bạn có thể cần cập nhật File kê khai Android cho ứng dụng của mình

Xem hướng dẫn qua liên kết bên dưới.

• Hướng dẫn dành cho Kochava (Chuyển đến phần Meta/Facebook)
• Hướng dẫn dành cho Branch
• AppsFlyer, Adjust, Singular và Airbridge tự động thực hiện bước này thông qua SDK của mình
• Vui lòng kiểm tra với MMP nếu bạn sử dụng SDK Flutter/React thay vì Android SDK của MMP

Bước 4: Chia sẻ Khóa giải mã tham chiếu cài đặt của bạn để MMP có thể giải mã siêu dữ liệu tham chiếu

Lưu ý: Nếu bạn đã thực hiện bước này cho Tham chiếu cài đặt của Cửa hàng Google Play thì bước này không cần thiết.

• Bạn sẽ cần có quyền truy cập của quản trị viên vào tài khoản Trình quản lý kinh doanh sở hữu ứng dụng đó.
• Đăng nhập vào Meta for Developers.
• Chuyển đến Ứng dụng của tôi ở góc trên cùng bên phải.
• Chọn ứng dụng mà bạn muốn truy cập Khóa giải mã của mình.
• Chọn Cài đặt ứng dụng > Cơ bản.
• Cuộn xuống phần Android. Tìm Khóa giải mã tham chiếu cài đặt trong nhãn Google Play.
• Chia sẻ Khóa giải mã với MMP của bạn. Xem hướng dẫn qua liên kết bên dưới.
  

  • Hướng dẫn dành cho AppsFlyer
  • Hướng dẫn dành cho Adjust
  • Hướng dẫn dành cho Singular
  • Hướng dẫn dành cho Kochava
  • Hướng dẫn dành cho Airbridge
  • Hướng dẫn dành cho Branch