Dokümantasyonumuzu sürekli güncel tutuyoruz, ancak bazı güncellemeler henüz tüm dillerde yayınlanmamış olabilir. En güncel bilgiler için lütfen İngilizce versiyonuna göz atın.

Android için Meta ham veri raporlaması

Meta, reklamverenlerin install referrer'ları kullanarak Android ham verilerini zenginleştirmelerine olanak verir. Kampanya metadata'sı, Install Referrer'a enkripsiyonlu bir formatta eklenir. Metadata'yı okuyabilmek için Meta'nın uygulamanıza özel sağladığı decryption key'i kullanmanız gerekir.

Ham verilerinizi zenginleştirmek için kullanabileceğiniz desteklenen iki install referrer vardır:

  • The Meta Install Referrer (MIR)
  • The Google Play Install Referrer (GPIR)
Not:
İki install referrer'ı da Facebook ve Instagram gibi Meta uygulamalarından gelen install'lara dair daha fazla bilgi sağlar. Ancak MIR, GPIR tarafından desteklenmeyen gösterim ve aynı session'a sahip olmayan tıklama attribution'ını da destekler. Meta kampanyalarınızdan en yüksek verimi almak için MIR kullanmanızı öneriyoruz.

Başlamadan önce

Başlamadan önce bilmeniz gerekenler.

Gereklilikler

MIR

GPIR

Nasıl çalışır

Install referrer çözümü ile bir kullanıcının uygulama-içi aktivitesini Android'de servis edilen reklamlara kazanım kaynağı olarak bağlayabilirsiniz. Bu sayede kampanyalarınızın başarısını ölçümleyebilir ve önemli kullanıcı kazanımı trendlerini belirleyebilirsiniz.

Kullanıcılar uygulamanızı install ettiğinde install referrer, install kaynağından referral bilgilerini toplar. Meta bu verileri install referrer'ın API'ında enkripsiyonlu bir formatta paylaşır. Sonrasında Adjust bu verileri çıkarır ve Meta decryption key'iniz ile decrypt eder.

Decrypt edilmiş veri string'i bu şekildedir:

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

Decrypt edilmiş verileri ham veri aktarımlarınızda toplamak için placeholder'lar kullanabilirsiniz.

Dikkat:
MIR ve GPIR'in ikisini de etkinleştiriseniz, iki kaynaktan da veri alırsınız. Adjust, Datascape'te MIR ve GPIR bilgilerini tekilleştirir. Ancak ham veri aktarımlarınızda her iki veri setini almaya devam edersiniz. GPIR verileri yerine MIR verilerini önceliklendirmelisiniz.

Hangi veriler paylaşılmaz?

Meta aşağıdaki metadata'nın hiçbirini göndermez:

Bu metadata sadece MIR ile kullanılabilir:

  • Gösterim dönüşümleri.
  • Google Play Store dışındaki Android app store'larda gerçekleşen uygulama event'leri (örneğin Galaxy Store ve Amazon Appstore).

Install Referrer çözümü yapılandırması

Install referrer çözümünü yapılandırmak ve belli kampanya seviyesi bilgilerini Meta'dan almak için bu adımları takip edin.

1. Adjust'taki Meta bilgilerinizi güncelleyin

Adjust'ın referrer metadata'sını decrypt edebilmesi için Install Referrer Decryption Key'inizi paylaşmanız gerekir. Bu key 64 karakterlik bir string'dir ve sadece küçük harfler (a-f) ve rakamlardan (0-9) oluşur. Her Meta App ID için sadece bir decryption key kullanılabilir.

Örnek: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Decryption Key'i bulmak

Decryption Key'inizi bulmak için bu adımları takip edin.

  1. Meta developer portal'a giriş yapın.
  2. Sağ üst köşedeki My Apps 'e gidin
  3. Decryption key'ine erişmek istediğiniz uygulamayı seçin.
  4. Settings > Basic 'i seçin.
  5. Android kısmına gidin.
  6. Google Play kısmında Install Referrer Decryption Key 'i bulun.

Decryption Key'i Adjust'a eklemek

Decryption Key'inizi Adjust'a eklemek için bu adımları takip edin.

  1. Campaign Lab kısmında Partnerler seçeneğini seçin.
  2. Facebook 'u bulun ve link'e tıklayarak genel bakış sayfasına gidin.
  3. Uygulamaların listesini görmek için Veri paylaşımı sekmesini seçin.
  4. Yapılandırmak istediğiniz uygulamayı bulun ve Düzenle () düğmesini seçin.
  5. Facebook için veri paylaşımını ekinleştir bölümünden Düzenle 'yi seçin.
  6. Yapılandırmak istediğiniz her platform için Decryption key 'inizi girin.

2. Callback'lerinize Meta referrer placeholder'ları ekleyin

Adjust, belli placeholder'ları kullanarak Meta'dan alınan decrypt edilmiş verileri ham veri dışa aktarımlarınıza gönderebilir. Bu bilgileri almak için callback URL'inizi ya da CSV tanımınızı gerekli placeholder'lar ile güncelleyin.

Kullanılabilir placeholder'lar

MIR
GPIR
PlaceholderAçıklama
{meta_install_referrer}Decrypt edilmiş formatta Meta install referrer içeriğinin tamamı.
{meta_install_referrer_campaign_group_name}Tam Meta install referrer içeriğindeki "campaign_group_name" değeri.
{meta_install_referrer_campaign_group_id}Tam Meta install referrer içeriğindeki "campaign_group_id" değeri.
{meta_install_referrer_campaign_name}Tam Meta install referrer içeriğindeki "campaign_name" değeri.
{meta_install_referrer_campaign_id}Tam Meta install referrer içeriğindeki "campaign_id" değeri.
{meta_install_referrer_adgroup_id}Tam Meta install referrer içeriğindeki "adgroup_id" değeri.
{meta_install_referrer_adgroup_name}Tam Meta install referrer içeriğindeki "adgroup_name" değeri.
{meta_install_referrer_ad_id}Tam Meta install referrer içeriğindeki "ad_id" değeri.
{meta_install_referrer_account_id}Tam Meta install referrer içeriğindeki "account_id" değeri.
{meta_install_referrer_ad_objective_name}Tam Meta install referrer içeriğindeki "ad_objective_name" değeri.
{meta_install_referrer_publisher_platform}Tam Meta install referrer içeriğindeki "publisher_platform" değeri.
{meta_install_referrer_is_click}Etkileşim türünün tıklama olup olmadığı. Etkileşim türü tıklama ise 1 , değilse 0.
{meta_install_referrer_actual_timestamp}Unix timestamp formatı kullanılan tüm Meta install referrer içeriğindeki "actual_timestamp" değeri.

Raporlar ve placeholder eşleştirmesi

Meta referrer placeholder'larından alınan verilerin raporlama ile uyumlu olması için Adjust aşağıdaki eşleştirmeleri kullanır.

MIR
GPIR
Adjust attribution alanıMeta yapılandırmasıPlaceholderÖrnek değer
network_nameYayıncı platformu
  • {meta_install_referrer_publisher_platform}
Meta Installs
campaign_nameKampanya adı
Kampanya ID'si.
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_nameAd Set Adı
Ad Set ID
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_nameAd Adı
Ad ID
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

Adjust'ın network_name'i görüntüleme şekli

Örnek callback'ler

Örnek callback URL'i

MIR
GPIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id}&PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

Doldurulmuş değerlere sahip callback örneği

MIR
GPIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&meta_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

Meta'ya attribute edilmemiş install'lar için

Bir install'a referrer eklenmişse ve en son attribution Meta dışında başka bir partnere verilmişse, verilerinizde referrer bilgilerini yine de alırsınız.

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D