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 şifreli bir formatta eklenir. Metadata'yı okuyabilmek için Meta'nın uygulamanıza özel sağladığı deşifre anahtarı kullanmanız gerekir.

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

• The Google Play Install Referrer (GPIR)
• The Meta Install Referrer (MIR)

İki install referrer'ı da Facebook ve Instagram gibi Meta uygulamalarından gelen install'lara dair daha fazla bilgi sağlar. Ancak gösterim ve aynı session'a sahip olmayan tıklama attribution'ını sadece MIR destekler.

Başlamadan önce

Başlamadan önce bilmeniz gerekenler.

Gereklilikler

• Uygulama için bir Meta Decryption Key'i.
• Meta giriş bilgilerini Adjust'ta Admin ve Editör izinlerine sahip kullanıcılar güncelleyebilir.

GPIR

GPIR'i etkinleştirmek için Google Play Install Referrer'ı yapılandırmanız gerekir.

MIR

MIR plugin'ini etkinleştirmek için Adjust Android SDK'yı v5 versiyonuna güncellemeniz ve Meta install referrer plugin'ini yapılandırmanız gerekir.

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.

1. Kullanıcılar uygulamanızı install ettiğinde install referrer, install kaynağından referral verilerini toplar.
2. Meta, bu şifreli verileri install referrer'ın API'ını kullanarak paylaşır.
3. Sonrasında Adjust bu verileri çıkarır ve Meta deşifre anahtarı ile deşifre 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.

Hangi veriler paylaşılmaz?

Meta, cihaz ID'lerini göndermez.

Aşağıdaki veri noktaları sadece MIR kullandığınızda kullanılabilir:

• Gösterim dönüşümleri.
• Google Play dışı Android App Store'lardan gelen uygulama event'leri (örneğin, Galaxy Store ve Amazon Appstore).

Install referrer yapılandırması

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

Meta giriş bilgilerinizi Adjust ile paylaşmak

Adjust'ın referrer verisini deşifre edebilmesi için install referrer deşifre anahtarınızı paylaşmanız gerekir.

Decryption Key'i bulmak

Deşifre Anahtarı, her Meta uygulama ID'si için kullanılabilen 64 karakterlik bir dizidir.

Örnek: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

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

1. App Dashboard'unuzu açın.
2. İlgili uygulamayı seçin.
3. Settings > Basic 'i seçin.
4. Android kısmına gidin.
5. Install Referrer Deşifre Anahtarı 'nı kopyalayın.

Decryption Key'i Adjust'a eklemek

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

1. Campaign Lab > Partnerler seçeneğini seçin.
2. Facebook 'u bulun ve tıklayarak genel bakış sayfasına gidin.
3. Uygulama 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. Önceki adımda kopyaladığınız deşifre anahtarını Deşifre Anahtarı (Opsiyonel) alanına yapıştırın.
7. Kaydet düğmesine tıklayın.

Callback'lerinize Meta referrer placeholder'ları ekleyin

Adjust, placeholder'ları kullanarak size Meta'dan deşifre edilmiş verileri gönderebilir. Bunu ham veri dışa aktarımlarınızda almak için, callbacj URL'nize veya CSV tanımınıza ilgili placeholder'ları ekleyin.

Kullanılabilir placeholder'lar

Raporlar ve placeholder eşleştirmesi

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

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

Adjust, network_name raporlamasında bu mantığı kullanır:

Örnek callback'ler

https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

Doldurulmuş değerlere sahip callback örneği

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&fb_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&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%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&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Meta'ya attribute edilmemiş install'lar

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

https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_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