Integrasi mitra

AdsGram mendukung integrasi dengan platform atribusi dan pelacakan yang populer. Platform ini memungkinkan Anda melacak klik, instalasi, dan tindakan pengguna setelah berinteraksi dengan iklan AdsGram, serta mengirim data konversi kembali ke AdsGram, sehingga Anda dapat mengoptimalkan kampanye berdasarkan biaya konversi (tCPA).

Integrasi berikut tersedia:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

Anda juga dapat menggunakan tautan dari platform pelacakan lain. Namun, dalam hal ini, AdsGram tidak akan dapat meneruskan semua informasi yang diperlukan ke pelacak untuk analitik yang lebih detail.

Adjust

1. Pilih Network

Di bagian Campaign Lab, buka Partners

• Klik New Partner.
• Di bilah pencarian, ketik AdsGram dan pilih jaringan ini.
• Setelah memilih, klik Next.

2. Pilih Aplikasi

Di layar berikutnya, pilih aplikasi yang akan Anda gunakan untuk membuat tautan. Gunakan bilah pencarian untuk menemukan aplikasi Anda, atau gulir daftar untuk menemukannya. Anda dapat menyiapkan tautan untuk satu aplikasi dalam satu waktu.
Setelah memilih aplikasi, klik Next.

3. Atur Opsi Berbagi Data

Di bagian ini, Anda akan mengatur parameter berbagi data dengan AdsGram, memilih peristiwa dan parameter aplikasi mana yang akan dikirim ke AdsGram untuk analisis.
Instruksi detail tersedia di halaman dokumentasi Adjust.

4. Dapatkan Tautan Pelacakan

Setelah mengonfigurasi semua parameter dan pemetaan, Anda akan menerima tautan pelacakan unik, yang harus digunakan saat membuat kampanye iklan di AdsGram.
Selain itu, Anda dapat menambahkan parameter ekstra seperti tag UTM untuk pelacakan sumber lalu lintas yang lebih tepat.

5. Transfer Data Konversi

Secara default, data aktivitas pengguna ditransfer dari Adjust ke AdsGram dan secara otomatis ditetapkan ke goal yang sesuai:

• Sesi (Sessions) - ke Goal 1
• Instalasi (Installs) - ke Goal 2

PENTING

Untuk meluncurkan kampanye tCPA, Anda perlu menerima setidaknya 10 konversi untuk goal yang dipilih. Misalnya, jika kampanye diluncurkan dengan Goal 2, Anda perlu menerima setidaknya 10 konversi untuk Goal 2.

AppMetrica

Membuat pelacak:

1. Setelah mendaftar di akun pribadi AppMetrica, mengintegrasikan SDK ke dalam aplikasi, dan menyiapkan pelacakan tindakan target, Anda dapat melanjutkan ke pembuatan pelacak.
2. Tentukan nama pelacak.
3. Tambahkan aplikasi.

Instruksi detail tersedia di halaman dokumentasi AppMetrica.

Transfer data instalasi:

4. Pilih penerima postback (AdsGram).
5. Tentukan jenis peristiwa yang perlu dikirim ke AdsGram.
6. Dapatkan URL Postback — tautan yang digunakan untuk mengirim peristiwa dan instalasi ke server AdsGram.
7. Setelah membuat postback, Anda akan menerima tautan pelacakan. Tautan ini harus digunakan saat membuat kampanye di AdsGram. Selain itu, Anda dapat menambahkan parameter tambahan, seperti tag UTM, jika diperlukan.

Keitaro

1. Membuat Pelacak di Keitaro

1. Setelah masuk ke dasbor Keitaro, buka bagian Trackers.
2. Klik Create tracker atau New tracker.
3. Masukkan nama pelacak dan pilih AdsGram sebagai jenis sumber lalu lintas.
4. Klik Save untuk membuat pelacak.

2. Mengonfigurasi Postback di Keitaro

1. Di pengaturan pelacak yang dibuat, buka bagian Postback atau API Integration.

2. Di bidang Postback URL, masukkan endpoint AdsGram:

   https://api.adsgram.ai/confirm_conversion?

3. Tambahkan parameter token yang diperlukan dan parameter record. Nama parameter harus sesuai dengan parameter record yang ditentukan di Tracking Link.

   Misalnya, jika Anda meneruskan makro AdsGram di Tracking Link sebagai berikut:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

   maka berikut ini harus ditentukan di postback Keitaro:

   https://api.adsgram.ai/confirm_conversion?token=UNIK_TOKEN_ANDA&record={_record}

   Di mana:

   • UNIK_TOKEN_ANDA — token dari profil AdsGram Anda
   • record — parameter yang Anda teruskan di Tracking Link
   • {_record} — makro yang meneruskan nilai asli parameter record ke postback

   WARNING

   Untuk mendapatkan nilai mentah dari sistem pelacakan, tambahkan "_" (underscore) sebelum nama makro. Ini hanya relevan untuk pelacak Keitaro dan diperlukan untuk mencegah serangan XSS.

3. Menyiapkan Kampanye di AdsGram

1. Salin Click URL dari pengaturan pelacak Keitaro Anda (misalnya: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. Di dasbor AdsGram, saat membuat kampanye, tempel tautan ini ke bidang Click URL.
3. Tambahkan makro AdsGram yang diperlukan ke tautan:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. Pastikan makro {record_data} disertakan dalam tautan akhir.

4. Menyiapkan Goals di Keitaro

1. Di pengaturan pelacak Keitaro Anda, buka bagian Goals atau Conversions.
2. Buat goal baru atau pilih yang sudah ada.
3. Aktifkan pengiriman postback ke URL yang telah ditentukan sebelumnya untuk goal ini.
4. Tentukan kondisi pemicu (misalnya, saat konfirmasi konversi atau status tertentu).

Kochava

1. Membuat Pelacak di Kochava

1. Setelah masuk ke dasbor Kochava, buka bagian Apps & Assets.
2. Klik Add New dan pilih App untuk membuat pelacak aplikasi baru.
3. Isi bidang yang diperlukan:
   • Platform: Pilih platform aplikasi (iOS, Android, Web).
   • App Name: Masukkan nama aplikasi Anda.
   • Store ID: Masukkan pengenal toko aplikasi (App Store ID, Package Name, dll.).
4. Klik Save untuk membuat aplikasi.

2. Menyiapkan Integrasi Mitra

1. Di halaman aplikasi yang dibuat, navigasikan ke bagian Partner Management.
2. Klik Add Partner.
3. Temukan dan pilih AdsGram dari daftar mitra.
4. Klik Next untuk melanjutkan ke pengaturan konfigurasi.

3. Mengonfigurasi Parameter Integrasi

1. Di bagian Integration Settings, pilih jenis pelacakan (Click-Through, View-Through, atau Hybrid).

2. Aktifkan opsi Server-to-Server Postbacks.

3. Di bidang Postback URL, masukkan endpoint AdsGram:

   https://api.adsgram.ai/confirm_conversion

4. Tambahkan parameter berikut ke Postback Parameters:

   • Parameter yang diperlukan: {record_data} (secara otomatis dimasukkan oleh Kochava).
   • Tambahkan parameter: token dengan nilai UNIK_TOKEN_ANDA (diambil dari profil AdsGram Anda).

5. Atur makro pemetaan data:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

4. Menyiapkan Kampanye di AdsGram

1. Kembali ke bagian Tracking Links di Kochava dan buat tautan pelacakan (misalnya: https://your-app.kochava.com/install?data={encrypted_data}).
2. Di dasbor AdsGram, saat membuat kampanye, tempel tautan ini ke bidang Click URL.
3. Tambahkan makro AdsGram wajib ke tautan sebagai parameter:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. Pastikan makro {record_data} disertakan dalam URL akhir.

5. Mengonfigurasi Events di Kochava

1. Di dasbor Kochava, buka bagian Events.
2. Buat peristiwa baru atau pilih yang standar (misalnya, install, purchase).
3. Konfigurasikan postback untuk peristiwa yang dipilih:
   • Aktifkan Send Postback.
   • Pilih integrasi AdsGram yang telah dibuat sebelumnya.
   • Tentukan filter dan kondisi pemicu.
4. Simpan konfigurasi peristiwa.

6. Menguji Integrasi

1. Gunakan Test Mode di Kochava untuk memverifikasi pelacakan instalasi.
2. Periksa permintaan yang masuk di log Kochava dan AdsGram.
3. Pastikan parameter record_data diteruskan dengan benar.

AppsFlyer

Integrasi AdsGram dengan AppsFlyer memungkinkan Anda mengirim data tentang instalasi aplikasi dan tindakan pengguna di dalam aplikasi ke AdsGram.

Setelah integrasi dikonfigurasi, AdsGram akan menerima:

• Instalasi aplikasi (Installs) - secara otomatis ditetapkan ke Goal 1
• Semua In-App Events lainnya - secara otomatis ditetapkan ke Goal 2

Tidak diperlukan konfigurasi tambahan atau pemetaan peristiwa ke goal di AdsGram. Misalnya, jika peristiwa seperti registration, purchase, deposit, dll. dikirim dari AppsFlyer, semuanya akan otomatis dihitung di bawah Goal 2.

IMPORTANT

Kampanye tCPA hanya dapat diluncurkan dengan Goal 1. Ini berarti kampanye tCPA hanya dapat dioptimalkan untuk instalasi aplikasi. In-App Events yang dikirim ke Goal 2 tidak dapat digunakan sebagai goal untuk kampanye tCPA.

1. Menghubungkan AdsGram melalui Integrated Partners

AdsGram adalah mitra terintegrasi (integrated partner) AppsFlyer. Untuk menghubungkan:

• Buka Collaboration → Partner Marketplace di AppsFlyer
• Cari AdsGram (nama marketing) atau adsgram1e_int (nama teknis) lalu pilih mitra tersebut

2. Mengonfigurasi Install Postback

Buka tab Integration:

• Aktifkan Activate Partner
• Nonaktifkan AAP (harus dinonaktifkan baik di pengaturan aplikasi maupun di tab ini)
• Di Install Postback, pilih This partner only. Ini berarti AdsGram akan menerima instalasi yang diatribusikan ke AdsGram. Instalasi ini akan dihitung sebagai Goal 1 di AdsGram.

IMPORTANT

Jika Anda ingin meluncurkan kampanye yang dioptimalkan untuk instalasi, pastikan instalasi dikirim ke AdsGram dan ditampilkan di bawah Goal 1. Kampanye tCPA yang dioptimalkan untuk instalasi hanya dapat diluncurkan dengan Goal 1.

3. Mengonfigurasi In-App Event Postback

Konfigurasikan postback untuk In-App Events (pembelian, registrasi, dll.) di bagian In-App Event Postbacks:

• Tambahkan peristiwa yang diperlukan, misalnya:
  • purchase - pembelian
  • af_complete_registration - registrasi
• Di bidang For users from, pilih This partner only
• AdsGram hanya menerima peristiwa itu sendiri, tanpa parameter atau pendapatannya. Oleh karena itu, di Including, Anda dapat memilih No values & no revenue

Disarankan:

• Izinkan konfigurasi integrasi (kecuali postback peristiwa in-app)
• Izinkan konfigurasi postback peristiwa in-app

Izin lainnya (laporan retensi, pendapatan, dll.) bersifat opsional.

Setelah mengonfigurasi integrasi, klik Save Integration.

4. Mengonfigurasi Tracking Link

Buka tab Tracking Link:

• AppsFlyer akan secara otomatis membuat tautan pelacakan untuk AdsGram dan menambahkan pengenal mitra yang diperlukan: pid=adsgram1e_int
• 4 makro AdsGram akan terisi otomatis (af_storeid, c, dll.)
• Jika perlu, tambahkan parameter statis sebagai parameter tambahan
• Di Click-through attribution, pilih jendela atribusi. Default-nya adalah 7 hari, tetapi Anda dapat mengubahnya jika perlu

5. Mengonfigurasi Permissions

Buka tab Permissions dan aktifkan izin yang diperlukan:

• Akses ke dasbor aplikasi
• Konversi teragregasi
• Events
• Protect360

👉 Klik Save Integration

6. Menyiapkan Kampanye di AdsGram

Saat membuat kampanye di AdsGram:

• Masukkan Click link di bidang Link. Sistem akan secara otomatis membuat tautan pelacakan AppsFlyer dan menambahkan makro yang diperlukan
• Tentukan nama package/bundle Anda di tautan pelacakan AppsFlyer jika belum disertakan (misalnya, id12345678 atau com.app.name)
• Di bidang Link yang muncul, masukkan tautan langsung ke produk Anda di Google Play / App Store / RuStore

7. Catatan

• Konfigurasi ini berlaku untuk semua banner dalam kampanye
• Pengiklan bertanggung jawab atas parameter tautan dan atribusi yang benar
• Saat menggunakan tautan kustom, Anda juga harus menentukan tautan produk langsung di bidang Link