अभियान मापन

इस दस्तावेज़ में Android के लिए Google Analytics SDK v4 से कैंपेन और ट्रैफ़िक सोर्स को मेज़र करने के तरीके की खास जानकारी दी गई है.

खास जानकारी

Google Analytics में कैंपेन को मेज़र करने से, आपके ऐप्लिकेशन में उपयोगकर्ता गतिविधि के लिए कैंपेन और ट्रैफ़िक सोर्स का एट्रिब्यूशन चालू हो जाता है. ये विकल्प, Android के लिए Google Analytics SDK v4 में कैंपेन और ट्रैफ़िक सोर्स एट्रिब्यूशन के लिए उपलब्ध हैं:

नीचे दिए सेक्शन में बताया गया है कि आपके ऐप्लिकेशन में, हर तरह के कैंपेन मेज़रमेंट को कब और कैसे लागू किया जाए.

Google Play कैंपेन का एट्रिब्यूशन

Google Play कैंपेन मेज़रमेंट की मदद से यह देखा जा सकता है कि कौनसे कैंपेन और ट्रैफ़िक सोर्स, लोगों को Google Play Store से आपका ऐप्लिकेशन डाउनलोड करने के लिए भेज रहे हैं. सभी डेवलपर को सुझाव दिया जाता है कि वे 'Google Play स्टोर' कैंपेन मेज़रमेंट को लागू करें.

Google Play कैंपेन एट्रिब्यूशन लागू करें

Google Play Store, डेवलपर के लिए एक रेफ़रलकर्ता एपीआई इंस्टॉल करें उपलब्ध कराता है, ताकि वह Google Play से रेफ़रल कॉन्टेंट सुरक्षित तरीके से वापस पा सके. यह एपीआई, आपके ऐप्लिकेशन के Google Play Store पेज पर पहुंचने के लिए इस्तेमाल किए गए रेफ़रर पैरामीटर की वैल्यू दिखाता है. ऐसा तब होता है, जब कोई रेफ़रर पैरामीटर मौजूद हो.

ऐप्लिकेशन डाउनलोड को किसी कैंपेन में एट्रिब्यूट करने के लिए, आपको Google Play Store पर ले जाने वाले किसी भी लिंक में एक रेफ़रर पैरामीटर जोड़ना होगा. साथ ही, अपने Google Analytics ट्रैकर पर इंटेंट में शामिल कैंपेन की जानकारी पाने और सेट करने के लिए, अपने ऐप्लिकेशन में Play का इंस्टॉल रेफ़रर एपीआई जोड़ना होगा.

1. अपनी AndroidManifest.xml फ़ाइल से, Google Analytics के रिसीवर को हटाएं.

अगर आपने Google Tag Manager रिसीवर का भी इस्तेमाल किया है, तो उसे अपने मेनिफ़ेस्ट से भी हटाएं.

2. इंस्टॉल रेफ़रलकर्ता एपीआई लाइब्रेरी पर कोई डिपेंडेंसी जोड़ें.

डिपेंडेंसी जोड़ने के लिए, build.gradle में यह जानकारी शामिल करें:

dependencies {
    ...
    implementation 'com.android.installreferrer:installreferrer:1.1'
}

3. अपने ऐप्लिकेशन की लॉन्च गतिविधि में, Install Referrer API को कॉल करें.

इंस्टॉल किए गए ऐप्लिकेशन पैकेज का रेफ़रलकर्ता URL फिर से पाने के लिए इंस्टॉल रेफ़रलकर्ता API का इस्तेमाल करें. इसके बाद, Google Analytics या Google टैग मैनेजर के रिसीवर को यूआरएल मान भेजें. अपने ऐप्लिकेशन की लॉन्च गतिविधि में Install referrer API का इस्तेमाल करने के लिए, नीचे दिए गए कोड से मिलते-जुलते तरीके का पालन करें.

अगर आपके पास ऐप्लिकेशन में कई एंट्री पॉइंट हैं, जैसे कि अलग-अलग हिस्सों में डीप लिंक, तो आप ActivityLifecycleListener में दिए गए उन तरीकों को लागू कर सकते हैं जो ActivityLifecycleCallbacks से ट्रिगर होते हैं.

package com.example.myapplication;

import static com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse;

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.os.Handler;
import android.os.RemoteException;

import com.android.installreferrer.api.InstallReferrerClient;
import com.android.installreferrer.api.InstallReferrerStateListener;
import com.android.installreferrer.api.ReferrerDetails;
import com.google.android.gms.analytics.CampaignTrackingReceiver;
import com.google.tagmanager.InstallReferrerReceiver;

import java.util.concurrent.Executor;
import java.util.concurrent.Executors;

public class MainActivity extends AppCompatActivity {

    private final Executor backgroundExecutor = Executors.newSingleThreadExecutor();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        checkInstallReferrer();
    }

    // TODO: Change this to use whatever preferences are appropriate. The install referrer should
    // only be sent to the receiver once.
    private final String prefKey = "checkedInstallReferrer";

    void checkInstallReferrer() {
        if (getPreferences(MODE_PRIVATE).getBoolean(prefKey, false)) {
            return;
        }

        InstallReferrerClient referrerClient = InstallReferrerClient.newBuilder(this).build();
        backgroundExecutor.execute(() -> getInstallReferrerFromClient(referrerClient));
    }

    void getInstallReferrerFromClient(InstallReferrerClient referrerClient) {

        referrerClient.startConnection(new InstallReferrerStateListener() {
            @Override
            public void onInstallReferrerSetupFinished(int responseCode) {
                switch (responseCode) {
                    case InstallReferrerResponse.OK:
                        ReferrerDetails response = null;
                        try {
                            response = referrerClient.getInstallReferrer();
                        } catch (RemoteException e) {
                            e.printStackTrace();
                            return;
                        }
                        final String referrerUrl = response.getInstallReferrer();


                        // TODO: If you're using GTM, call trackInstallReferrerforGTM instead.
                        trackInstallReferrer(referrerUrl);


                        // Only check this once.
                        getPreferences(MODE_PRIVATE).edit().putBoolean(prefKey, true).commit();

                        // End the connection
                        referrerClient.endConnection();

                        break;
                    case InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                        // API not available on the current Play Store app.
                        break;
                    case InstallReferrerResponse.SERVICE_UNAVAILABLE:
                        // Connection couldn't be established.
                        break;
                }
            }

            @Override
            public void onInstallReferrerServiceDisconnected() {

            }
        });
    }

    // Tracker for Classic GA (call this if you are using Classic GA only)
    private void trackInstallReferrer(final String referrerUrl) {
        new Handler(getMainLooper()).post(new Runnable() {
            @Override
            public void run() {
                CampaignTrackingReceiver receiver = new CampaignTrackingReceiver();
                Intent intent = new Intent("com.android.vending.INSTALL_REFERRER");
                intent.putExtra("referrer", referrerUrl);
                receiver.onReceive(getApplicationContext(), intent);
            }
        });
    }

    // Tracker for GTM + Classic GA (call this if you are using GTM + Classic GA only)
    private void trackInstallReferrerforGTM(final String referrerUrl) {
        new Handler(getMainLooper()).post(new Runnable() {
            @Override
            public void run() {
                InstallReferrerReceiver receiver = new InstallReferrerReceiver();
                Intent intent = new Intent("com.android.vending.INSTALL_REFERRER");
                intent.putExtra("referrer", referrerUrl);
                receiver.onReceive(getApplicationContext(), intent);
            }
        });
    }

}

4. Google Play के यूआरएल में Google Analytics कैंपेन के पैरामीटर जोड़ना

इसके बाद, सीधे Google Play Store से लिंक होने वाले किसी भी यूआरएल में referrer पैरामीटर जोड़ें. साथ ही, उस पैरामीटर की वैल्यू को सोर्स की जानकारी देने वाले Google Analytics के कैंपेन पैरामीटर की स्ट्रिंग पर सेट करें, जैसा कि इस उदाहरण में दिखाया गया है:

https://play.google.com/store/apps/details?id=com.example.application
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3Dlogolink
%26utm_campaign%3Dspring_sale

कैंपेन पैरामीटर स्ट्रिंग बनाने का तरीका जानने के लिए, Google Play के यूआरएल बिल्डर का इस्तेमाल करें या कैंपेन पैरामीटर के रेफ़रंस सेक्शन को देखें.

सामान्य कैंपेन और ट्रैफ़िक सोर्स एट्रिब्यूशन

किसी ऐप्लिकेशन को इंस्टॉल करने के बाद, उसे विज्ञापन कैंपेन, वेबसाइटों या दूसरे ऐप्लिकेशन से मिले रेफ़रल के ज़रिए लॉन्च किया जा सकता है. इस स्थिति में, setCampaignParamsFromUrl तरीके का इस्तेमाल करके, सीधे ट्रैकर पर कैंपेन पैरामीटर सेट करके, ट्रैफ़िक सोर्स या मार्केटिंग कैंपेन को रेफ़र करने पर बाद के सेशन में उपयोगकर्ता की गतिविधि को रेफ़र किया जा सकता है.

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Set screen name.
t.setScreenName(screenName);

// In this example, campaign information is set using
// a url string with Google Analytics campaign parameters.
// Note: This is for illustrative purposes. In most cases campaign
//       information would come from an incoming Intent.
String campaignData = "http://examplepetstore.com/index.html?" +
    "utm_source=email&utm_medium=email_marketing&utm_campaign=summer" +
    "&utm_content=email_variation_1";

// Campaign data sent with this hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCampaignParamsFromUrl(campaignData)
    .build()
);

getTracker तरीके के बारे में ज़्यादा जानने के लिए, बेहतर कॉन्फ़िगरेशन देखें.

कैंपेन पैरामीटर

कैंपेन पैरामीटर का इस्तेमाल उन ट्रैफ़िक सोर्स और कैंपेन के बारे में जानकारी भेजने के लिए किया जाता है जो उपयोगकर्ताओं को आपके ऐप्लिकेशन पर ला रहे हैं.

नीचे दी गई टेबल में कैंपेन पैरामीटर मौजूद हैं, जिनका इस्तेमाल Google Play या कैंपेन की सामान्य परफ़ॉर्मेंस को जांचने में किया जा सकता है:

पैरामीटर ब्यौरा उदाहरण
utm_source कैंपेन का सोर्स; इसका इस्तेमाल किसी सर्च इंजन, न्यूज़लेटर या अन्य सोर्स की पहचान करने के लिए किया जाता है utm_source=google
utm_medium कैंपेन का मीडियम; इसका इस्तेमाल ईमेल या हर क्लिक की लागत (सीपीसी) जैसे मीडियम की पहचान करने के लिए किया जाता है utm_medium=cpc
utm_term कैंपेन शब्द; विज्ञापनों के लिए कीवर्ड उपलब्ध कराने के लिए पेड सर्च के साथ इस्तेमाल किया जाता है utm_term=running+shoes
utm_content कैंपेन का कॉन्टेंट; इसका इस्तेमाल A/B टेस्टिंग और कॉन्टेंट के हिसाब से दिखाए जाने वाले विज्ञापनों में किया जाता है. इससे एक ही यूआरएल पर ले जाने वाले विज्ञापनों और लिंक में अंतर किया जा सकता है utm_content=logolink
utm_content=textlink
utm_campaign कैंपेन का नाम; इसका इस्तेमाल कीवर्ड का विश्लेषण करने के लिए किया जाता है, ताकि किसी प्रॉडक्ट के प्रमोशन या रणनीतिक कैंपेन की पहचान की जा सके utm_campaign=spring_sale
gclid Google Ads ऑटो-टैगिंग पैरामीटर; इसका इस्तेमाल विज्ञापनों को मेज़र करने के लिए किया जाता है. यह वैल्यू, डाइनैमिक तौर पर जनरेट होती है और इसमें कभी भी बदलाव नहीं किया जाना चाहिए.

Google Play यूआरएल बिल्डर

Google Play कैंपेन की परफ़ॉर्मेंस का आकलन करने के लिए यूआरएल जनरेट करने के लिए, नीचे दिए गए टूल का इस्तेमाल करें.